Meta CAPI 与像素重复计入怎么对齐 event_id
现象#
接入 CAPI 后 Events Manager 的 Purchase 是实际订单的 1.7 倍,事件详情里部分记录标记为未去重。
原因#
- 浏览器 fbq 第四参数的 eventID 与服务端 JSON 的 event_id 不是同一个值
- 像素与服务端事件名不一致,比如一端用了自定义名,Meta 就不会配对
- 去重窗口是 48 小时,超出窗口的历史补发会被单独计入
- 服务端缺少 event_source_url 或 client_user_agent,Meta 无法与浏览器事件配对
处理步骤#
- 两端统一用订单号生成 event_id,例如
purchase:{order_id},不要随机 UUID - 像素侧把 ID 放进 fbq 的
{eventID:id}第四参数 - 服务端补
action_source与event_source_url - 在
Test Events看同一订单是否显示 Deduplicated - 补发队列以订单号为幂等键,超过 48 小时的历史单不再补
验收标准#
Events Manager 中测试订单的浏览器与服务端两条事件合并为一条,Purchase 总数与后台订单差异小于 5%。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。