广告层级指标聚合与账户层级指标不符问题排查求助

1. 先修复脚本的致命缩进错误 #

你的复现脚本存在缩进错误，导致仅能获取最后一页的分页数据，聚合时自然会和账户层级数据不符。修正后的脚本如下：

from typing import Dict, Any
import requests

def fetch_meta_insights(
    access_token: str,
    entity_id: str,
    level: str,
    fields: str,
    date_preset: str = "last_30d",
) -> Dict[str, Any]:

    url = f"https://graph.facebook.com/v23.0/{entity_id}/insights"

    params = {
        "access_token": access_token,
        "level": level,
        "fields": fields,
        "date_preset": date_preset,
    }

    all_data = []

    while url:
        response = requests.get(url, params=params)
        response.raise_for_status()
        # 以下代码需缩进至while循环内部，确保每一页数据都被处理
        data = response.json()
        all_data.extend(data.get("data", []))
        url = data.get("paging", {}).get("next")
        params = {}

    return {"data": all_data}

原脚本中data = response.json()及后续逻辑在while循环外，只会执行一次，导致all_data仅包含最后一页的广告数据，而非全部广告数据，这是聚合结果不符的核心原因之一。

2. 确保查询参数的完全一致性 #

即使脚本修复后，仍需保证广告层级查询与账户层级查询的所有参数完全一致，否则会出现数据差异：

• 必须统一的核心参数：
  • action_attribution_windows：两端必须设置相同的归因窗口，比如都设为['7d_click']
  • action_report_time：统一为"conversion"或"impression"，两端保持一致
  • use_unified_attribution_setting：两端设置相同的布尔值
  • time_increment：如果广告层级用了按天拆分（time_increment=1），账户层级也必须用相同的时间增量，否则本地聚合时需按日期维度先聚合再求和，避免跨日期的重复计算
  • filtering：如果广告层级加了过滤条件（比如过滤特定广告状态），账户层级必须加完全相同的过滤规则
  • breakdowns/action_breakdowns：如果广告层级请求了拆分维度（比如按action_type、device拆分），本地聚合时必须先按相同维度分组求和，再向上聚合；或者两端都不使用拆分参数，确保原始数据的颗粒度一致

3. 其他可能的差异点 #

• 删除的广告/广告组：默认情况下，Meta API可能不会返回已删除的实体数据，可添加include_deleted=True参数，确保广告层级数据包含所有历史实体，避免遗漏数据
• 数据延迟与缓存：Meta Insights数据存在延迟，建议在相同时间点发起两类查询，避免因数据更新导致的差异
• 采样差异：虽然Impressions、Purchases这类指标通常不会采样，但如果账户数据量极大，账户层级查询可能触发采样，而广告层级因单条数据量小未触发。可添加limit=0参数强制不采样（需确保权限允许）

总结 #

优先修复脚本的缩进错误，再严格对齐两类查询的所有参数，基本就能解决聚合数据与直接账户层级数据不符的问题，同时满足你“单请求拉取广告层级数据后本地聚合”的需求。

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