Google GA4 API添加totalUsers指标致返回行数骤变问题咨询

问题重现 #

未添加totalUsers时的请求：

{"dimensions":[{"name":"date"},{"name":"sessionCampaignName"},{"name":"sessionDefaultChannelGroup"}],"metrics":[{"name":"conversions"},{"name":"sessions"}],"dateRanges":[{"startDate":"2023-11-01","endDate":"today"}],"limit":"1000","keepEmptyRows":true}

返回126行数据。

添加totalUsers后的请求：

{"dimensions":[{"name":"date"},{"name":"sessionCampaignName"},{"name":"sessionDefaultChannelGroup"}],"metrics":[{"name":"conversions"},{"name":"sessions"},{"name":"totalUsers"}],"dateRanges":[{"startDate":"2023-11-01","endDate":"today"}],"limit":"1000","keepEmptyRows":true}

仅返回17行数据。

核心原因是指标层级不匹配导致的聚合逻辑变化：

• sessions和conversions属于会话级指标，这类指标基于每个独立会话统计，哪怕是匿名用户的会话（无明确用户标识的会话）也会被纳入统计。所以仅请求这两个指标时，API会返回所有符合维度组合（日期+推广活动+默认渠道分组）的会话记录，包括无法关联到具体用户的会话，行数自然更多。
• totalUsers是用户级指标，统计的是独立用户数，必须绑定具体的用户标识。当它与会话级指标混合请求时，GA4会自动切换到用户级的聚合规则，只保留能明确关联到用户的会话分组数据——大量匿名会话因无法匹配用户标识，对应的行被过滤，最终返回行数骤减。

额外说明：

• GA4指标分为用户级、会话级、事件级三个核心层级，混合不同层级指标时，会以最高层级的聚合逻辑为准，自动过滤不符合条件的低层级数据。
• 你设置的keepEmptyRows: true仅保留当前聚合逻辑下的空行（比如某维度组合无用户数据但符合规则的情况），并非保留所有原始会话的空行。

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