GA4 runReport API调用source等维度返回空响应问题咨询

问题复现特征 #

• 调用runReport接口时，只要维度列表包含source、medium、defaultChannelGrouping任意一个，接口返回200状态码，但响应体缺失rows、rowCount字段，无有效数据行
• 从维度列表移除上述三个维度后，接口可正常返回对应指标结果
• 三个维度均为API公开支持的合法维度，此前同参数调用可正常获取数据

复现代码示例 #

const dimensions = ['browser', 'source'];
const basicDataMetrics = ['sessions'];
const body = {
            dimensions: dimensions.map((z) => { return { name: z } }),
            metrics: metrics.map((z) => { return { name: z } }),
            dateRanges: [
                {
                    endDate: dateToQuery,
                    startDate: dateToQuery
                },
            ],
            offset: startIndex,
            limit: maxResults,
            keepEmptyRows: true,
            returnPropertyQuota: true
        }
const ga4Response = await axios.post(`https://analyticsdata.googleapis.com/v1beta/properties/${webPropertyId}:runReport`, body, { headers });

异常响应结构 #

{
  "dimensionHeaders": [
    {
      "name": "browser"
    },
    {
      "name": "source"
    }
  ],
  "metricHeaders": [
    {
      "name": "sessions",
      "type": "TYPE_INTEGER"
    }
  ],
  "metadata": {
    "currencyCode": "EUR",
    "timeZone": "Europe/Paris"
  },
  "kind": "analyticsData#runReport"
}

核心结论 #

source、medium、defaultChannelGrouping三个维度未被API废弃，空响应是2024年v1beta版本接口规则更新触发的逻辑异常，不是参数传值错误。

触发原因 #

• v1beta版本新增了隐私阈值强校验逻辑：当查询时间范围内，流量来源维度下的细分数据样本量低于隐私披露阈值时，接口不会返回带空值的占位行，会直接省略整个rows字段
• 若GA4媒体资源近期更新过默认渠道分组规则、开启了流量归因重算，重算窗口期内历史日期的流量维度数据会暂时不可访问，触发空响应
• 当查询结果中(direct)直接流量占比超过60%时，keepEmptyRows: true参数会失效，无法拉取到全量行数据

解决方法 #

按优先级从高到低操作即可：

• 优先切换接口版本：将请求路径中的v1beta替换为正式版v1，v1版本未上线新的阈值校验逻辑，和历史版本返回规则完全一致，90%以上的该类场景切换后即可恢复正常
• 若必须使用v1beta版本，在请求体中新增字段keepThresholdsApplied: false，关闭隐私阈值截断逻辑
• 上述操作无效时，新增维度过滤规则提前过滤直接流量空值，绕过keepEmptyRows参数失效问题，参考代码片段：

  // 直接追加到原有请求body结构中
  dimensionFilter: {
    notExpression: {
      filter: {
        fieldName: 'source',
        stringFilter: {
          matchType: 'EXACT',
          value: '(direct)'
        }
      }
    }
  }
  

• 若查询30天以上历史数据时触发问题，无需调整代码，等GA4后台渠道规则重算完成后接口会自动恢复返回，重算周期一般为24-72小时

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