Meta 广告排障工具

Pixel / CAPI 事件 JSON 检查器

先检查事件结构,再到 Meta 后台验证投递。排查秒与毫秒混用、购买金额币种、事件 ID 缺失,以及单批数据里的重复事件。

粘贴前先脱敏:移除 access_token、姓名、邮箱、电话、IP、Cookie 和真实客户标识。URL 中也可能带有个人信息。输入只在当前浏览器内处理,本工具不发送、不保存事件 JSON;哈希值同样不建议作为匿名数据公开。
0.0 / 200 KB

每次最多 100 个事件、200 KB(204,800 字节)。适用于 CAPI 事件对象;不执行 fbq 代码,也不会替你发送事件。示例里的订单和全零占位哈希均为虚构。

正在加载本地检查器…

检查前,准备哪一段数据?

  1. 从自己有权维护的服务端代码或调试记录中,提取发送给 Conversions API 的事件对象。保留字段结构、值的类型和需要核对的金额口径,删除 HTTP 请求头及访问令牌。
  2. 把客户信息替换成虚构占位内容;真实订单号替换为 demo-order-1001,来源地址替换为 https://example.com/checkout/complete。如需排查重复,替换时应保留事件 ID 原有的相等关系。
  3. 保留问题发生时的时间戳,方便检查时间单位;如担心泄露业务时间,可使用同量级的虚构值,并另行核对原始事件发生时间。
  4. 粘贴单个 JSON 对象或带有 data 数组的请求体,点击“检查 JSON”。本工具按 CAPI 命名检查,浏览器 Pixel 的 eventID 需要另行对照服务端 event_id

这些结果分别说明什么?

检查项本地能够发现仍需人工核对
名称与来源名称为空、action_source 缺失或不在已核验取值中。名称是否代表实际用户行为;来源是否准确。
事件时间数字类型、整数秒、疑似毫秒,以及明显偏离本机时间的情况。设备时钟、真实发生时间和 Meta 当前适用接收时效。
购买金额Purchase 缺少金额/币种、负数、字符串金额或币种格式不正确。币种是否有效;金额是元还是分,是否包含税费、运费或折扣。
事件 IDevent_id 缺失,或单批内名称与 ID 的组合重复。浏览器与服务端是否发送到相同数据源;是否对应同一次行为;Meta 是否已去重。
客户信息user_data 缺失、为空或类型错误。允许使用的数据、规范化与哈希方式、实际匹配质量。非空不等于有效。

示例:为什么有两条 Purchase,却只有一笔订单?

假设同一笔虚构订单在浏览器和服务端各产生一次 Purchase。使用 Meta 推荐的名称与 ID 去重方式时,两端应使用同一名称和同一事件标识:

浏览器 Pixel:event = "Purchase",eventID = "demo-order-1001"
服务端 CAPI:event_name = "Purchase",event_id = "demo-order-1001"

如果两端各自随机生成了不同 ID,即使金额、商品和时间相近,也不能据此断定它们会按这组字段去重。反过来,如果两笔不同订单复用了同一个 ID,也应修正生成逻辑。重试同一次事件应保留原标识,新的实际行为应有自己的标识。

本工具看到相同名称和 ID 时只会提示核对。批次里重复了两条服务端事件,并不能证明浏览器事件已经到达或 Meta 已执行去重。可在教学专栏查找 Pixel / CAPI 排查与事件核对的相关文章。

结构检查后,到 Events Manager 核实

  1. 在 Meta 事件管理工具中选择正确的数据源,进入“测试事件 / Test Events”。界面名称可能随账号和版本变化。
  2. 按后台说明配置测试事件代码,在你有权操作的测试环境触发一次可识别的行为。测试代码和访问凭证应留在你自己的环境,不要粘贴到本工具。
  3. 查看浏览器与服务端事件的接收记录,核对事件名、ID、来源、金额与币种,并查看后台提供的去重与诊断信息。收到 HTTP 成功响应不等于归因或去重结果正确。
  4. 对照同一笔测试订单核查业务日志,再按正常数据的延迟观察报表。测试事件页面、诊断和广告归因报表回答的问题不同,不应仅凭某一处的数量下结论。

为什么金额显示正常,ROAS 还是不对?

value: 4990value: 49.90 都是合法的数字结构,但如果订单为 49.90 美元而系统把“分”直接上报,转化价值就会被放大 100 倍。三个大写字母也只是币种格式;本工具不会把任意三个字母认定为有效货币。请始终回到原始订单,核对收入、税费、运费、折扣和退款的处理方式。

参数与去重说明核验于 2026-09-18。来源:Meta Server Event ParametersHandling Duplicate Pixel and Conversions API Events。规则会随接口变化,本工具只覆盖页面列出的常见检查。