通过Offline Conversions API上传Purchase事件后无数据显示的咨询

核心结论 #

API返回{"id":"<offline_event_set_id>","num_processed_entries":1}仅代表数据被Facebook服务器接收，不代表已完成匹配、审核或展示，大概率不是bug，先按以下步骤排查。

数据显示的常规延迟 #

离线事件需要经过接收、哈希校验、用户匹配、隐私审核等环节，不同情况的展示时间：

• 无真实用户匹配的测试事件：一般24-48小时后会出现在事件管理器的历史或概览中
• 真实匹配成功的事件：最快几小时，慢则3-7天（受隐私政策和用户匹配率影响）
• CSV上传的测试数据：同样遵循上述延迟，今日上传的记录大概率还在处理队列里

关键排查步骤 #

• 检查事件时间范围：你的请求中event_time对应2022年11月28日，若事件时间距当前超过7天，会被归为历史归档，需在历史标签页手动筛选对应日期范围才能看到。
• 验证哈希格式正确性：em和ph必须是全小写原始值+SHA-256哈希，原始数据不能带空格或特殊字符（比如邮箱要先转小写再哈希），格式错误会导致匹配失败，事件不会被统计展示。
• 确认系统用户权限：确保系统用户拥有offline_conversions的WRITE权限，且已关联目标离线事件集，权限不足可能导致数据被接收但无法正常展示。
• 查看诊断日志：进入离线事件集的「诊断」标签页，检查是否有哈希错误、匹配失败、权限警告等日志，这些是事件不显示的常见原因。

额外验证方法 #

• 用API查询上传记录：调用以下接口查看所有上传历史（含API和CSV），如果能看到今日的上传条目，说明数据已进入处理流程，只是还没同步到事件管理器界面：

  GET https://graph.facebook.com/v15.0/<offline_event_set_id>/uploads?access_token=<system_user_access_token>
  

• 上传无匹配键的测试事件：临时去掉match_keys字段，上传仅包含event_name、event_time、action_source的测试事件，这类未匹配事件会更快出现在界面，可用来验证流程是否通畅。

若以上步骤无效 #

如果排查后72小时仍无数据，可能是平台临时处理延迟；超过7天还没记录的话，可提交Facebook支持工单，提供upload_tag、请求ID和响应内容，让官方排查是否存在后台问题。

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