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。 为此,请执行以下步骤:

  1. 导航到​ Assets ​选项卡并选择​ 事件
  2. 在Web事件下,选择​ 管理
  3. 选择​ 设置Web事件
  4. 选择​ 合作伙伴设置 ​作为您的连接方法。

有关如何设置TikTok像素的更多信息,请参阅像素入门指南。

成功创建像素后,即可生成访问令牌。 为此,请导航到“像素”并选择​ 设置 ​选项卡。 在“事件API”下,选择​ 生成访问令牌

有关如何设置像素代码和访问令牌的更多信息,请参阅TikTok 快速入门指南

安装和配置TikTok Web事件API扩展 install

要安装扩展,请在左侧导航中选择​ 扩展。 在​ 目录 ​选项卡中,选择​ TikTok Web Events API扩展,然后选择​ 安装

扩展目录显示TikTok扩展卡突出显示安装。

在下一个屏幕上,输入您之前从TikTok广告管理器生成的以下配置值:

  • 像素代码
  • 访问令牌

完成后,选择​ 保存

TikTok Web事件API扩展的 TikTok配置屏幕。

配置事件转发规则 config-rule

设置完所有数据元素后,即可开始创建事件转发规则,以确定将事件发送到TikTok的时间和方式。

在事件转发属性中创建新的规则。 在​ 操作 ​下,添加新操作并将扩展设置为​ TikTok Web Events API扩展。 要将Edge Network事件发送到TikTok,请将​ 操作类型 ​设置为​ 发送TikTok Web事件API事件。

正在为数据收集UI中的TikTok规则选择发送TikTok Web事件API事件操作类型。

选择后,会显示用于进一步配置事件的其他控件,如下所述。 完成后,选择​ 保留更改 ​以保存规则。

Web事件和参数

Web事件和参数包含有关事件的常规信息。 标准事件在TikTok集成工具中受支持,可用于报告、优化转化和构建受众。

输入
描述
活动名称
事件的名称。 这些操作具有由TikTok创建的预定义名称,是必填字段。 有关受支持事件的更多信息,请参阅TikTok 营销API文档。
事件时间
ISO 8601或yyyy-MM-dd'T'HH:mm:ss:SSSZ格式字符串形式的日期时间。 这是必填字段。
事件ID
广告商为指示每个事件而生成的唯一ID。 这是一个可选字段,用于删除重复项。

显示输入到字段中的示例数据的Web Events and Parameters部分。

用户上下文参数

用户上下文参数包含用于将Web访客事件与TikTok用户匹配的客户信息。 包括多种类型的匹配数据可以提高定位和优化模型的准确性。

输入
描述
IP地址
浏览器的非哈希公共IP地址。 支持IPv4和IPv6地址。 IPv6地址的完整和压缩形式均可识别。
用户代理
来自用户设备的非哈希用户代理。
电子邮件
与转化事件关联的联系人的电子邮件地址。
电话
在进行哈希处理之前,电话号码必须采用E164格式[+][国家/地区代码][区号][local phone number]。
Cookie ID
如果您使用的是Pixel SDK,则在启用Cookie的情况下,将会自动在_ttp Cookie中保存唯一标识符。 _ttp值可提取并用于此字段。
外部 ID
任何唯一标识符,例如用户ID、外部Cookie ID等,都必须使用SHA256进行哈希处理。
TikTok点击ID
每次在TikTok上选择广告时都添加到登陆页面URL的ttclid
Page URL
事件时的页面URL。
页面反向链接URL
页面反向链接的URL。

显示输入到字段中的示例数据的User Context Parameters部分。

属性参数

使用属性参数配置其他支持的属性。

输入
描述
价格
单个项目的成本。
数量
在事件中购买的项目数。 该值必须为大于0的正数。
内容类型
必须将productproduct_group的值分配给content_type对象属性,具体取决于您在设置产品目录时配置数据馈送的方式。
内容Id
产品项目的唯一标识符。
内容类别
页面/产品的类别。
内容名称
页面/产品的名称。
货币
在事件中购买项目的货币。 这以ISO-4217表示。
订单的总价。 此值将等于价格*数量。
描述
项目或页面的描述。
查询
用于查找产品的文本字符串。
状态
订单、项目或服务的状态。 例如,“submitted”。

显示输入到字段中的示例数据的Properties Parameters部分。

事件去重 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中事件转发功能的详细信息,请参阅事件转发概述

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743