如何通过API获取Google Analytics User Explorer数据？

你提到的Analytics Data API并非只能返回聚合数据，只要正确构造请求参数，就能获取到用户探索（User Explorer）对应的单用户明细数据，以下是具体实现步骤（基于GA4，UA已停止服务，不再赘述）：

前置准备 #

• 确保GA4媒体资源已启用User ID功能（若需使用自定义用户标识）；若未启用，可使用GA4自动生成的user_pseudo_id作为用户唯一标识。
• 已完成Analytics Data API v1的授权配置（服务账号或OAuth 2.0），确保拥有对应GA4媒体资源的读取权限。

核心请求配置 #

使用API的runReport方法，通过指定用户级维度、事件/属性维度及过滤条件，获取单用户或批量用户的明细数据：

关键参数说明 #

• 维度：必须包含user_id或user_pseudo_id作为用户唯一标识，同时可添加用户属性维度（如user_first_touch_timestamp、user_ltv）、行为事件维度（如event_name、page_title、event_timestamp）。
• 指标：可选择用户级指标（如user_engagement_duration、sessions）或事件级指标（如event_count）。
• 过滤条件：若需获取特定用户数据，添加dimensionFilter指定目标user_id或user_pseudo_id。
• 分页与限制：单次请求最大返回100000条数据，超过时需使用nextPageToken进行分页查询。

请求示例（JSON格式） #

{
  "entity": {
    "propertyId": "你的GA4媒体资源ID"
  },
  "dimensions": [
    {"name": "user_id"},
    {"name": "user_first_touch_timestamp"},
    {"name": "event_name"},
    {"name": "page_title"},
    {"name": "event_timestamp"}
  ],
  "metrics": [
    {"name": "user_engagement_duration"},
    {"name": "event_count"}
  ],
  "dimensionFilter": {
    "filter": {
      "fieldName": "user_id",
      "stringFilter": {
        "matchType": "EXACT",
        "value": "目标用户ID"
      }
    }
  },
  "limit": "1000"
}

注意事项 #

• 若未启用User ID，替换user_id为user_pseudo_id即可，该字段由GA4自动生成，唯一标识每个用户。
• 部分用户级指标（如user_ltv）需在GA4后台启用对应功能后才能获取。
• 返回数据会按用户+事件拆分，若需聚合单个用户的整体数据，可在客户端对同一user_id的记录进行汇总。

内容的提问来源于stack exchange，提问作者hiển vũ