WhatsApp 广告转化 API(CAPI)– 跟踪 CTWA 事件 | WOZTELL

适用于 WhatsApp 的转化 API(CTWA)

介绍

点击 WhatsApp 广告 (CTWA) 是一种常见方式,用户可以通过广告直接进入 WhatsApp 对话。借助 广告触发器 和 应用事件的支持,你可以在聊天机器人构建器中创建完整的转化流程。



设置 CTWA

首先,你需要设置一个 点击 WhatsApp 广告 (CTWA),以便客户可以从广告跳转到你的企业号码。

要在 广告管理工具中设置 CTWA,请参考 Meta 提供的这份 指南。



授权广告权限

  1. 若要启用 WOZTELL 上与 点击 WhatsApp 广告 和 转化事件 相关的功能,请在 WhatsApp Cloud 渠道的平台页面中启用 广告权限。

注意

请确保执行 Business 登录流程的 Facebook 用户拥有相关广告账户的 "完全控制权限"。



  1. 在 Business 登录流程的第一步中,选择要与 WOZTELL 连接的企业账户。
  1. 选择要关联的页面。
  1. 选择要连接的广告账户。

Idea
注意:

此数据集对于通过 Conversions API 注册转化事件至关重要。WOZTELL 会使用你的 WhatsApp 商业账户 ID(`waba_id`)自动创建数据集,并将其链接到你关联的页面。此数据集将作为 Meta 接收事件数据以进行效果衡量的目标位置。
  1. 对于 Conversions API,Meta 会在 事件管理工具 中创建一个数据集,其名称与所关联的页面相同。

  1. 允许 WOZTELL 拥有以下权限。
  1. 现在 WOZTELL 已成功连接到你的企业账户。
  1. 点击 "返回 WOZTELL" 以关闭弹窗。


功能介绍

启用广告权限后,你将可以使用与 CTWA 和 Conversions API 相关的功能。

CTWA 预览

通过 广告权限,点击 WhatsApp 广告 (CTWA) 可以在对话历史中显示,以便与其他类型的进入方式进行区分。

点击 WhatsApp 广告 (CTWA) 也可以显示在收件箱的会话线程中。



广告触发器

Meta 广告触发器 允许你为通过 CTWA 进入对话的用户创建专属的聊天机器人流程。它可以识别是通过“特定广告”还是“任意广告”进入的用户。此外,你还可以为触发器添加关键词组。

Idea
注意

如果你在设置广告触发器时没有添加任何关键词组,那么只要用户是通过广告进入的,任何输入都将触发该流程。


创建触发器

  1. 首先,创建一个全局节点。
  1. 创建一个新的触发器并选择 Meta 广告触发器。
  1. 你可以为触发器添加关键词。
  1. 此外,你可以决定是否由 所有广告 或 特定广告 及其对应的 广告 ID触发聊天机器人。

创建响应

  1. 为了添加响应,请创建一个通用节点。
  1. 创建一个新的响应。
  1. 添加响应消息并保存该节点。
  1. 最后,请确保你已从全局节点跳转到包含响应的通用节点。


发送转化事件

对于通过 CTWA 进入会话的客户,Meta 支持转化事件,以帮助跟踪可能的转化。你可以利用该操作在聊天机器人流程的某个节点标记 已完成的购买 或 已提交的潜在客户 。

这些事件将发送至 Meta,并与特定的 CTWA 广告相关联。


Idea
注意:

为了确保将转化正确归因于原始广告点击,事件数据中必须包含字段 "ctwa_clid"(Click-to-WhatsApp 点击 ID)。该标识符由 WOZTELL 在用户通过 CTWA 启动会话时从 webhook 中的 `referral` 对象中自动捕获。
你必须保存此 ID,并在会话中发生转化(例如提交潜在客户或完成购买)时发送它。




  1. 如果你已经建立了一个用户通过 CTWA 进入的聊天机器人流程,可以创建一个新节点来发送事件。
  1. 创建一个新的操作。
  1. 选择 "发送转化事件",然后选择相应的 "WABA ID"、"广告账户 ID" 和 "广告 ID"。


{
data: [
{
event_name: "Purchase",
event_time: 1675999999,
action_source: "business_messaging",
messaging_channel: "whatsapp",
user_data: {
whatsapp_business_account_id: "<WABA_ID>",
ctwa_clid: "<CLICK_ID>"
},
custom_data: {
currency: "USD",
value: 123
}
}
],
partner_agent: "WOZTELL"
}
  1. 在 "事件类型" 中,如果选择了 "购买",请指定 "货币" 和 "金额"。
  1. 如果你选择 "潜在客户" 事件,则无需填写其他字段。
  1. 如有需要,你也可以在 "可选输入" 中添加额外信息。详情请参考 此处。
  1. 一旦包含 "发送转化事件" 操作的节点被执行,事件将发送至 Meta 以标记已完成的转化。

Warning
重要:

Meta 不会自动去重事件。如果可能会多次发送相同的转化(例如由于重试或多个流程),请确保你的系统在调用 Conversions API 之前处理事件去重。

要快速确认事件是否发送成功,请前往你的 Facebook Business Manager 中的事件管理器,查看相应的数据集。

现在,你可以创建并发送 购买事件 或 潜在客户事件 来标记已完成的转化。该事件将显示在 Facebook Business Manager 的 事件管理器 中。
事件发送后,你可以在 Meta 的事件管理器中选择与你的企业账户关联的数据集来验证。这样可以确认 Meta 已正确接收并处理该事件。

Idea
注意事项:

事件数据将显示在 数据集 中,该数据集是在 广告权限 步骤 5 中配置的。

如果你是代表客户操作的合作伙伴,请确保客户知道如何在事件管理器中找到他们的数据集以进行验证。