如何通过 mParticle 与 TikTok 建立安全的数据连接

TikTok for Business 提供了许多工具，可让您与 TikTok 分享人们在您的网站上采取的作。当您与 TikTok 分享这些事件时，您可以更好地优化您的广告活动并衡量广告效果。

本文介绍如何通过 mParticle 设置安全数据连接。mParticle 支持 TikTok 事件 API。TikTok 的事件 API 是一种安全的服务器到服务器集成，允许广告商直接与 TikTok 分享客户在其网站上执行的作，而无需在您的网站上安装像素。

有关这些连接工具的更多信息，请查看以下资源：

先决条件

与 TikTok 建立数据连接时，您将需要您的访问令牌和 Pixel ID。

要查找您的 Pixel ID，请执行以下作：

要找到您的访问令牌 ID，请执行以下作：

在传出的 TikTok 事件有效负载中，支持 3 个主要标识符：

对于每个，都会显示一个下拉设置，允许客户选择应将哪个 mParticle 标识类型映射到该值。所有传出的身份信息都根据 TikTok 的文档进行 SHA-256 哈希处理。有关详细信息，请参阅连接设置。

至少需要上述标识符之一。如果给定用户的个人资料中没有包含任何内容，则他们的事件将不会被转发到 TikTok，因为归因将失败。

mParticle 场	TikTok 事件字段	描述
event.name	事件	转化事件名称。根据传入事件类型进行设置。
event.source_message_id	event_id	用于 TikTok 中事件重复数据删除的默认 ID。如果不可用，我们会回退到event_id
event.timestamp_unixtime_ms	时间戳	原始事件时间戳。这必须是毫秒级分辨率（例如1455236520490）
知识产权	上下文.ip	浏览器的非散列公共 IP 地址。TikTok 处理需要 IP 和 user_agent，有助于提高网站访问者事件与 TikTok 广告匹配的概率。
event.device_info.http_header_user_agent	context.user_agent	来自用户设备的非哈希用户代理。TikTok 处理需要 ip 和 user_agent，并有助于增加将网站访问者事件与 TikTok 广告匹配的可能性。

无论类型如何，所有传出事件都将包含以下事件信息。

必须在每个有效的传入事件上指定自定义标记，以支持每个传出 TikTok 事件的 context 属性中的特定字段。

mParticle 自定义标志	TikTok Event 字段	是必需的	描述	例
TikTok.网址	context.page.url 的	真	事件发生时的页面 url。必须以“http://”或“https://”开头，否则活动将无法通过 TikTok 处理	“http://demo.mywebsite.com/purchase”
TikTok.Referrer （英文）	context.page.referrer	假	Page referrer 的	“http://demo.mywebsite.com”
TikTok.回调	context.ad.callback 的	假	TikTok 点击 ID （ttclid）。这表示每当用户在 TikTok 上点击广告时，都会附加到着陆页 URL 的跟踪参数。格式正确的字符串应以 “E.C.P” 开头。不要发送 TikTok 虚拟值。	“E.C.P.v3fQ2RHacdksKfofPmlyuStIIHJ4Af1tKYxF9zz2c2PLx1Oaw15oHpcfl5AH”

此集成支持的唯一原生 mParticle 事件类型是 CommerceEvent。mParticle 支持以下事件映射：

mParticle 事件	TikTok 活动
具有add_to_cart产品作的商务事件。	添加到购物车
具有add_to_wishlist产品作的商务事件。	添加到愿望清单
具有购买产品作的 Commerce 事件。Snap 本身不支持退款。	地点订购
具有结帐产品作的 Commerce 事件。	发起结账
具有view_detail产品作的商务事件。	查看内容

其他 CommerceEvent 类型仍然不受支持。mParticle 支持以下商业和产品信息映射：

mParticle 场	TikTok 事件字段	描述
event.product_action.货币	属性.currency	ISO 4217 代码。示例：“USD”。
event.product_action.total_amount	属性值	订单或已售商品的价值。示例：100。注意：价格是单个商品的价格，价值是订单的总价。
event.product_action.产品[x].价格	properties.contents[x].price	商品的价格。示例：25。注意：价格是单个商品的价格，价值是订单的总价。
event.product_action.产品[x].数量	properties.contents[x].quantity	项目编号。示例：4
event.product_action.products[x].id	properties.contents[x].content_id	产品项目的 ID。示例：“1077218”
event.product_action.products[x].category	properties.contents[x].content_category	页面/产品的类别。示例：“服装”
event.product_action.products[x].name	properties.contents[x].content_name	页面/产品的类别。示例：“服装”

为了支持不与 mParticle 事件一对一映射的 TikTok 事件类型，你可以在 mParticle UI 中为特定连接手动配置自定义映射。此功能允许将传入的 mParticle 事件映射到已知的 TikTok 事件类型，包括具有特定属性和传出参数的事件类型。

所有 TikTok 事件映射都支持 description 属性。

此外，每个相应的事件还支持以下附加属性：

设置名称	数据类型	是必需的	已加密	描述
访问令牌	字符串	真	真	提供对 TikTok 事件 API 的访问。你可以在 TikTok 事件管理平台中创建访问令牌。

设置名称	数据类型	违约	是必需的	描述
像素ID（Pixel ID）	字符串	零	真	TikTok 广告账户的唯一 Pixel ID。
电子邮件身份类型	字符串	电子邮件	真	要作为电子邮件转发给 TikTok 的身份类型。
外部标识类型	字符串	客户 ID	真	要作为外部 ID 转发给 TikTok 的身份类型。
电话身份类型	字符串	手机号码	真	要作为电话号码转发给 TikTok 的身份类型。
电话身份类型	字符串	产品	真	content_type 属性可以设置为 “产品 ”或 “product_group”，具体取决于 TikTok 端的数据馈送和产品目录的配置方式。