
本文介绍如何通过 Adobe 设置安全数据连接。Adobe 支持 TikTok 事件 API。
TikTok Web Events API 扩展概述
TikTok 的事件 API 是一个安全的服务器到服务器界面,允许广告商直接与 TikTok 分享客户在其网站上采取的作。使用TikTok Web Events API扩展,您可以利用事件转发规则将数据从Adobe Experience Platform Edge Network中继到TikTok。
有关这些连接工具的更多信息,请查看关于 TikTok 事件 API。
先决条件
Tiktok Web Events API 扩展配置为使用 TikTok Events API。要生成 TikTok 像素代码和访问令牌:
- 创建 TikTok for Business 账户(点击此处了解有关 TikTok for Business 账户的更多信息)
- 使用合作伙伴设置创建 TikTok Pixel 像素代码

3. 从设置页面从创建的像素生成访问令牌
有关获取 Pixel 代码和访问令牌的其他文档,请参阅 TikTok API for Business
安装 TikTok Web 事件 API 扩展程序
导航到数据收集 UI 或 Experience Platform UI,然后从左侧导航中选择 事件转发 以安装 TikTok Web 事件 API 扩展。从这里,选择要向其添加扩展的属性,或创建新属性。
在左侧导航栏中选择“扩展”,然后选择“目录”选项卡。搜索 TikTok Web Events API 卡片,然后选择“安装”。
在配置视图中,您必须提供来自 TikTok 广告管理平台的像素代码和访问令牌。请参阅此处,了解获取 Pixel 代码和 Access Token 的其他文档。
配置事件转发规则
创建新的事件转发规则并配置其条件。选择作时,选择 TikTok Web 事件 API 扩展,然后选择。选择 发送 TikTok Web 事件 API 事件 作为作类型。
请参阅 TikTok Marketing API 文档,了解有关支持的事件和参数的更多信息。
TikTok 支持的事件和推荐属性
| 事件 | 事件管理器中的事件类型 | 描述 | 属性对象中的推荐字段 |
|---|---|---|---|
| 查看内容 | 查看内容 | 查看页面时 | content_type、数量、描述、content_id、货币、价值 |
| 单击按钮 | 单击按钮 | 单击按钮时 | |
| 搜索 | 搜索 | 进行搜索时 | |
| 添加到愿望清单 | 添加到心愿单 | 将商品添加到愿望清单时 | |
| 添加到购物车 | 加入购物车 | 将商品添加到购物车时 | content_type、数量、描述、content_id、货币、价值 |
| 发起结账 | 启动结账 | 结账流程开始时 | |
| 添加付款信息 | 添加付款信息 | 在结账流程中添加付款信息时 | |
| 完成付款 | 完成付款 | 付款完成后 | content_type、数量、描述、content_id、货币、价值 |
| 地点订购 | 下订单 | 下订单时 | content_type、数量、描述、content_id、货币、价值 |
| 联系 | 联系 | 发生联系或咨询时 | |
| 下载 | 下载 | 单击打开外部浏览器下载页面的按钮时 | |
| 提交表格 | 提交表格 | 提交表单时 | |
| 完成注册 | 完成注册 | 注册完成后 | |
| 订阅 | 订阅 | 订阅时 |
配置事件重复数据删除(可选)
同时向 TikTok 发送客户端和服务器端事件的广告主需要进行重复数据删除。借助 Adobe TikTok Web Events API 扩展,一直在单独使用 TikTok Pixel 的广告商在启用该扩展以通过 Adobe 将服务器端事件发送到 TikTok 时,将需要为 Web 事件配置重复数据删除。
示例:如果 CompletePayment 事件是从 TikTok Pixel 和 Adobe TikTok Web Events API 扩展发送的,则需要删除重复数据,除非两个渠道发送不重叠的事件。
示例:如果 ViewContent 事件是从 TikTok Pixel 发送的,而 CompletePayment 事件是从 Adobe 扩展发送的,则不需要重复数据删除。
请注意:事件重复数据删除将依赖于 TikTok Pixel 和 Adobe TikTok Web Events API 扩展中的以下值:
- 像素代码
- 事件名称
- 事件 ID
您必须确保两者(TikTok Pixel和Adobe TikTok Web Events API扩展)对所有三个参数使用相同的值。
在 5 分钟内到达的重复事件将被合并 - 如果数据字段不在第一个事件中,则后一个事件将合并到第一个事件中。如果 48 小时内发生重复事件,则后一个事件将被丢弃。
有关事件去重的更多信息,请参阅 事件去重。
TikTok Pixel 配置
为了启用重复数据删除,TikTok Pixel 事件需要在发送到 TikTok 的所有重叠事件中包含 event_id 参数。为此,请在 TikTok Pixel 负载中包含 event_id 参数。
event_id 是广告主选择的唯一字符串。广告主可能已经拥有非常适合用于重复数据删除的订单号或交易 ID。对于没有现成 ID 的广告主,可以使用随机数。但是,此数字在 Pixel Events 和 Adobe TikTok Web Events API 事件中必须保持一致,重复数据删除才能正常工作。
包含 event_id 参数的 TikTok Pixel 代码示例
ttq.track('添加到购物车', {
内容:[
{
content_id: '301',
content_name: '跑鞋',
content_category: 'Shoes > Sneakers > Running shoes',
brand: '您的品牌名称',
数量: 1,
价格: 8,
}],
content_type: 'product',
值:9.2、
currency: 'USD',
},
{event_id:'1239485'});
请存储用于发送 TikTok Pixel 事件的 event_id 变量,并将其包含在 Adobe 数据层中。
Adobe TikTok Web Events API 扩展配置
TikTok Pixel 事件中包含的 event_id 值也需要包含在 Adobe 扩展事件中。为此,可以将变量包含在 Adobe 数据层中,该数据层可以映射到用于事件转发的 XDM 对象:
- 将网站变量映射到数据元素,以及
- 将这些数据元素映射到 XDM 对象
创建数据元素以捕获数据层后,可以将其映射到 XDM 对象。完成后,请将新的 XDM 字段映射到 Event ID 扩展配置页面中的参数。
















