使用 Pixel 助手进行排查
TikTok Pixel 助手是一个 Chrome 扩展程序，通过检查是否存在错误以及提供网站部署建议，帮助你验证 Pixel 是否安装成功并进行故障排查。Pixel 助手提供各个层面的详细诊断信息，包括 Pixel、事件和参数部署等。
深入了解 TikTok Pixel。
如何使用 Pixel 助手进行排查
要使用 Pixel 助手进行排查，你需要先确定发生错误的层级，然后再实施相应的建议：
层级 | 设置模式 | 错误类型 | 触发器 | 建议 |
Pixel | 事件生成器、自定义代码 | 标头中未安装 Pixel 代码。 | 标头中未安装 Pixel 代码。 | 请尽早在网页中放置 Pixel 代码，最好放在 <head></head>标签之间。 |
Pixel | 事件生成器、自定义代码 | Pixel ID 无效 | 无法在你的系统中找到 Pixel ID | 前往事件管理平台，找到正确的 Pixel ID。 |
Pixel | 事件生成器、自定义代码 | 未找到第一方 Cookie | 未启用第一方 Cookie | 前往事件管理平台，在“设置”下的“Cookie 信息”中启用第一方 Cookie。 |
事件 | 自定义代码 | 事件名称/类型为空 | 事件名称/类型为空 | 进入源代码，添加事件名称。 |
事件 | 自定义代码 | 事件名称/类型无效 | 事件名称/类型不受支持 | 进入源代码，更新你的事件。 |
参数 | 自定义代码 | 电子邮箱格式无效 | 电子邮箱格式与标准格式（小写）不符 | 进入源代码，将“{{event}}”事件的电子邮箱参数更新为支持的格式。 |
参数 | 自定义代码 | 电话号码格式无效 | 电话号码格式 (E164) 与标准格式不符 | 进入源代码，将“{{event}}”事件的电话号码参数更新为支持的格式。 |
参数 | 自定义代码 | 缺少“支付完成”事件的电子邮箱或电话号码参数 | 设置了高级匹配参数，但未收到电子邮箱和电话号码信息 | 检查显示的高级匹配参数，查看缺少哪个参数。进入源代码，添加缺失的参数以扩大覆盖面。 |
参数 | 自定义代码 | “value”参数格式无效 | “value”字段中必须包含一个大于零的数字，且不得包含任何特殊字符、币种符号或逗号 | “value”格式必须为整数（例如 100）或小数格式（例如 12.34），且不得包含币种符号、特殊字符、字母或逗号。 |
参数 | 自定义代码 | 缺少 currency/value 参数 | 设置了“value”参数但未设置“currency”参数，或者设置了“currency”参数但未设置“value”参数 | 进入源代码，为“{{event}}”事件添加“currency”或“value”参数。 |
参数 | 自定义代码 | 货币代码无效/不受支持 | 货币代码不属于受支持的货币代码 | 进入源代码，将“{{event}}”事件的“currency”参数更新为支持的货币代码。 |
参数 | 自定义代码 | 缺少内容 ID 值 | 设置了内容参数但未传递任何值 | 进入源代码，为内容 ID 添加值。 |
参数 | 自定义代码 | 缺少内容 ID 参数 | 未收到内容 ID | 请进入你的源代码，然后添加“content_id”参数。 |
参数 | 自定义代码 | 内容类型无效 | 必须为“product”或“product_group” | 内容必须为“product”或“product_group”。进入源代码，更新内容类型。 |
