GA4 Data API筛选用户自定义维度为何排除注册前历史数据？

核心结论 #

这是GA4 Data API的预期行为，和Query Explorer的表现一致；GA UI的Explore板块是做了额外的前端补全处理，会把该维度注册前的无值历史数据标记为(not set)并纳入统计，而原生API默认会过滤掉这些无匹配维度值的记录。

实现目标效果的方法 #

要在API中获取和Explore一致的包含(not set)数据的报表，需要调整筛选逻辑：

• 不要仅用dimensionFilter筛选目标维度的有效值，而是通过OR逻辑同时包含维度值未设置的情况
• 具体可在筛选表达式中组合两个条件：
  1. 匹配你需要的目标维度值
  2. 匹配该维度值为null的记录

以下是伪代码示例：

{
  "dimensions": [{"name": "你的自定义用户维度名"}],
  "metrics": [{"name": "activeUsers"}],
  "dateRanges": [{"startDate": "2023-01-01", "endDate": "today"}],
  "dimensionFilter": {
    "orGroup": {
      "expressions": [
        {
          "filter": {
            "fieldName": "你的自定义用户维度名",
            "stringFilter": {
              "matchType": "EXACT",
              "value": "你要筛选的目标值"
            }
          }
        },
        {
          "filter": {
            "fieldName": "你的自定义用户维度名",
            "nullFilter": {}
          }
        }
      ]
    }
  }
}

补充说明 #

GA UI的Explore之所以能自动展示(not set)，是因为它在后台对API返回的原始结果做了二次处理——把缺失维度值的记录统一标记为(not set)，而原生API不会自动执行这个转换；Query Explorer作为API的直接调试工具，完全遵循API的原生规则，所以和你自行调用API的结果一致。

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