点击 WhatsApp 广告归因
如果您投放 Meta (Facebook/Instagram) “点击跳转至 WhatsApp”广告，Your AI Connector 可以告诉您每位 WhatsApp 线索来自哪个广告，并为您提供将真实转化回传给 Meta 所需的 Meta 点击标识符。这使您的广告系列能够针对实际销售和预订进行优化，而不仅仅是针对“发起聊天的人”。
捕获的内容
当有人点击“点击跳转至 WhatsApp”广告并向您的企业发送消息时，Meta 会在该首条消息中附加隐藏的引荐信息。Your AI Connector 会自动读取该信息并将其存储在联系人资料中。无需设置，无需配置，一切自动完成。
捕获的信息作为 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 |
在联系人资料中首次记录该引荐的时间。 |
如果您已为其配置了自定义字段，则可以在联系人的快速查看面板中看到此信息，或者通过 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
Your AI Connector 会捕获并展示归因数据，但目前不会为您原生将转化推送至 Meta 或 Google。您需要使用 Webhook 和自动化工具来转发这些数据。
ad_referral 对象包含在出站 Webhook 事件的 contact 部分中（例如：新消息、联系人恢复、联系人标签更新，以及诸如“预约已预订”之类的分析事件）。
一个典型的闭环设置：
- 线索点击您的“点击跳转至 WhatsApp”广告并向您发送消息。Your AI Connector 会在联系人资料中记录
ad_referral（包括ctwa_clid）。 - 随着线索的推进——预订了通话、成为客户、流失——您需要标记该结果（请参阅下方的“传递漏斗阶段”）。
- Webhook 会触发您的自动化工具（Zapier、Make 或 Pabbly），携带该结果以及联系人的
ctwa_clid。 - 您的自动化工具调用 Meta 的转化 API（使用
action_source = business_messaging和ctwa_clid）或 Google Ads（线下转化导入 / 潜在客户增强型转化）来上报转化。
通过这种方式，Meta 和 Google 可以了解哪些广告产生了实际效果，并针对这些效果进行优化。
传递漏斗阶段
要报告转化，您通常需要两样东西：点击 ID（自动捕获）和结果（由您设置）。附加结果最可靠的方法是使用标签，因为应用标签会触发 contact_tags_updated webhook，并且该有效负载包含联系人的 ad_referral。（移除标签不会触发它；请参阅 联系人标签已更新。）
您可以自动应用标签：
- 让您的 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 转发数据。如果您需要原生集成，请通过 hi@youraiconnector.com 联系支持团队。
- 归因数据从上线那一刻起开始捕获。无法回溯到在此之前发生的对话。