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

本文介绍如何通过 Hightouch 设置安全数据连接。Hightouch 支持 TikTok 事件 API，它使您能够将数据从仓库发送到 TikTok 中的事件和自定义受众。

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

• 关于 TikTok 事件 API
  

支持同步

有关同步模式的更多信息，请参阅同步模式文档。

连接到 TikTok

转到 Destinations 概述页面，然后单击 Add destination 按钮。选择 TikTok，点击 “继续”。然后，您可以通过 OAuth 对 TikTok 进行 Hightouch 身份验证。

点击 “登录 TikTok”，登录 TikTok 企业账户，然后点击 “授权”。

完成后，Hightouch 会显示授权成功消息。要完成连接，请为您的 TikTok 目的地起一个描述性名称。

同步配置

连接 TikTok 目标并拥有要从中提取数据的模型后，您可以设置同步配置以开始同步数据。转到同步概述页面，然后单击添加同步按钮开始。然后，选择相关型号和要同步到的 TikTok 目的地。

同步网络事件

通过同步到 TikTok 的网络事件，您可以报告源模型中的不同事件。

为确保同步发送每个事件，您的事件模型必须使用真正唯一的主键。有关更多信息，请参阅事件同步文档。

像素代码

您需要提供 TikTok Pixel ID 才能同步网络事件。要查找您的 Pixel ID，请执行以下作： 前往 TikTok 广告管理平台。将鼠标悬停在“工具”选项上，然后单击“事件”以打开事件管理器。在右侧的数据集概览下，点击要使用的像素。复制像素 ID 值并将其放置在 HighTouch 中的相应字段中。

查看我们的博客文章，了解如何实施 TikTok Pixel。

事件名称

您可以通过静态值或基于模型中的列指定事件名称或类型。名称必须是以下可接受的值之一：AddPaymentInfo、AddToCart、AddToWishlist、ClickButton、CompletePayment、CompleteRegistration、Contact、Download、InitiateCheckout、PlaceAnOrder、Search、SubmitForm、Subscribe 或 ViewContent。

字段映射

您可以发送有关 Web 事件的其他详细信息，例如时间戳、事件（对象）属性和上下文（客户）属性。TikTok 建议您提供尽可能多的上下文信息，以提高将网络事件与 TikTok 广告匹配的概率。

Batch size

You can increase the TikTok Events API batch size up to 1,000 per call. This can improve your sync's speed performance. The default is one event per API call. Keep in mind that TikTok fails an entire batch if it detects an erroneous row. If you suspect that you could have erroring rows, don't use a high batch size.

Test event codes

Test event codes are special codes you can include in your event payload to simulate events. This allows you to test your API implementation without recording real event data.

You can optionally enter a test event code as part of your sync configuration. Navigate to Events Manager by clicking the Assets tab, Event and then Manage Web Events. You can find your test event code in the Test Events tab.

Make sure to remove the test event code if you're running a production sync.

PII 哈希

TikTok 要求使用 SHA256 哈希值对客户身份信息（电子邮件、external_id 和 phone_number）进行哈希处理。默认情况下，Hightouch 会自动为您对这些属性进行哈希处理，但您可以选择不这样做，并自行对身份信息进行哈希处理。

同步离线事件

同步到 TikTok 的线下活动可让您衡量和归因看到您的 TikTok 广告或与您的 TikTok 广告互动的用户的线下活动。

同步离线事件是 TikTok 中仅限白名单的功能。如果您想访问，请联系您的 TikTok 代表。如果您最初在 23 年 6 月 6 日之前配置了 TikTok 目标，则需要重新验证与 TikTok 的连接。

为确保同步发送每个事件，您的事件模型必须使用真正唯一的主键。有关更多信息，请参阅事件同步文档。

事件集 ID

您需要选择事件集 ID 来同步线下事件。您可以在 TikTok 线下事件管理器控制面板中创建新的事件集。

事件名称

您可以通过静态值或基于模型中的列指定事件名称或类型。名称必须是以下可接受的值之一：AddPaymentInfo、AddToCart、AddToWishlist、ClickButton、CompletePayment、CompleteRegistration、Contact、Download、InitiateCheckout、PlaceAnOrder、Search、SubmitForm、Subscribe 或 ViewContent。

字段映射

您至少需要事件名称和至少一个用户属性（例如电子邮件或电话）。emails 和 phones 数组值必须至少包含一个值，但您可以包含多个元素。如果您在 model 列中将单个电子邮件或电话号码作为字符串，Hightouch 会将它们转换为具有一个元素的数组。

批量大小

您可以将 TikTok Events API 批量大小增加到每次调用最多 100 个。这可以提高同步的速度性能。默认值为每次 API 调用 100 个事件。请记住，如果 TikTok 检测到错误的行，它会使整个批次失败。如果您怀疑可能存在错误的行，请不要使用较高的批处理大小。

PII 哈希

TikTok 要求使用 SHA256 哈希值对用户身份信息（电子邮件和phone_numbers）进行哈希处理。默认情况下，Hightouch 会自动为您对这些属性进行哈希处理，但您可以选择不这样做，并自行对身份信息进行哈希处理。

同步自定义受众

Hightouch 允许您通过 文件上传 API 或区段 API 创建和维护自定义受众。您可以在 TikTok 的文档中阅读有关不同 API 的更多信息，并决定哪个最适合您的用例。

分段 API 模式（推荐）

TikTok 允许您通过他们的 Segment API 进行实时批量更新。Hightouch 在源模型中添加数据时，会将数据发送到选定的受众列表。我们建议使用此集成类型，因为 API 较新，并且集成由我们的团队维护。

用户标识符

要确定要在受众中添加或更新哪些用户，请选择模型列和相应的 Tiktok 字段。您可以匹配以下任何经过哈希处理的用户字段：

• IDFA_SHA256
• IDFA_MD5
• GAID_SHA256
• GAID_MD5
• EMAIL_SHA256
• PHONE_SHA256

Hightouch 会自动为您处理所选属性，除非您另有指定。

通过启用 Match Booster 来提高 TikTok 中的匹配率。

文件上传 API 模式（已弃用）

虽然 TikTok 仍然支持此 API，但 Hightouch 已弃用该集成。我们不再向文件上传 API 添加增强功能，到 2023 年底，我们将以编程方式将现有同步迁移到区段 API 模式，并完全停用此功能。

TikTok 允许您通过他们的文件上传 API 上传整个受众。Hightouch 会上传每次同步运行的整个模型查询结果。这些结果有效地替换了以前的文件上传。

记录匹配

通过文件上传模式，您可以匹配以下任何一个经过哈希处理的用户属性：

• IDFA_SHA256
• IDFA_MD5
• GAID_SHA256
• GAID_MD5
• EMAIL_SHA256
• 或PHONE_SHA256

该属性包含 TikTok 期望的哈希类型名称。除非您另有指定，否则 Hightouch 会自动为您散列所选属性。Hightouch 还会使用所选媒体资源的哈希类型创建受众群体列表（如果尚不存在）。

广告主帐号

对于这两种模式，您都需要选择要同步到的广告主帐户。

只有在触发第一次同步运行之前，才能在同步配置中编辑广告客户帐户。否则，进行此更改会导致错误。如果您想在同步运行后使用其他广告客户帐号，则需要创建新的同步。

自定义受众群体名单

Hightouch 允许您使用 TikTok 中的现有受众，或为这两种模式创建新的受众。请注意，如果您使用的是细分模式，则同步运行后无法更改受众群体列表名称，而是必须创建新的同步。

提示和故障排除

网络事件

客户遇到的大多数错误都是验证错误，例如无效的货币代码或电话号码。TikTok 会拒绝任何带有无效货币代码或电话号码的请求，因此 Hightouch 会在发出请求之前先发制人地拒绝这些行，以使同步运行更高效。请参阅 TikTok 的文档，了解预期的货币代码是什么以及电话号码应采用什么格式。注意：货币代码列表可能会不时更新。

自定义受众

如果要将自定义受众同步模式从文件上传 API 切换到区段 API，则需要在保存新配置后运行完全重新同步。

文件上传 API 模式

用户少于 1000 人的受众无效，无法在 TikTok 中使用。更多信息，请参考 TikTok 的文档。

TikTok 允许每个受众每天上传一个基于文件的受众。有关其限制的更多信息，请参阅 TikTok 的文档。

实时调试器

Hightouch 可以全面了解每次 TikTok 同步运行期间进行的 API 调用，自定义受众文件上传模式下的同步除外。在此模式下，Hightouch 会同步完整的查询结果集，因此不会进行更改数据捕获计算。因此，你不会在实时调试器中看到任何有效负载详细信息。

对于网络事件和自定义细分受众群模式同步，我们建议您阅读有关调试提示和技巧的文章以了解更多信息。