入門

概述

WooCommerce源結合 WooCommerce 的 REST API 及 WebHook，實現可靠的訂單同步。

必須參數

源配置&GTM埋點

一、进入TTO CDP后台，安装WP for WooCommerce源

安装成功后，会自动生成一条源的webhook地址「POST HTTP Endpoin」，下一步要设置到worpress的后台！

二、进入worpress后台，创建APIKey和配置webhook

1. 后台菜单woocommerce > 进阶 > rest api > 新增apikey

2. 把Consumer key 和 Consumer Secret配置到CDP的源设置

3. 后台菜单woocommerce > 进阶 > webhook > 新增webhook

4. 把源的webhook地址，配置到推送端点和选择订单更新事件

三、进入GTM后台，导入CDP埋点模版

1. gtm后台的Admin > import container > 导入模版

2. 修改TTO CDP代碼 > 替換爲客戶自己的cdp js code

3. 修改TTO CDP代碼的觸發器 > PageView-init的hostname

4. 修改Purchase代碼的推送源位置

四、Code snippets 配置

1. WooCommerce 後臺選擇 Code Snippets -> Add Snippet

2. 選擇添加自定義代碼，PHP Snippet

3. 添加以下PHP代碼，保存並啓用

4. 代碼會自動保存日志，可在狀態中查看日志

add_action( 'woocommerce_checkout_update_order_meta', 'save_ttoaid_from_cookie_to_order_meta', 10, 2 );

function save_ttoaid_from_cookie_to_order_meta( $order_id, $data ) {
    $order = wc_get_order( $order_id );
    if ( $order ) {
        sync_ttoaid_logic( $order );
    }
}
add_action( 'woocommerce_store_api_checkout_update_order_from_request', 'save_ttoaid_from_cookie_to_store_api', 10, 2 );
function save_ttoaid_from_cookie_to_store_api( $order, $request ) {
    sync_ttoaid_logic( $order );
}
/**
 * 核心公用逻辑
 */
function sync_ttoaid_logic( $order ) {
    $logger = wc_get_logger();
    $log_source = array( 'source' => 'cookie-monitor' );
    $order_id = $order->get_id();
    if ( ! empty( $_COOKIE['_ttoaid'] ) ) {
        $ttoaid = $_COOKIE['_ttoaid'];
        $order->update_meta_data( 'cdp_id', $ttoaid );
        $order->save_meta_data();
        $logger->debug( "订单 #{$order_id} 已成功保存 cdp_id: " . $ttoaid, $log_source );
    } else {
        $logger->debug( "订单 #{$order_id} 结账时未发现 _ttoaid Cookie", $log_source );
    }
}