如何通过Python获取Google Analytics 4的商品范围维度字段？

商品级自定义维度和用户/事件级维度的调用逻辑不一样，你得用GA4 API里的items.前缀+参数名格式来引用，下面是具体实现步骤：

1. 确认维度的正确引用格式 #

在GA4中，商品范围的参数属于事件里的items嵌套对象，所以不能直接写CustomItem:x_id，必须写成items.CustomItem:x_id，API才能识别这是商品级维度。

2. 用Python的Google Analytics Data API实现 #

首先安装官方库：

pip install google-analytics-data

然后编写代码（用服务账号认证，记得替换你的配置信息）：

from google.analytics.data_v1beta import BetaAnalyticsDataClient
from google.analytics.data_v1beta.types import (
    DateRange,
    Dimension,
    Metric,
    RunReportRequest,
)

# 初始化客户端（替换为你的服务账号密钥路径）
client = BetaAnalyticsDataClient.from_service_account_json("path/to/your/service-account-key.json")

# 构造请求
request = RunReportRequest(
    property="properties/你的GA4媒体资源ID",
    date_ranges=[DateRange(start_date="2024-01-01", end_date="today")],
    dimensions=[Dimension(name="items.CustomItem:x_id")],
    metrics=[Metric(name="itemQuantity")],  # 搭配商品级指标确保返回有效数据
)

# 调用API并处理响应
response = client.run_report(request)

# 打印结果
for row in response.rows:
    print(f"CustomItem:x_id: {row.dimension_values[0].value}, 商品数量: {row.metric_values[0].value}")

3. 排查要点 #

• 先去GA4后台确认CustomItem:x_id确实配置为商品级自定义参数（不是事件级）
• 检查代码里的维度名称拼写完全一致，GA4参数名区分大小写
• 确保你的服务账号已添加到GA4媒体资源用户列表，且拥有读取权限

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