线索表单的 Meta Conversions API(CAPI):在不重复计数的前提下回传线索
如何通过 Pixel 与 Conversions API 使用同一个事件 ID 向 Meta 回传线索,获取访问令牌,在测试事件中验证,并处理哈希联系方式的同意问题。
回答:Meta Conversions API(CAPI)从你的服务器而非访客浏览器发送事件。与 Pixel 同时使用时,两者须使用相同的事件名称与相同的事件 ID;Meta 会保留一条并丢弃重复项。Pixel 漏掉的线索(广告拦截、浏览器追踪限制、提前关闭标签页)仍会被服务器事件记录。
仅靠 Pixel 为何不够
Pixel 在访客的浏览器中运行。广告拦截、iOS 的追踪限制,以及提交后立即关闭标签页,都会导致事件丢失。Meta 因此少报转化,并在数据不足的情况下优化广告。服务器端的副本可以补上这一缺口。
需要准备什么
- 来自 Meta Events Manager → 数据源的 Pixel(数据集)ID。
- Conversions API 访问令牌:Events Manager → 你的数据集 → 设置 → Conversions API → 生成访问令牌。
- 测试事件代码(可选):在“测试事件”标签中显示,以
TEST开头。
去重如何工作
| 发送方 | 事件名称 | 事件 ID |
|---|---|---|
| 浏览器 Pixel | Lead |
fbq('track', 'Lead', {}, {eventID: 'abc123'}) |
| 服务器(CAPI) | Lead |
"event_id": "abc123" |
当相同的名称与 ID 同时到达时,Meta 只保留一条。如果 ID 不同,或名称不同(例如 Lead 与 SubmitApplication),该线索会被计为两次。在浏览器中于提交时生成一个 ID,并同时传给两端。
服务器事件应包含什么
event_name(Lead)、event_time、event_id、action_source: "website"、event_source_urluser_data- 原样发送:
client_ip_address、client_user_agent、fbc(点击 ID cookie)、fbp(浏览器 ID cookie) - 经 SHA-256 哈希:电话(
ph,带国家代码的数字,例如 821012345678)、邮箱(em,转为小写)、姓名
- 原样发送:
更多标识符可以提升事件匹配质量,但应先解决同意问题。
同意:哈希后的数据仍属个人信息
根据韩国《个人信息保护法》(以及大多数隐私法),对电话号码做哈希并不使其成为匿名信息,而 Meta 属于境外接收方。安全的做法:
- 为“为广告衡量的跨境传输”添加单独的可选同意:接收方(Meta Platforms)、国家、项目、目的、保存期限。
- 仅对已同意的用户包含哈希后的联系方式。
- 对其他用户,仅发送包含 IP、用户代理与点击 ID 的事件。
- 绝不发送症状等健康信息。
参见韩国线索表单的同意文本,或使用免费同意工具生成。
验证
- 添加测试事件代码并提交一条测试线索。
- 在“测试事件”中应看到一条浏览器事件与一条服务器事件,其中一条标记为已去重。
- 上线前移除测试代码。
回传后续结果
当线索转为咨询或成交时,用相同的哈希标识符(或外部 ID)发送自定义服务器事件。Meta 由此可以学习哪些人会走到填表之后。
在 CutLanding 中
在 设置 → 连接 中粘贴 Pixel ID 与访问令牌。线索保存后,Pixel 与服务器事件以相同 ID 发出;仅对已同意广告衡量的用户附加哈希后的联系方式;健康数据绝不发送;发送失败会在 24 小时内重试。
常见问题
可以移除 Pixel,只使用 Conversions API 吗?
Meta 建议两者并用并做去重。浏览器数据(fbp 与 fbc cookie)有助于匹配,且当一方失败时,另一方仍能记录线索。
我的线索被计了两次,为什么?
Pixel 与服务器端的事件名称或事件 ID 不一致。每次提交在两端使用同一个 ID,并保持事件名称相同。
访问令牌泄露了怎么办?
在 Events Manager 中生成新令牌,并在所有使用处替换。令牌只应保存在服务器上,绝不能写进页面 HTML。