← 返回目录
📁 Marketing API › Ad Measurement › Guides › Google Tag Manager (GTM) Integration

仅设置 TikTok Pixel

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

注意
本文概述了使用 Google 跟踪代码管理器设置 TikTok Pixel 的步骤。您还可以使用 Google 跟踪代码管理器同时设置 TikTok Pixel 和事件 API(服务器端),充分利用服务器端和客户端设置的优势来最大化推广系列效果。

前提条件

  1. 已拥有 Google 跟踪代码管理器账户和已安装在您的网站上的网站容器。详细了解设置 Google 跟踪代码管理器的步骤。

  2. 已拥有网站容器的读取、修改、批准、发布权限。详细了解容器权限。

网站容器的读取、修改、批准、发布权限

  1. 熟悉 Google 跟踪代码管理器,以及客户端、代码、触发器和变量等基本概念。详细了解基本概念。

设置指南

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

Tools > Events

Connect data source

Web

Partner integrations

Client-side tagging

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

Settings

Choose Partner

Client-side tagging

  1. 首先登录与您的 Google 跟踪代码管理器账户关联的 Google 账户,然后按照说明完成账户关联。

选择账户

  1. 为您的 Pixel 指定一个名称(如果您正在创建一个新的 Pixel),选择要安装 TikTok 代码的 Google 跟踪代码管理器账号 、容器和工作区。

Name your pixel 选择账号 、容器和工作区

  1. 选择设置事件的方式(即要发送到 TikTok 的具体事件和参数及发送时间)。 - 使用事件生成器设置(推荐)。通过事件生成器可轻松、无需代码地直接设置您的网站事件。若想了解更多详情,请参阅 TikTok 事件生成器。 - 使用 Google 跟踪代码管理器数据层 API。对于已经与 Google 跟踪代码管理器数据层集成以发送自定义事件数据的网站,即您的网站已经使用 gtag()(Google 代码 API)或 dataLayer.push()(跟踪代码管理器 API),我们将安装 TikTok 代码和变量,自动将数据层事件转换为 TikTok 网站事件并将网站事件发送至 TikTok。请参阅使用数据层设置 TikTok 事件。

Choose method

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

注意

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

Review and publish resources

  1. 更改发布后,您的网站加载时将安装 TikTok Pixel 。您通过事件生成器或 Google 跟踪代码管理器数据层完成事件设置后,TikTok Pixel 将开始在您的网站上报告这些事件。 - 若您之前选择了事件生成器作为事件设置方法,请参阅事件生成器指南。 Set up events - 若您之前选择了 Google 跟踪代码管理器数据层作为事件设置方法,请参阅使用数据层设置 TikTok 事件。

  2. 验证 TikTok Pixel 设置。您可以使用测试事件工具或事件管理平台中的 Pixel 助手插件验证 Pixel 设置。此外,您可以使用 Google 跟踪代码管理器的预览模式验证 TikTok 代码的触发情况。若想了解详细的验证步骤,请参阅验证跟踪代码管理器的设置。

Set up events

常见问题

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

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

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

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

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

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

问题 2:我一开始选择使用事件生成器设置事件,但现在我想切换到使用 Google 跟踪代码管理器数据层(即 gtag() 或 dataLayer.push() API)。我该怎么操作?

答:若要切换到 Google 跟踪代码管理器数据层 API,需按照以下步骤进行操作: 1. 通过事件管理平台流程重新设置。 2. 在设置过程中,选择使用 Google跟踪代码管理器数据层 API。这将触发用于支持数据层集成的额外代码和变量的增量安装。若想了解每种安装方式的具体安装内容,请参阅跟踪代码管理器账户的改动。

若您之前已经使用数据层 API 设置了事件,并且希望继续使用事件生成器,您不需要进行任何更新。数据层 API 集成已支持事件生成器设置。

event_q2

问题 3:如何清除现有集成或重新安装?

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

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

问题 4:我手动安装了 TikTok Pixel 模版代码,没有使用事件管理平台的交互式流程。我可以继续使用模版代码吗?

答:是的,可以。如果您从 Google 跟踪代码管理器模板库手动安装了 TikTok Pixel 模版代码,您完全可以继续使用它,并保留模板的现有自定义设置。

获取支持

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

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →