Python中使用GA4 Admin API创建自定义维度的具体方法是什么？

前置准备 #

• 确保你已经安装了官方Python依赖包
  pip install google-analytics-admin
• 已经完成GA4 Admin API的鉴权配置，服务账号已绑定对应GA4财产的编辑权限

完整实现代码 #

from google.analytics.admin import AnalyticsAdminServiceClient
from google.analytics.admin_v1alpha.types import CustomDimension

def create_ga4_custom_dimension(property_id: str, display_name: str, parameter_name: str, scope: str = "EVENT") -> CustomDimension:
    """
    创建GA4自定义维度
    参数说明：
    property_id: GA4财产ID，格式为properties/123456789
    display_name: GA4界面中显示的自定义维度名称
    parameter_name: 事件/用户参数对应的名称，需和上报的参数名完全一致
    scope: 维度作用域，可选值为 EVENT、USER、ITEM
    """
    # 初始化API客户端
    client = AnalyticsAdminServiceClient()
    
    # 构造自定义维度配置参数
    custom_dimension = CustomDimension(
        display_name=display_name,
        parameter_name=parameter_name,
        scope=scope
    )
    
    # 调用创建接口
    response = client.create_custom_dimension(
        parent=property_id,
        custom_dimension=custom_dimension
    )
    
    print(f"自定义维度创建成功，资源标识：{response.name}")
    return response

# 调用示例
if __name__ == "__main__":
    # 替换为你自己的GA4财产ID
    PROPERTY_ID = "properties/替换为你的实际财产ID"
    create_ga4_custom_dimension(
        property_id=PROPERTY_ID,
        display_name="用户注册渠道",
        parameter_name="register_channel",
        scope="USER"
    )

常见注意事项 #

• 同一个GA4财产下，自定义维度的display_name和parameter_name都不能重复，否则会返回创建报错
• 自定义维度有配额限制：每个GA4财产默认最多支持50个事件级自定义维度、25个用户级自定义维度，超过配额无法创建
• 维度创建成功后，最长需要48小时才能在报告中看到对应数据，仅创建成功后新上报的对应参数会被该维度收录

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