线索表单的 Meta Conversions API(CAPI):在不重复计数的前提下回传线索

指南 · 转化跟踪

如何通过 Pixel 与 Conversions API 使用同一个事件 ID 向 Meta 回传线索,获取访问令牌,在测试事件中验证,并处理哈希联系方式的同意问题。

回答:Meta Conversions API(CAPI)从你的服务器而非访客浏览器发送事件。与 Pixel 同时使用时,两者须使用相同的事件名称与相同的事件 ID;Meta 会保留一条并丢弃重复项。Pixel 漏掉的线索(广告拦截、浏览器追踪限制、提前关闭标签页)仍会被服务器事件记录。

仅靠 Pixel 为何不够

Pixel 在访客的浏览器中运行。广告拦截、iOS 的追踪限制,以及提交后立即关闭标签页,都会导致事件丢失。Meta 因此少报转化,并在数据不足的情况下优化广告。服务器端的副本可以补上这一缺口。

需要准备什么

  1. 来自 Meta Events Manager → 数据源的 Pixel(数据集)ID。
  2. Conversions API 访问令牌:Events Manager → 你的数据集 → 设置 → Conversions API → 生成访问令牌。
  3. 测试事件代码(可选):在“测试事件”标签中显示,以 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_url
  • user_data
    • 原样发送:client_ip_address、client_user_agent、fbc(点击 ID cookie)、fbp(浏览器 ID cookie)
    • 经 SHA-256 哈希:电话(ph,带国家代码的数字,例如 821012345678)、邮箱(em,转为小写)、姓名

更多标识符可以提升事件匹配质量,但应先解决同意问题。

同意:哈希后的数据仍属个人信息

根据韩国《个人信息保护法》(以及大多数隐私法),对电话号码做哈希并不使其成为匿名信息,而 Meta 属于境外接收方。安全的做法:

  1. 为“为广告衡量的跨境传输”添加单独的可选同意:接收方(Meta Platforms)、国家、项目、目的、保存期限。
  2. 仅对已同意的用户包含哈希后的联系方式。
  3. 对其他用户,仅发送包含 IP、用户代理与点击 ID 的事件。
  4. 绝不发送症状等健康信息。

参见韩国线索表单的同意文本,或使用免费同意工具生成。

验证

  1. 添加测试事件代码并提交一条测试线索。
  2. 在“测试事件”中应看到一条浏览器事件与一条服务器事件,其中一条标记为已去重。
  3. 上线前移除测试代码。

回传后续结果

当线索转为咨询或成交时,用相同的哈希标识符(或外部 ID)发送自定义服务器事件。Meta 由此可以学习哪些人会走到填表之后。

在 CutLanding 中

在 设置 → 连接 中粘贴 Pixel ID 与访问令牌。线索保存后,Pixel 与服务器事件以相同 ID 发出;仅对已同意广告衡量的用户附加哈希后的联系方式;健康数据绝不发送;发送失败会在 24 小时内重试。

常见问题

可以移除 Pixel,只使用 Conversions API 吗?

Meta 建议两者并用并做去重。浏览器数据(fbp 与 fbc cookie)有助于匹配,且当一方失败时,另一方仍能记录线索。

我的线索被计了两次,为什么?

Pixel 与服务器端的事件名称或事件 ID 不一致。每次提交在两端使用同一个 ID,并保持事件名称相同。

访问令牌泄露了怎么办?

在 Events Manager 中生成新令牌,并在所有使用处替换。令牌只应保存在服务器上,绝不能写进页面 HTML。

相关指南