Google Analytics Reporting v4数据流替代视图后Ruby代码适配问题

你现在遇到的核心问题是：新创建的GA4属性不再使用UA（通用分析）的Views概念，而是采用Data Streams，但你原代码依赖的是针对UA的Analytics Reporting API v4，该API不支持GA4的Data Streams。要适配GA4，必须切换到专门针对GA4的Google Analytics Data API v1。

关键调整点 #

• 更换API依赖：从UA的Analytics Reporting API v4切换到GA4的Analytics Data API v1
• 请求核心标识：用GA4的Property ID（格式为properties/XXXXXX）替代UA的View ID
• 指标维度映射：GA4的指标、维度命名规则与UA不同，需对应替换
• 特定流筛选：若需获取单一Data Stream的数据，通过维度过滤实现，而非直接指定stream_id参数

适配后的Ruby代码示例 #

# GA4 Property ID，格式为 properties/你的属性ID（可在GA4后台查看）
PROPERTY_ID = "properties/123456789"
SCOPE = 'https://www.googleapis.com/auth/analytics.readonly'

# 初始化GA4 Data API客户端
client = Google::Apis::AnalyticsdataV1::AnalyticsDataService.new

# 服务账号认证逻辑（与原代码一致）
@creds = Google::Apis::ServiceAccountCredentials.make_creds(
  json_key_io: File.open('account.json'),
  scope: SCOPE
)
@creds.sub = "myserviceaccount@example.iam.gserviceaccount.com"
client.authorization = @creds

# 构建GA4报告请求
request = Google::Apis::AnalyticsdataV1::RunReportRequest.new(
  # 日期范围
  date_ranges: [
    Google::Apis::AnalyticsdataV1::DateRange.new(
      start_date: start_date,
      end_date: end_date
    )
  ],
  # 指标：对应UA的ga:pageviews和ga:uniquePageviews
  metrics: [
    Google::Apis::AnalyticsdataV1::Metric.new(name: "screenPageViews"),
    Google::Apis::AnalyticsdataV1::Metric.new(name: "uniqueScreenPageViews")
  ],
  # 维度：对应UA的ga:hostname
  dimensions: [
    Google::Apis::AnalyticsdataV1::Dimension.new(name: "hostName")
  ],
  # 排序规则：按页面浏览量降序
  order_bys: [
    Google::Apis::AnalyticsdataV1::OrderBy.new(
      desc: true,
      metric: Google::Apis::AnalyticsdataV1::OrderBy::MetricOrderBy.new(metric_name: "screenPageViews")
    )
  ]
)

# 可选：筛选特定Data Stream的数据（取消注释启用）
# request.dimension_filter = Google::Apis::AnalyticsdataV1::FilterExpression.new(
#   filter: Google::Apis::AnalyticsdataV1::Filter.new(
#     field_name: "streamId",
#     string_filter: Google::Apis::AnalyticsdataV1::Filter::StringFilter.new(
#       match_type: "EXACT",
#       value: "你的Data Stream ID"
#     )
#   )
# )

# 发送请求并获取响应
response = client.run_report(PROPERTY_ID, request)

补充说明 #

• GA4的指标、维度名称与UA不兼容，比如ga:pageviews对应GA4的screenPageViews，ga:uniquePageviews对应uniqueScreenPageViews，可在GA4后台的指标维度资源库中查询完整对应关系。
• GA4报告默认返回整个属性下所有Data Streams的汇总数据，若需单一流的数据，通过上述代码中的维度过滤即可实现，无需修改顶级请求参数。

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