为什么Facebook CAPI服务端事件请求成功却未在事件测试工具中显示

问题描述 #

我正在为业务实现Facebook Conversion API（FB CAPI），已配置好Purchase事件，计划通过事件测试工具（Event Test Tool）开展验证。目前已完成网页端测试，事件测试工具可正常追踪所有浏览器端事件，但上报服务端事件时，服务端事件标签页中无任何历史记录。

当前请求配置 #

• 请求方法：POST
• Postman请求URL：https://graph.facebook.com/{{API_VERSION}}/{{PIXEL_ID}}/events?access_token={{TOKEN}}
• 请求负载：

{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1619508577,
      "action_source": "email",
      "user_data": {
        "em": "7b17fb0bd173f625b58636fb796407c22b3d16fc78302d79f0fd30c2fc2fc068"
      },
      "custom_data": {
        "currency": "USD",
        "value": "142.52"
      }
    }
  ],
  "test_event_code": "TEST7039"
}

• 请求响应：

{
  "events_received": 1,
  "messages": [],
  "fbtrace_id": "AQqIVn-TahE83ocCagd4HKB"
}

已确认请求返回成功，但无法在事件测试工具的对应标签页查看该服务端事件。

界面情况说明 #

• 浏览器端测试事件界面：可正常接收所有已上报的浏览器端Purchase事件
• 服务端测试事件界面：无任何已上报的服务端事件记录

排查步骤 #

按以下优先级校验，可快速定位问题：

1. 校验测试事件码匹配性
   事件测试工具的不同调试会话完全隔离，只有传入和当前打开的服务端标签页完全一致的test_event_code，事件才会显示在对应标签页。请确认：
   • 请求负载中的test_event_code和标签页顶部显示的测试码完全一致，无多余空格、大小写匹配
   • 未在其他测试会话标签页中查找该事件
2. 校验事件时间时效性
   你当前传入的event_time为1619508577，对应2021年4月27日的历史时间。事件测试工具仅接收 请求发送前后72小时内 的事件，历史时间戳的事件会被判定为离线数据，不会推送到实时调试界面。请将event_time替换为当前请求的实时秒级时间戳后重试。
3. 校验Graph API版本兼容性
   服务端事件同步到测试工具的能力，要求Graph API版本≥v13.0。若你请求中使用的{{API_VERSION}}为更早版本，即使传入test_event_code，事件也不会被推送到调试界面。请升级到v17.0及以上的稳定版本重试。
4. 校验access_token权限范围
   请确认使用的access_token所属应用已绑定对应像素的广告账户，且已开通ads_management、ads_read权限。若权限不足，事件虽然会返回events_received:1，但只会被存入后台数据仓库，不会进入调试推送通道。
5. 延迟排查
   事件从接口传输到测试工具界面存在1-2分钟的正常延迟，可下拉刷新服务端事件标签页，确认是否有延迟返回的记录。

内容的提问来源于stack exchange，提问作者GigaByte