调用Meta Marketing API获取Insights时遇错误码100(子码3699001)求助

问题背景 #

调用单个广告系列/广告组/广告的Insights端点 https://graph.facebook.com/v21.0/{entity_ids[i]}/insights 时，持续返回以下错误：

{
  "error": {
    "message": "Invalid parameter",
    "type": "OAuthException",
    "code": 100,
    "error_subcode": 3699001,
    "is_transient": false,
    "error_user_title": "Attribut indisponible",
    "error_user_msg": "Cet attribut n’est pas encore disponible pour vous",
    "fbtrace_id": "AoLUSTRB7wFmPwsBdr98xdN"
  }
}

已完成排查：

• 访问令牌拥有read_insights等全部所需权限
• 应用已上线且权限获批
• API版本及实体ID均正确
• 广告账号级Insights调用（/act_{ad_account_id}/insights）正常
• 其他企业广告账号可正常调用单个实体的Insights

1. 错误码100（子码3699001）的原因 #

这个错误的核心原因是目标实体的Insights数据尚未对当前访问主体开放，具体场景包括：

• 目标广告系列/组/广告是新创建的，Meta尚未完成数据聚合（通常需要1-24小时的处理周期，无投放行为的实体可能永远无法生成数据）
• 该实体从未产生任何投放行为（比如未启动投放、没有曝光/点击/转化等数据）
• 实体归属的商务管理平台（BM）存在权限隔离，虽然账号级权限正常，但单个实体的访问被限制
• 部分合规区域的账号或实体，数据处理流程有额外延迟，导致Insights数据无法及时开放

2. 是否与Meta数据可用性政策相关？ #

是的，这直接关联Meta的数据可用性政策：

• 新创建的广告实体（系列/组/广告）需要时间完成数据收集与聚合，在此期间无法通过单个实体端点获取Insights，但账号级的汇总数据可能提前可用
• 新注册的广告账号可能存在数据激活审核期，审核通过前单个实体的Insights访问会被限制，但账号级数据不受影响
• 如果实体无任何投放行为，Meta不会生成对应的Insights数据，会持续返回该错误

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