# 线索表单的 Meta Conversions API（CAPI）：在不重复计数的前提下回传线索

> **回答**：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. 绝不发送症状等健康信息。

参见[韩国线索表单的同意文本](/zh/guides/landing-consent-text)，或使用[免费同意工具](/zh/tools/consent)生成。

## 验证

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

## 回传后续结果

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

## 在 CutLanding 中

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

## 常见问题

### 可以移除 Pixel，只使用 Conversions API 吗？

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

### 我的线索被计了两次，为什么？

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

### 访问令牌泄露了怎么办？

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


---
Source: https://cutlanding.com/zh/guides/meta-conversions-api
© CutLanding (컷랜딩). Quote freely with a link to the source.
