使用Google Analytics Data API v1Beta时维度指标不兼容报错求助

问题根源 #

customEvent:institution_id属于事件级维度，而你使用的screenPageViews是页面/屏幕级指标。GA4的数据模型对维度和指标的层级兼容性有严格要求：事件级维度只能搭配事件级指标（如eventCount），页面级指标则需和页面级维度（如pagePathPlusQueryString）组合使用。近期API版本更新或GA4数据校验规则收紧，导致原本能通过的请求现在触发了兼容性报错。

快速修复方案 #

如果你的核心需求是统计符合过滤条件的页面浏览量，只需移除customEvent:institution_id维度即可——过滤器依然可以保留，因为过滤器不要求维度与指标必须兼容，只要该维度存在于数据中就能正常生效。

修改后的请求体 #

{
  "dateRanges": [
    {
      "startDate": "2022-08-29",
      "endDate": "2022-12-07"
    }
  ],
  "dimensions": [
    {
      "name": "pagePathPlusQueryString"
    }
  ],
  "dimensionFilter": {
    "andGroup": {
      "expressions": [
        {
          "filter": {
            "fieldName": "customEvent:institution_id",
            "inListFilter": {
              "values": [
                "47339486-a1e5-47be-abce-e4270af23rte"
              ]
            }
          }
        },
        {
          "filter": {
            "fieldName": "pagePathPlusQueryString",
            "stringFilter": {
              "matchType": "PARTIAL_REGEXP",
              "value": "/clip/.+",
              "caseSensitive": false
            }
          }
        }
      ]
    }
  },
  "metrics": [
    {
      "name": "screenPageViews"
    }
  ],
  "metricAggregations": [
    "TOTAL"
  ],
  "limit": "10000"
}

进阶方案（需按institution_id分组统计） #

如果必须按institution_id分组统计页面相关数据，需要改用事件级指标eventCount，同时确保screen_view事件中携带了institution_id自定义参数。调整后的请求如下：

{
  "dateRanges": [
    {
      "startDate": "2022-08-29",
      "endDate": "2022-12-07"
    }
  ],
  "dimensions": [
    {
      "name": "customEvent:institution_id"
    },
    {
      "name": "pagePathPlusQueryString"
    }
  ],
  "dimensionFilter": {
    "andGroup": {
      "expressions": [
        {
          "filter": {
            "fieldName": "customEvent:institution_id",
            "inListFilter": {
              "values": [
                "47339486-a1e5-47be-abce-e4270af23rte"
              ]
            }
          }
        },
        {
          "filter": {
            "fieldName": "pagePathPlusQueryString",
            "stringFilter": {
              "matchType": "PARTIAL_REGEXP",
              "value": "/clip/.+",
              "caseSensitive": false
            }
          }
        },
        {
          "filter": {
            "fieldName": "eventName",
            "inListFilter": {
              "values": ["screen_view"]
            }
          }
        }
      ]
    }
  },
  "metrics": [
    {
      "name": "eventCount"
    }
  ],
  "metricAggregations": [
    "TOTAL"
  ],
  "limit": "10000"
}

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