TikTok Pixel 不工作？怎么测试、怎么修常见报错

TikTok Pixel 不工作？先用 Pixel Helper 查

• TikTok Pixel Helper 是 TikTok 官方的 Chrome 插件，专门用来检查像素。去 Chrome 应用商店装最新版。
• 先对你的店铺关掉广告拦截插件。TikTok 说明过，浏览器里的广告拦截会让像素收不到数据。
• 打开店铺，像顾客一样走一遍：商品页、加购、结账。Pixel Helper 会显示每个页面上像素和事件有没有触发。
• 它分三层检查：像素、事件、参数。查出的每个问题都附带修复建议。

Pixel Helper 的报错怎么看

下面是 TikTok 文档里列出的 Pixel Helper 报错，按层分。事件层和参数层的报错只针对用自定义代码 (Custom Code) 装的像素。

• 像素代码不在页头：把基础代码尽量放在页面靠前的位置，最好放进 head 里。
• 像素 ID 无效：去事件管理工具里复制正确的 ID。没开第一方 Cookie：在事件管理工具的像素设置里打开。
• 事件名为空或不支持 (Event name/type is empty / invalid)：代码里的事件名没填，或者不是 TikTok 认的名字。拿去和 TikTok 的标准事件名逐个字母对一遍。
• value 格式不对：value 必须是大于 0 的数字，比如 100 或 12.34，不能带货币符号、字母或逗号。
• 缺少 currency 或 value：只传了 value 没传 currency，或者反过来。货币代码无效，是说这个代码不在 TikTok 支持的列表里。
• 缺少商品 ID，或商品 ID 是空的：content ID 没传或传了空值。content_type 只能是 product 或 product_group。
• 邮箱、手机号格式不对：邮箱要小写，手机号要用 E.164 格式。只有开了高级匹配 (Advanced Matching) 才会涉及。

缺少 value 参数：按价值优化需要哪些参数

如果你按广告支出回报率 (ROAS) 或按价值优化投放，value 和 currency 就很关键。TikTok 的参数说明里是这样写的：

• value：订单总价，传数字。ROAS 和按价值优化 (Value-Based Optimization，VBO) 都必填。
• price：单件商品的价格，ROAS 和 VBO 也列了它。
• currency：TikTok 支持的 ISO 货币代码，比如 USD、EUR、GBP。ROAS 必填。只传 value 不传 currency，Pixel Helper 会报错。
• content_ids 或 contents：商品 ID。视频购物广告 (Video Shopping Ads) 必填。TikTok 建议和商品目录里的 sku_id 或 item_group_id 对上；只有一个 ID 也用 content_ids 这个字段名。
• content_type：product 或 product_group，视频购物广告同样必填。

事件名：CompletePayment 现在叫 Purchase

TikTok 在 2025 年更新了标准事件，网站端从 2025 年 5 月 1 日开始。老名字照样能用，新装的建议用新名字。

• CompletePayment 改名为 Purchase。TikTok 会在后台把老名字转过来，代码里不用改。
• SubmitForm 改名为 Lead，处理方式一样。
• PlaceAnOrder 和 ClickButton 进入软弃用：2027 年前都完整支持，但新装的不建议再用；历史数据也没法迁到新事件上。
• 现在新写代码，下单完成就用 Purchase，不要再用 CompletePayment 或 PlaceAnOrder。

在事件管理工具里查：测试事件和诊断

• 在 TikTok Ads Manager 里打开事件管理工具，在数据集概览 (Datasets overview) 里点你的像素。每个像素都有概览 (Overview)、测试事件 (Test Events)、诊断 (Diagnostics) 三个标签页。
• 测试事件：从这里打开你的网站，可以直接在浏览器里开，也可以模拟在 TikTok App 里打开的样子；然后操作一遍，看事件进来。可以按浏览器端、服务器端筛选。
• 诊断：列出每个问题的严重程度和受影响的广告。点 Learn more 能看到修复方法和最近受影响的事件样本。标签页旁边有数字，说明有未处理的问题。
• 概览：每个事件过去 7 天内收到过就显示 Active，否则显示 No recent activity；还会标出事件来自浏览器、服务器还是两者都有。
• 后台数据不是实时的，TikTok 说可能要 24 小时甚至更久才显示。想马上看到，用测试事件。

广告组里用不了这个事件怎么办

想用来优化的事件在广告组里选不了，TikTok 建议这样排查：

• 事件必须在正式网站上真实发生过。在测试事件里的操作不算数，要真下一单，可以用 100% 折扣码，店铺支持的话也可以用测试卡。
• 用 Pixel Helper 确认这个事件确实触发了。
• 检查广告组里选的是不是正确的像素。
• 这个优化事件在事件管理工具里应该显示 Active。数据可能晚一天到，别太早下结论。

Shopify、服务器端事件，以及浏览器检查看不到的部分

• Shopify 店铺可以通过 TikTok App on Shopify 接入像素，并选择数据共享级别：Standard 只用 TikTok Pixel；Enhanced 再加上 Events API 和高级匹配；Maximum 还会加上 Shopify API 和 In-App Shopify Checkout (目前是测试版)。
• Events API 的事件从服务器直接发给 TikTok，不经过浏览器，Pixel Helper 里看不到。要查它们，用测试事件里的服务器端筛选，以及概览页上的连接方式。
• Meta 也是同样的思路，浏览器像素和 Conversions API 各管一边。可以参考怎么确认 Meta Pixel 在正常工作。
• Pixel Audit 在我们的服务器上做浏览器这一侧的检查：打开你的店铺，走一遍首页、商品、购物车、结账，报告 TikTok 和另外 7 个平台的代码发了什么，包括缺失、重复、发错页面的事件和不对的参数。它不下单，也看不到 Events API 的事件。问题清单免费看。