Meta Pixel 像素代码常见错误及故障排查工具介绍

安装 Meta Pixel 像素代码后，每当有用户在你的网站上执行操作时，Pixel 就会触发。你可以使用以下工具诊断可能存在导致你的 Meta Pixel 像素代码无法发送准确数据或根本无法正常工作的问题并验证数据有效负载。

• Pixel Helper 像素代码助手

• Events Manager 事件管理工具中的测试事件工具和诊断工具

• Developer Tools 浏览器中的开发者工具（例如 Chrome 开发工具）

Pixel Helper 像素代码助手

Meta Pixel 像素代码助手可以帮助查看网站上是否安装了 Meta Pixel 像素代码、验证 Pixel 像素代码是否正常运行、了解 Meta Pixel 像素代码接收的事件并检查错误。

Pixel Helper 像素代码助手可帮助查看：

• 当前页面上触发了哪些事件？

• 事件是否在正确的页面上触发了预期的次数和预期的操作？

• 事件中的参数是否正确并按预期实现？

• 什么代码实际负责事件触发？

• 事件源自哪个框架，比如主窗口或 iFrame ?

• 意外数据（不完整、无效或多余的数据）是否被传递到标准事件中？

Events Manager 测试事件工具

如果你使用 Facebook SDK、移动应用成效衡量合作伙伴、应用事件 API 或 Meta Pixel 像素代码向 Meta 发送应用事件或网站事件，那么可以使用 Meta 事件管理工具中的测试事件工具来确认你是否正确设置了标准或自定义事件。

你可以借助测试事件工具完成以下操作：

• 确保你已正确设置应用和网页浏览器事件，并且 Meta 已收到这些事件，

• 调试任何异常活动，

• 通过查看哪些事件进行了处理，以及哪些数据进行了去重处理来检查是否正确设置了去重复功能（仅针对网站事件）。

所有测试信息将在测试事件选项卡中保留 24 小时，或直到你点击清除这些数据。如果事件未显示在测试事件工具中，你可以通过错误消息进行故障排除。

Events Manager 诊断工具

除了 Meta 事件管理工具中数据源页面上的测试事件工具外，你还可以访问诊断工具选项卡。Meta 事件管理工具中诊断工具可帮助你查找及解决与网站、应用或线下事件设置有关的常见问题。“诊断工具”选项卡还会提供有关如何改善事件设置的建议。

使用此工具可以：

• 发现并排查直接导致像素触发的问题，

• 获取有关改进事件的建议，

• 查看诊断消息，

• 查看每条诊断信息中的解决方案部分。

  
  

诊断工具所示的每个问题都附带问题描述以及解决问题的步骤。黄色图标表示警告，可能不需要执行操作，但仍应注意；红色图标表示错误，需要执行操作以解决问题。

Chrome DevTools

Chrome DevTools 可帮助你准确查看通过网络活动传入 Meta 事件管理工具的跟踪调用的时间和内容，你还可以使用 Chrome DevTools 记录 HTTP 请求并查看与 HTTP 请求相关的元数据（Metadata）。

Chrome DevTools 开发者工具网络（Network）面板的一些基本功能可以帮助你准确查看何时以及将哪些跟踪调用传递给 Meta 事件管理工具。它可以帮助你：

• 使用网络（Network）面板的基本功能，查看通过网络活动向 Meta 事件管理工具传递跟踪调用的确切时间和内容，

• 使用保留日志（Preserve log）和停用缓存（Disable cache）等功能记录 HTTP 请求，

• 查看与 HTTP 请求相关的元数据（Metadata），如确切时间、参数、发起方、响应和请求标头。

  
  

Chrome DevTools Network Tab

在 Chrome 开发者工具中，你可以对字符串 "facebook.com/tr "或你的像素 ID 使用过滤器，检查发送到 Facebook 服务器的所有跟踪调用。

常见 Pixel 像素错误

无效货币代码

Error (“British Pound”)”: fbq('track', 'Purchase', {'value': 4, 'currency': 'British Pound' });
fbq('track', 'Purchase', { 'value': 4, 'currency': 'GBP' });

如果事件的货币代码格式不正确，则会显示无效的货币代码错误。货币代码必须与标准的国际三字母 ISO 货币代码匹配，例如 USD 和 GBP；

事件名称不匹配

Error (“purchase”): fbq('track', 'purchase', { 'value': 4, 'currency': 'USD' });
fbq('track', 'Purchase', { 'value': 4, 'currency': 'USD' });

如果一个或多个标准事件与其中一个标准事件相似但不完全相同，则会显示事件名称不匹配警告。事件区分大小写，在上述例子中，标准事件 Purchase 必须与标准事件格式匹配，并使用大写的“P”。

无效值参数/缺失值参数或缺少货币参数

Error (blank value): fbq('track', 'purchase', { 'value': '', 'currency': 'USD' });
fbq('track', 'Purchase', { 'value': 4, 'currency': 'USD' });

如果事件的值或货币参数为空或缺失，则会显示无效值参数/缺失值参数或缺失货币参数警告消息。如果值或货币参数的格式不正确，也会显示该值。在此情况下，值参数丢失。

以上便是 Meta Pixel 像素代码常见错误及故障排查工具介绍。