TikTok Web事件API扩展概述
TikTok事件API是一个安全的Edge Network API接口,允许您直接与TikTok共享有关您网站上的用户操作的信息。 您可以使用Adobe Experience Platform Edge Network Web事件API扩展利用事件转发规则将数据从TikTok发送到TikTok。
TikTok先决条件 prerequisites
要将TikTok Web事件API配置为使用TikTok事件API,您需要生成TikTok像素代码并访问令牌。
您必须拥有有效的TikTok商业帐户,才能使用合作伙伴设置创建TikTok像素。 转到TikTok 商业注册页面进行注册并创建帐户(如果尚未注册)。
您必须登录您的企业帐户才能使用合作伙伴设置设置TikTok Pixel。 为此,请执行以下步骤:
- 导航到 Assets 选项卡并选择Event。
- 在Web事件下,选择Manage。
- 选择 Set Up Web Events。
- 选择 Partner Setup 作为您的连接方法。
有关如何设置像素的更多信息,请参阅像素入门TikTok指南。
成功创建像素后,即可生成访问令牌。 为此,请导航到“像素”并选择 Settings 选项卡。 在“事件API”下,选择Generate Access Token。
有关如何设置像素代码和访问令牌的更多信息,请参阅TikTok 快速入门指南。
安装和配置TikTok Web事件API扩展 install
要安装扩展,请在左侧导航中选择Extensions。 在 Catalog 选项卡中,选择TikTok Web Events API Extension,然后选择Install。
在下一个屏幕上,输入您之前从TikTok广告管理器生成的以下配置值:
- Pixel Code
- Access Token
完成后,选择Save。
配置事件转发规则 config-rule
设置完所有数据元素后,即可开始创建事件转发规则,以确定将事件发送到TikTok的时间和方式。
在事件转发属性中创建新的规则。 在 Actions 下,添加新操作并将扩展设置为TikTok Web Events API Extension。 要将Edge Network事件发送到TikTok,请将 Action Type 设置为Send TikTok Web Events API Event。
选择后,会显示用于进一步配置事件的其他控件,如下所述。 完成后,选择 Keep Changes 以保存规则。
Web Events and Parameters
Web事件和参数包含有关事件的常规信息。 标准事件在TikTok集成工具中受支持,可用于报告、优化转化和构建受众。
yyyy-MM-dd'T'HH:mm:ss:SSSZ格式字符串形式的日期时间。 这是必填字段。
User Context Parameters
用户上下文参数包含用于将Web访客事件与TikTok用户匹配的客户信息。 包括多种类型的匹配数据可以提高定位和优化模型的准确性。
[+][country code][area code][local phone number]。_ttp Cookie中保存唯一标识符。 _ttp值可提取并用于此字段。ttclid上选择广告时都添加到登陆页面URL的TikTok。
Properties Parameters
使用属性参数配置其他支持的属性。
product或product_group的值分配给content_type对象属性,具体取决于您在设置产品目录时配置数据馈送的方式。
事件去重 deduplication
如果您同时使用TikTok pixel SDK和TikTok Web事件API扩展将相同的事件发送到TikTok,则需要设置TikTok像素以进行重复数据删除。
如果从客户端和服务器发送的不同事件类型没有任何重叠,则不需要重复数据删除。 要确保您的报表不会受到负面影响,您必须确保为TikTok像素SDK和TikTok Web事件API扩展共享的任何单个事件删除重复项。
发送共享事件时,请确保每个事件都包含像素ID、事件ID和名称。 相互之间在5分钟内到达的重复事件将被合并。 如果第一个事件中数据字段不存在,则它将与后续事件组合。 将删除在48小时内收到的所有重复事件。
有关此过程的更多详细信息,请参阅有关TikTok事件重复数据删除的文档。
后续步骤
本指南介绍了如何使用TikTok Web事件API扩展将服务器端事件数据发送到TikTok。 有关Adobe Experience Platform中事件转发功能的详细信息,请参阅事件转发概述。