这是跨境电商站的功能(后台「跨境 → 跨境电商 → 广告回传」)。没开跨境电商的站没有这一项。
它解决什么
浏览器像素会被广告屏蔽插件、手机浏览器限制挡掉一部分,广告平台就少算成交、出价越投越偏。开了服务端回传,客人看商品 / 加购 / 开始结账 / 付款这几件事,系统会从服务器再告诉平台一遍:
- 和浏览器像素用同一个事件编号,平台自动去重,不会算两遍;付款那一条编号是 pur_<支付单号>,Stripe 重发通知也只算一次
- 客人的邮箱、电话按各平台规定先做 SHA-256 哈希再发,明文不出站
- Google(GA4)只在服务端发「购买」,其余由浏览器的 gtag 发(GA4 没有去重,两边都发会记两遍)
尊重客人的选择
站点开着 Cookie 同意横幅(默认开)时,只回传点了「全部同意」的客人;没点、或只选了必要的,一条都不发(付款那条也不发,记录里会写「没同意」)。站主关了横幅就和浏览器像素一样照常回传,合规由站主负责。
怎么开(对你的 AI 说一句)
- 像素编号:「把 Meta 像素 123456789012345、GA4 G-XXXX、TikTok 像素 C4XXXX 填上」—— update_site_config(metaPixelId / gaMeasurementId / tiktokPixelId)
- 「把 Meta 和 TikTok 的服务端回传打开,先用测试模式」—— set_ecom_ads_settings(metaEnabled / tiktokEnabled / googleEnabled,*Mode = test / live)
- 「发一条测试购买,看看记录」—— send_ecom_ads_test_event,再 list_ecom_ad_events(status = test_sink 表示测试模式记在本地、没出站)
- 想在平台后台的「测试事件」里看到:把平台给的测试码告诉 AI(metaTestEventCode / tiktokTestEventCode),再由您本人在后台「跨境 → 跨境电商 → 广告回传 → 填访问令牌」填上令牌(Meta 转化 API 令牌 / TikTok Events API 令牌 / GA4 Measurement Protocol API 密钥),每次保存要输二次验证码。AI 看不到也填不了令牌
- 测试跑通后切正式:「Meta 回传切到正式」—— metaMode = live。正式模式没令牌会记 failed:no_credential
设置全貌随时用 get_ecom_ads_settings 看。
商品目录 feed
「打开商品目录 feed」—— set_ecom_ads_settings feedEnabled=true,然后 get_ecom_product_feeds 拿三个地址:
- meta.csv → Meta Commerce Manager 的「数据源 → 定时拉取」(Instagram 商店也用它)
- google.xml → Google Merchant Center 的「定时抓取」
- tiktok.csv → TikTok 商品目录的数据源
只出在售的一次性商品,有规格的每个规格一行;没有图、没有价格、没有商品网址的会列在 problems 里。地址被别人拿去抓了:rotate_ecom_feed_token 换一个(旧地址立刻失效,平台那边要改成新的)。