快速入门
重要提示
使用事件 API 接口代表您同意遵守TikTok 商业产品(数据)条款,并且不会与 TikTok 分享敏感数据。
本指南介绍了设置事件API的详细流程。
开始前须知
- 您应具备访问 TikTok 广告管理平台的权限。 TikTok 广告管理平台提供了测试事件功能和诊断工具,助力您的开发测试以及集成后的验证。
- 您需已在TikTok 广告管理平台 工具 > 事件下创建了 Pixel(网站事件)。
- 创建 Pixel 完成后,您可以使用代码安装 Pixel 从而通过网站发送事件,或通过事件 API 发送事件。推荐的最佳做法是同时通过网站和事件 API 发送事件,从而最大化您的事件覆盖率和推广系列效果。此外,通过网站 Pixel 和事件 API 的双通道设置,您的推广系列表现将免于事件中断的干扰,因为当其中一个通道失败时,事件信号仍可通过另一通道传递。若您同时从 Pixel SDK 和事件 API 发送事件,则需要设置事件去重。
如果您希望创建一个新的Pixel,请从第一步开始。如果您希望使用已有的Pixel,请在事件管理平台中点击对应的 Pixel,并直接从第二步开始设置。
1. 创建Pixel
a. 在TikTok 广告管理平台中点击工具 > 事件。
b. 在网站事件区域点击管理,在弹出的页面中点击设置网站事件。
c. 输入Pixel名称,并在关联方式区域选择事件API。
d. 选择安装类型。 - 手动设置事件API:通过获取服务器到服务器的报表,实现与TikTok的直接集成。
2. 生成访问令牌
您需要访问令牌来授权调用事件API。
选择1:直接通过事件管理平台 [推荐]
只有广告账号的管理员或操作员有权限通过事件管理平台生成访问令牌。
步骤: 1. 在事件管理平台中,选择您想要用来汇报事件的Pixel,打开该Pixel并点击设置。 2. 在设置选项卡中, 点击生成访问令牌。令牌之后会自动生成。您可以复制令牌,用于发起API请求。
选择2:使用访问令牌 API
首先您需拥有一个开发者应用。若想了解如何创建开发者应用,请点击这里。
如果您或广告主的开发者应用已获得“度量 > 汇报Pixel事件”的权限,那么请参考OAuth授权和获取访问令牌。
通过事件 API 共享事件数据
事件是指网站访问者为了实现某一业务目标而执行的操作,如将一件商品添加到购物车、填写一个表单或完成一次购买。在集成事件 API 之前,我们建议您预先定义要与 TikTok 共享的事件,以实现您的营销目标。您可以在您服务器的有效负载中添加事件和参数,并发送有效负载。
获取支持的网站事件和参数,请参见报告网站事件和参数。
共享事件的匹配数据
网站事件 API 使用用户信息(如TikTok Click ID)、高级匹配和其他标识,如IP地址和用户代理,匹配网页访客事件与TikTok用户。一旦匹配成功,您通过事件API 共享的信息可用于建立目标受众,为优化算法提供信息,并更好地衡量广告效果。
验证事件设置
创建事件后,您可以验证网络跟踪设置与监测活动。如果您同时从 Pixel SDK 和事件 API 发送事件,则需要进行事件去重,以免同一事件被报告两次。
有关验证事件API设置的最佳实践,请参阅验证事件设置。