# 点击 WhatsApp 广告归因

如果您投放 Meta (Facebook/Instagram) “点击跳转至 WhatsApp”广告，<span data-t="appName">Your AI Connector</span> 可以告诉您每位 WhatsApp 线索来自哪个广告，并为您提供将真实转化回传给 Meta 所需的 Meta 点击标识符。这使您的广告系列能够针对实际销售和预订进行优化，而不仅仅是针对“发起聊天的人”。

---

## 捕获的内容

当有人点击“点击跳转至 WhatsApp”广告并向您的企业发送消息时，Meta 会在该首条消息中附加隐藏的引荐信息。<span data-t="appName">Your AI Connector</span> 会自动读取该信息并将其存储在联系人资料中。无需设置，无需配置，一切自动完成。

捕获的信息作为 `ad_referral` 存储在联系人资料中，包含：

| 字段 | 说明 |
|---|---|
| `ctwa_clid` | Meta 点击标识符。这是您发送给 Meta 转化 API 以将下游转化归因回确切广告点击的值。对于自然帖子引荐（见下文），此项为空。 |
| `source_id` | 用户点击的广告（或帖子）的 ID。 |
| `source_type` | 可能是 `ad`（付费“点击 WhatsApp”广告）或 `post`（自然 Facebook/Instagram 帖子）。 |
| `source_url` | 与广告内容关联的链接。 |
| `headline` | 广告的标题文本。 |
| `body` | 广告的正文文本。 |
| `channel` | 引荐来源渠道（目前始终为 `whatsapp`）。 |
| `captured_at` | 在联系人资料中首次记录该引荐的时间。 |

如果您已为其配置了自定义字段，则可以在联系人的[快速查看面板](../get-started/creating-contacts.md)中看到此信息，或者通过 Webhook 和 API 直接读取（见下文）——它不会在“联系人”表格中作为单独的标签字段显示。

> **有一点载荷（payload）没有告诉你：** 对话是通过你的哪个号码进来的。其中没有页面 ID 或 WhatsApp Business Account ID。如果只有一个号码，这无关紧要；如果你在不同的 Facebook 页面上运行多个号码，则需要在你这边进行映射。

---

## 适用的连接方式

> 此功能**仅适用于官方 WhatsApp API 连接**。Meta 仅通过官方 WhatsApp Business API 提供结构化的引荐信息（包括 `ctwa_clid`）。**非官方 WhatsApp（网页版）连接无法接收此信息**——根据其工作原理设计，该连接无法获取广告点击数据。

因此，如果您重视闭环广告归因，请通过连接到官方 WhatsApp API 的号码来运行您的“点击 WhatsApp”广告系列。

---

## 首次触达行为

引荐信息是在联系人从广告发送的**第一条**消息时捕获的。如果同一联系人后来点击了不同的广告，且该新点击带有点击标识符，则存储的 `ad_referral` 会被刷新，以便点击 ID 保持最新以用于报告。自然帖子引荐（没有 `ctwa_clid`）永远不会覆盖之前捕获的付费广告点击 ID。

---

## 将数据导入 Meta 或 Google Ads

<span data-t="appName">Your AI Connector</span> 会捕获并展示归因数据，但目前**不会**为您原生将转化推送至 Meta 或 Google。您需要使用 Webhook 和自动化工具来转发这些数据。

`ad_referral` 对象包含在出站 [Webhook](webhooks.md) 事件的 `contact` 部分中（例如：新消息、联系人恢复、联系人标签更新，以及诸如“预约已预订”之类的分析事件）。

一个典型的闭环设置：

1. 线索点击您的“点击跳转至 WhatsApp”广告并向您发送消息。<span data-t="appName">Your AI Connector</span> 会在联系人资料中记录 `ad_referral`（包括 `ctwa_clid`）。
2. 随着线索的推进——预订了通话、成为客户、流失——您需要标记该结果（请参阅下方的“传递漏斗阶段”）。
3. Webhook 会触发您的自动化工具（Zapier、Make 或 Pabbly），携带该结果以及联系人的 `ctwa_clid`。
4. 您的自动化工具调用 Meta 的转化 API（使用 `action_source = business_messaging` 和 `ctwa_clid`）或 Google Ads（线下转化导入 / 潜在客户增强型转化）来上报转化。

通过这种方式，Meta 和 Google 可以了解哪些广告产生了实际效果，并针对这些效果进行优化。

---

## 传递漏斗阶段

要报告转化，您通常需要两样东西：点击 ID（自动捕获）和结果（由您设置）。附加结果最可靠的方法是使用**标签**，因为应用标签会触发 `contact_tags_updated` webhook，并且该有效负载包含联系人的 `ad_referral`。（移除标签不会触发它；请参阅 [联系人标签已更新](webhooks.md#contact-tags-updated-webhook)。）

您可以自动应用标签：

- 让您的 AI 代理在对话过程中标记联系人——在代理的配置中设置自动标记规则。如果您想自己标记来源，这就是“每个广告一个落地页 → 一条入口消息 → 一个标签”模式的工作方式。
- 或者在“聊天”或“联系人”页面手动添加标签。

每当相关标签发生变化时，Webhook 就会触发并附带点击 ID，准备好作为转化进行转发。

Webhook URL 是在标签本身上设置的，位于联系人所属的代理（或活动）的 **标签** 选项卡中，而不是在“设置”中。每个标签都有自己的 URL，如果你希望在一个地方接收所有内容，它们都可以指向同一个端点。

### 读取你已经错过的点击 ID

`ad_referral` 也会由 API 在 `GET /v1/contacts/{id}`（作为 `adReferral`）和联系人列表端点（作为 `ad_referral`）上返回，因此如果你的接收器宕机了，或者你正在事后进行核对，你可以读回点击 ID，而不必等待下一个 Webhook。在点击 ID 记录到联系人之前到达的联系人在此处显示为 `null` —— 该值只能从传入的消息本身捕获，因此无法追溯填充。

---

## 限制

- 仅限官方 WhatsApp API 连接（非官方网页连接）。
- 暂不支持原生的“一键式” Meta CAPI 或 Google Ads 集成 —— 您需要通过 Zapier/Make/Pabbly 转发数据。如果您需要原生集成，请通过 <span data-t="supportEmail">hi@youraiconnector.com</span> 联系支持团队。
- 归因数据从上线那一刻起开始捕获。无法回溯到在此之前发生的对话。


---

## 后续步骤

- [Webhooks](webhooks.md) — 查看完整负载以及哪些事件包含 `ad_referral`。
- [使用标签标记联系人](../get-started/creating-tags.md) — 设置承载您漏斗阶段的标签。