TikTok Web事件API扩展概述
TikTok事件API是一个安全的Edge Network服务器API接口,它允许您直接与TikTok共享有关您网站上的用户操作的信息。 您可以使用TikTok Web事件API扩展利用事件转发规则将数据从Adobe Experience Platform Edge Network发送到TikTok。
TikTok先决条件 prerequisites
要将TikTok Web事件API配置为使用TikTok事件API,您需要生成TikTok像素代码并访问令牌。
您必须拥有有效的TikTok商业帐户,才能使用合作伙伴设置创建TikTok像素。 转到TikTok 商业注册页面进行注册并创建帐户(如果尚未注册)。
您必须登录您的企业帐户才能使用合作伙伴设置设置TikTok Pixel。 为此,请执行以下步骤:
- 导航到 Assets 选项卡并选择 事件。
- 在Web事件下,选择 管理。
- 选择 设置Web事件。
- 选择 合作伙伴设置 作为您的连接方法。
有关如何设置TikTok像素的更多信息,请参阅像素入门指南。
成功创建像素后,即可生成访问令牌。 为此,请导航到“像素”并选择 设置 选项卡。 在“事件API”下,选择 生成访问令牌。
有关如何设置像素代码和访问令牌的更多信息,请参阅TikTok 快速入门指南。
安装和配置TikTok Web事件API扩展 install
要安装扩展,请在左侧导航中选择 扩展。 在 目录 选项卡中,选择 TikTok Web Events API扩展,然后选择 安装。
在下一个屏幕上,输入您之前从TikTok广告管理器生成的以下配置值:
- 像素代码
- 访问令牌
完成后,选择 保存。
TikTok Web事件API扩展的
配置事件转发规则 config-rule
设置完所有数据元素后,即可开始创建事件转发规则,以确定将事件发送到TikTok的时间和方式。
在事件转发属性中创建新的规则。 在 操作 下,添加新操作并将扩展设置为 TikTok Web Events API扩展。 要将Edge Network事件发送到TikTok,请将 操作类型 设置为 发送TikTok Web事件API事件。
选择后,会显示用于进一步配置事件的其他控件,如下所述。 完成后,选择 保留更改 以保存规则。
Web事件和参数
Web事件和参数包含有关事件的常规信息。 标准事件在TikTok集成工具中受支持,可用于报告、优化转化和构建受众。
yyyy-MM-dd'T'HH:mm:ss:SSSZ
格式字符串形式的日期时间。 这是必填字段。
用户上下文参数
用户上下文参数包含用于将Web访客事件与TikTok用户匹配的客户信息。 包括多种类型的匹配数据可以提高定位和优化模型的准确性。
_ttp
Cookie中保存唯一标识符。 _ttp
值可提取并用于此字段。ttclid
。
属性参数
使用属性参数配置其他支持的属性。
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中事件转发功能的详细信息,请参阅事件转发概述。