Python向Google Analytics上报服务端事件时如何设置setUserId

GA4服务端事件上报遵循统一的Measurement Protocol规范，没有单独针对Python设计专属的用户ID设置接口，只要按照协议要求在请求结构中传入对应字段即可，具体实现逻辑如下：

核心规则 #

• 用户ID对应请求体的顶层固定字段user_id，取值为业务侧自行生成的用户唯一标识字符串，注意不能传入手机号、邮箱明文等可直接识别个人身份的信息，否则不符合GA的数据收集规则
• user_id必须和client_id、events字段放在同一层级，不要嵌套在事件参数、用户属性层级中，否则无法被GA识别为全局用户维度标识，只会被当成普通自定义参数处理

代码实现 #

先安装HTTP请求依赖：

pip install requests

上报示例代码，直接在请求体顶层传入user_id即可完成设置：

import requests

# 替换为自身GA4配置项
MEASUREMENT_ID = "G-前缀的数据流ID"
API_SECRET = "GA4后台生成的Measurement Protocol接口密钥"
SET_USER_ID = "业务侧生成的唯一用户标识"
CLIENT_ID = "对应客户端的client_id值"

request_body = {
    "client_id": CLIENT_ID,
    "user_id": SET_USER_ID,  # 在此处传入用户ID即可完成设置
    "events": [
        {
            "name": "自定义事件名",
            "params": {
                "test_param": "test_value"
            }
        }
    ]
}

resp = requests.post(
    f"https://www.google-analytics.com/mp/collect?measurement_id={MEASUREMENT_ID}&api_secret={API_SECRET}",
    json=request_body
)
# 响应状态码为204即代表上报成功
print(resp.status_code)

注意事项 #

• 如果你使用第三方封装的GA4 Python上报SDK，只需要找到支持传入请求顶层自定义字段的入参位，传入user_id的对应值即可，底层逻辑和原生HTTP请求完全一致
• 禁止将user_id写入单个事件的params字段下，该操作无法实现全局用户ID的绑定效果
• 上报完成后可通过GA4后台的DebugView、实时报告校验字段是否正确上报，确认用户ID生效

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