点击 WhatsApp 广告归因
如果您投放 Meta (Facebook/Instagram) “点击跳转至 WhatsApp”广告，Your AI Connector 可以告诉您每位 WhatsApp 线索来自哪个广告，并为您提供将真实转化回传给 Meta 所需的 Meta 点击标识符。这使您的广告系列能够针对实际销售和预订进行优化，而不仅仅是针对“发起聊天的人”。
如果要投放广告到您自己网站上带有 WhatsApp 按钮的页面？请参阅 WhatsApp 广告点击归因。
捕获的内容
当有人点击“点击跳转至 WhatsApp”广告并向您的企业发送消息时，Meta 会在该首条消息中附加隐藏的引荐信息。Your AI Connector 会自动读取该信息并将其存储在联系人资料中。无需设置，无需配置，一切自动完成。
捕获的信息作为 ad_referral 存储在联系人资料中，包含：
| 字段 | 说明 |
|---|---|
ctwa_clid |
Meta 点击标识符。这是您发送给 Meta Conversions API 以将下游转化归因于确切广告点击的值。对于自然帖子引荐，此项为空（见下文）。 |
source_id |
用户点击的广告（或帖子）的 ID。 |
source_type |
ad（付费的“点击跳转至 WhatsApp”广告）或 post（Facebook/Instagram 自然帖子）。 |
source_url |
与广告内容关联的链接。 |
headline |
广告的标题文本。 |
body |
广告的正文文本。 |
channel |
引荐来源渠道：whatsapp、instagram 或 messenger。 |
captured_at |
首次在联系人上记录该引荐的时间。 |
无需任何设置即可查看：联系人页面会在其姓名下方显示 来自广告 标签（将鼠标悬停在上方可查看广告详情），聊天旁边的联系人面板也会显示该信息，并且联系人的“活动”记录将以广告点击作为开始。您还可以通过 Webhook 和 API 读取此信息（见下文）。它不是“联系人”表格中的一列。
有一点载荷（payload）没有告诉你： 对话是通过你的哪个号码进来的。其中没有页面 ID 或 WhatsApp Business Account ID。如果只有一个号码，这无关紧要；如果你在不同的 Facebook 页面上运行多个号码，则需要在你这边进行映射。
没有电话号码的潜在客户
部分通过广告向您发送消息的用户，其电话号码被 WhatsApp 隐藏了。在这种情况下，Meta 会提供一个私有的 ID 来代替号码，因此创建的联系人其 电话字段为空。这是正常现象。回复、AI 回答和自动跟进消息仍然可以送达给该用户，因为 Your AI Connector 会通过该 ID 与他们联系。
请将此类联系人的电话字段留空。不要在其中输入您自己的企业号码：消息无法从一个号码发送给自己，因此下一次自动跟进将会失败，且该联系人会被暂停。现在 Your AI Connector 会拒绝将您已连接的号码保存为联系人的电话。如果该用户稍后分享了他们的号码，或者再次发送消息时号码可见，系统会自动填充该字段。
适用的连接方式
此功能仅适用于官方 WhatsApp API 连接。Meta 仅通过官方 WhatsApp Business API 提供结构化的引荐信息（包括
ctwa_clid）。非官方 WhatsApp（网页版）连接无法接收此信息——根据其工作原理设计，该连接无法获取广告点击数据。
因此，如果您重视闭环广告归因，请通过连接到官方 WhatsApp API 的号码来运行您的“点击 WhatsApp”广告系列。
“点击跳转至 Instagram”和“点击跳转至 Messenger”广告
打开 Instagram 私信或 Messenger 对话的广告会以相同的方式记录，记录在您通过 Instagram & Messenger 卡片连接的 Facebook 公共主页和 Instagram 账号上。当有人通过这些广告发起对话时，联系人会获得一个 ad_referral，其中 channel 设置为 instagram 或 messenger，source_type 设置为 ad，source_id 设置为广告 ID。这使您可以追踪每个联系人背后的广告，从而计算出每个广告的预订成本。
与 WhatsApp 的几点区别：
- 没有
ctwa_clid；该字段为空。Meta 仅针对 WhatsApp 提供该点击标识符。 headline是 Meta 发送时的广告标题，source_url是广告的图片或视频链接（如果有）。body为空。- 如果联系人最初来自一个广告，后来又通过另一个不同的广告发起聊天，
ad_referral将显示较新的那个广告。 - Messenger 广告联系人会携带 2026 年 10 月 14 日及之后的广告信息。在此日期之前通过 Messenger 广告添加的联系人没有
ad_referral，因为当时未记录广告详情，且无法事后补录。 - 通过点击主页的“开始使用” (Get Started) 按钮发起的 Messenger 聊天不会被记录。请从您的主页（Meta Business Suite，收件箱设置）中移除“开始使用”按钮，以便用户通过输入文字发起聊天，这样广告信息就会在他们的第一条消息中被记录下来。
首次触达行为
引荐信息是在联系人从广告发送的第一条消息时捕获的。如果同一联系人后来点击了不同的广告，且该新点击带有点击标识符，则存储的 ad_referral 会被刷新，以便点击 ID 保持最新以用于报告。自然帖子引荐（没有 ctwa_clid）永远不会覆盖之前捕获的付费广告点击 ID。
将数据导入 Meta 或 Google Ads
Your AI Connector 会捕获并公开归因数据。对于先将用户引导至您自己网站的广告，当应用标签时，Your AI Connector 可以为您将结果发送给 Meta：请参阅 将结果发送给 Meta。对于“点击跳转至 WhatsApp”广告，您可以使用 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 是在标签本身上设置的，位于分配给联系人的 AI 智能体编辑器的 Tags 选项卡中，而不是在“设置”中。每个标签都有其自己的 URL，如果您希望在一个地方接收所有内容，它们都可以指向同一个端点。
读取你已经错过的点击 ID
ad_referral 也会由 API 在 GET /v1/contacts/{id}（作为 adReferral）和联系人列表端点（作为 ad_referral）上返回，因此如果你的接收器宕机了，或者你正在事后进行核对，你可以读回点击 ID，而不必等待下一个 Webhook。在点击 ID 记录到联系人之前到达的联系人在此处显示为 null —— 该值只能从传入的消息本身捕获，因此无法追溯填充。
限制
- 仅限官方 WhatsApp API 连接（非官方网页连接）。
- 内置的 将结果发送给 Meta 功能会发送由网站脚本记录的点击数据；它不会发送“点击跳转至 WhatsApp”广告的
ctwa_clid。对于此类广告以及 Google Ads，您需要通过 Zapier/Make/Pabbly 转发数据。如果您需要原生集成，请通过 hi@youraiconnector.com 联系支持团队。 - 归因数据从功能上线那一刻起开始捕获。无法回溯到之前发生的对话。
后续步骤
- Webhooks — 查看完整负载以及哪些事件包含
ad_referral。 - 使用标签标记联系人 — 设置承载您漏斗阶段的标签。
- WhatsApp 广告点击归因：将引导至您自己网站的广告点击与 WhatsApp 对话进行匹配。