同时设置 TikTok Pixel 和事件 API

若想安装 TikTok Pixel 并同时通过 Pixel 和事件 API 配置要发送给 TikTok 的事件，您可以将 TikTok Pixel 代码添加到您的 Google 跟踪代码管理器容器中。TikTok 事件管理平台中的交互式设置流程将指导您配置和安装所有必要的 TikTok 代码、触发器和变量，让您只需点击几下即可完成设置。

Google 跟踪代码管理器和事件 API 集成流程将同时设置 TikTok Pixel 和事件 API。推荐您使用这种双通道设置来最大化事件覆盖率和推广系列的表现。通过双通道设置，即使其中一个通道发生故障，由于事件信号仍可通过另一个通道传输，您的推广系列表现将不受影响。

您可根据需要选择以下具体设置指南： - 对于仅 TikTok Pixel 设置，请参阅仅设置 TikTok Pixel。 - 对于仅事件 API 设置，请参阅设置仅事件 API 集成。

前提条件

1. 拥有 Google Analytics（分析）账户，且熟悉 Google Analytics（分析）4 （GA4）。
2. 拥有已安装在您的网站上的网站容器和已安装在您的 Google 跟踪代码管理器账户中的服务器容器。 - 详细了解设置 Google 跟踪代码管理器的步骤。 - 详细了解设置服务器容器。
3. 拥有网站容器和服务器容器的读取、修改、批准、发布权限。详细了解容器权限。

4. 拥有 GCP（Google Cloud Platform) 账户和 GCP 结算账户，用于配置代码植入服务器。了解详情。
5. 熟悉代码、触发器和变量等基本概念以及服务器端代码植入的基本概念。

设置指南

1. 在 TikTok 广告管理平台，点击 工具 > 事件，随后点击 关联数据来源 > 网站 > 合作伙伴集成 > Google Tag Manager > 服务器侧和客户端侧标记。

• 若想为现有 Pixel ID 集成 Google 跟踪代码管理器，在事件管理平台中该 Pixel 的设置选项卡，点击选择合作伙伴 > Google Tag Manager > 服务器侧和客户端侧标记。

2. 登录与您的 Google 跟踪代码管理器账户关联的 Google 账户，然后确保： - 该 Google 账户与您的 Google 跟踪代码管理器账户相关联。 - Google 跟踪代码管理器账户中已创建网站容器和服务器容器。

3. 按照以下说明设置代码植入服务器和服务器的自定义网域。 - 若想使用 Google Cloud Run 设置一个用于测试的、运行完全正常的代码植入服务器，选择自动配置代码植入服务器（推荐）。请注意，此步骤需要创建一个 GCP 结算账户。自动配置的服务器在仅用于测试时通常不产生费用。了解详情。
   • 您可以在之后为自动配置的服务器升级配置以供生产环境使用，或者使用其他云提供商（例如 Amazon AWS或 Microsoft Azure）或在您自己的服务器上手动创建代码植入服务器。详细了解代码植入服务器的部署选项。
   • 若想在不依赖第三方 Cookie 和客户端度量的情况下进行活动度量，需设置自定义网域。您完成集成后，可以为代码植入服务器配置自定义网域。了解详情。

推荐使用自动配置快速设置用于测试的代码植入服务器，并继续其余设置流程。一旦您验证了事件 API 集成运行正常，您可以在之后考虑切换到其他的代码植入服务器部署选项，或为代码植入服务器添加自定义网域。请参阅更新代码植入服务器 URL。

4. 为您的 Pixel 指定一个名称（如果您正在创建一个新的 Pixel），选择要安装 TikTok 代码的 Google 跟踪代码管理器账号、网站容器、服务器容器和工作区。

5. 要设置 TikTok 模板代码，请提供以下信息： - Measurement ID（衡量 ID）：Google Analytics 4（GA4）网站数据流的唯一标识符。您可以在 Google Analytics（分析）账户中找到此 ID。若想了解如何查找衡量 ID，请参阅查找您的衡量 ID。 - 代码植入服务器 URL：您先前设置的代码植入服务器的 URL。

6. 检查、确认并发布对您的 Google 跟踪代码管理器账户的更改。点击"我已确认要发布的每个跟踪代码 (Tag) 的详细信息"。此步骤将自动为您的账户安装 TikTok Pixel 和事件 API 与 Google 跟踪代码管理器正常交互所需的代码、触发器和变量。若想了解具体的安装内容，请参阅 跟踪代码管理器账户的改动。

注意

• 更改一旦发布后，不支持修改。
• 若您正要发布的更改与 Google 跟踪代码管理器工作区现有的代码、变量或触发器存在重名，将跳过重名的更改，以保留您现有的生产环境 Google 跟踪代码管理器设置。
• 若您想对已发布的版本进行任何修改或重置 TikTok 代码、变量或触发器，请参阅如何清除现有集成或重新安装，了解相关步骤。

• 我们将在您的服务器容器中安装的 TikTok 事件 API 代码中自动填充 Pixel ID 和事件 API 访问令牌。如果您将来决定切换到不同的 Pixel ID，请确保按照常见问题中的解答生成新的令牌，并更新 TikTok 事件 API 代码中的 Pixel ID 和访问令牌值。

• 如果在发布更改时遇到报错，您可以按照相关操作说明排查常见原因。解决问题后，重新尝试发布。

7. 更改发布后，您的网站加载时将安装 TikTok Pixel 。请按照事件管理平台中的说明完成事件配置。根据您选择的方式（使用 Google 跟踪代码管理器数据层或手动方式）设置事件后，TikTok Pixel 将开始报告您的网站上的这些事件。此外，您的标记服务器也将向TikTok事件API报告这些事件。 - 若想了解如何使用 Google 跟踪代码管理器数据层设置 TikTok 事件，请参阅使用数据层设置 TikTok 事件。 - 若想了解如何手动设置 TikTok 事件而不使用 Google 跟踪代码管理器数据层，请参阅手动设置事件。

8. 验证事件 API 设置。您可以使用事件管理平台中的测试事件工具验证事件 API 能否正常接收事件。此外，您可以使用 Google 跟踪代码管理器的预览模式验证 TikTok 代码的触发情况。若想了解详细的验证步骤，请参阅验证跟踪代码管理器的设置。

常见问题

问题 1：在检查并发布资源这一步骤中遇到问题。我该怎么办？

答：若您在检查并发布资源过程中遇到问题，可以按照以下步骤进行故障排除：

1. 确保您具有发布更改所需的容器权限（读取、修改、批准、发布权限）。

2. 检查您的容器是否存在任何预先错误，如未定义的变量和触发器。请为您的容器启用预览模式，从而检测工作区中存在的问题。

3. 修复发现的所有问题，然后重新尝试通过事件管理平台的设置流程发布更改。

4. 若问题仍然存在，请尝试清理您的工作区。请参阅如何清除现有集成或重新安装。

问题 2：如何更新代码植入服务器 URL？

答：如果您的代码植入服务器 URL 发生了更改（例如，从 GCP 切换到其他服务器部署选项或为代码植入服务器配置了自定义网域），您需要更新 GA4 配置代码。这样可以确保事件正确路由到新的 URL。以下是您可以更新代码植入服务器 URL 的方法： - 在网站容器中找到 TikTok GA4 配置代码。 - 将 server_container_url 的值更新为新的代码植入服务器 URL，并保存更改。

问题 3：我可以将现有的代码植入服务器设置重新用于事件 API 集成吗？

答：是的，您可以将现有的代码植入服务器设置重新用于事件 API 集成。若您的 Google 跟踪代码管理器网站容器已经包含指向代码植入服务器的 server_container_url 的 Google 代码，您可以继续使用它。只需删除通过交互式设置流程安装的（名为TT-{PixelID}-XXXXX-Web-Tag-GA4_Config的）Google 代码即可。

但是，请确保保留名为 TT-{PixelID}-XXXXX-Web-Tag-GA4_Event 的 TikTok GA4 事件代码和所有其他已安装的变量，因为它们对于正确格式化事件，从而确保您的服务器容器中的 TikTok 事件 API 代码可以解析事件是必要的。

问题 4：如何清除现有集成或重新安装？

答：在某些场景下，您可能需要删除现有的集成并进行重新安装。这些情况包括： - 从仅 TikTok Pixel 单通道集成升级到 TikTok Pixel 和事件 API 双通道集成。 - 出于某种原因（例如为了修复设置问题）而"恢复出厂设置"。

若要在这些场景下清除现有集成并重新安装，需按照以下步骤进行操作： 1. 在同一容器中创建一个备份工作区，以保存现有配置。 2. 在默认工作区中，删除之前安装的 TikTok 代码、变量和触发器。请参阅跟踪代码管理器账户的改动。 3. 清除完成后，通过事件管理平台的交互流程重新集成。 4. 确保将备份工作区中重要的自定义设置重新复制到默认工作区中。

问题 5：如何设置仅事件 API 集成？

答：默认情况下，事件管理平台中的交互式设置流程将 TikTok Pixel 和事件 API 同时与 Google 跟踪代码管理器集成。然而，如果您希望仅使用事件 API 而不使用 Pixel，您可以手动卸载 Pixel 设置。请注意，推荐的设置是同时使用 Pixel 和事件 API，以最大化事件覆盖率和推广系列效果。

若要设置事件 API 集成，请从用于集成的网站容器中删除“TikTok Pixel”和“自定义 HTML”代码。

问题 6：如何选择正确的 API ？

答：Google 代码和跟踪代码管理器是 Google 提供的不同的度量框架，提供类似的功能和 API，可以操作数据层，从而将信息从您的网站传递到跟踪代码管理器容器。

Google 代码对应的 API 是gtag()，跟踪代码管理器对应的 API 是 dataLayer.push()。事件 API 集成支持这两种API，但是由事件管理平台的交互式流程安装的代码和变量组略有不同，以适应对应 API 的行为。 - 若您的网站已经使用其中一个框架（例如，使用用于度量网站的 Google Analytics），您需要继续使用相同的框架和相应的 API 设置 TikTok 事件。请参阅使用数据层设置 TikTok 事件。 - 若您的网站尚未使用这些 API，但您希望为事件 API 集成配置一个 API，请参考 Google 帮助中心文档，选择最适合您业务需求的 API。

问题 7：我是否仍然需要设置 event_id 从而为事件 API 和 Pixel 进行事件去重？

答：不需要。若您使用事件管理平台的交互式设置流程设置了事件 API 和 Pixel 集成，将自动为您配置一个 event_id 变量。您无需额外配置任何内容即可进行事件去重。详细了解事件去重。

问题 8：我手动安装了TikTok 事件 API 模版代码，没有使用事件管理平台的交互式流程。我可以继续使用模版代码吗？

答：是的，可以。如果您从 Google 跟踪代码管理器模板库手动安装了模版代码，您完全可以继续使用它，并保留模板的现有自定义设置。然而，建议您通过事件管理平台的交互式流程升级安装配置，这将确保将来的修改更加容易。若想了解更多详情，请参阅如何清除现有集成或重新安装。

问题 9：如果我切换到另一个 Pixel，我该如何为事件 API 的集成生成新的访问令牌？

答：事件管理平台的交互式设置流程将自动创建一个有效的事件 API 访问令牌，并在 TikTok 事件 API 代码中设置该令牌。然而，若您想切换到另一个令牌（例如，后续切换到另一个 Pixel ID 时），请按照事件 API 开发者文档中的获取访问令牌指南生成该 Pixel ID 的新令牌。

获取支持

• 若您有任何疑问，请联系 TikTok 广告客户支持人员或与您的 TikTok 销售代表联系。
• 若您有功能请求或遇到任何问题，请点击此处在 GitHub 上提交议题。