从UA迁移至GA4后，无法在GA4仪表盘接收事件的技术求助

GA4 和 Universal Analytics（UA）使用完全不同的 Measurement Protocol，不能直接替换跟踪ID就复用UA的脚本。UA基于v1版本协议，GA4则采用v2版本，两者的请求端点、参数结构、数据格式均存在差异。

1. 获取GA4的API密钥 #

先在GA4后台生成API密钥：

• 进入GA4管理界面 → 数据数据流 → 选择目标数据流
• 找到「Measurement Protocol API 密钥」→ 点击「创建」，生成后保存该密钥（记为API_SECRET）

2. 修改Python脚本适配GA4 #

替换你的MEASUREMENT_ID和API_SECRET后，使用以下脚本：

import requests

MEASUREMENT_ID = 'G-XYZ'
API_SECRET = '你的API密钥'
CLIENT_ID = '555'

# GA4事件配置：事件名称对应原UA的event_action，参数保留原分类和标签
payload = {
    "client_id": CLIENT_ID,
    "events": [
        {
            "name": "play",  # 对应原UA的event_action
            "params": {
                "event_category": "video",  # 原UA的event_category
                "event_label": "holiday",   # 原UA的event_label
                "engagement_time_msec": "100"  # GA4推荐携带该参数确保事件被正常计入
            }
        }
    ]
}

# GA4的请求端点，需在URL中携带measurement_id和api_secret
url = f"https://www.google-analytics.com/mp/collect?measurement_id={MEASUREMENT_ID}&api_secret={API_SECRET}"
response = requests.post(url, json=payload)

if response.status_code in (200, 204):
    print('事件已成功发送至Google Analytics 4')
else:
    print(f'发送失败，状态码：{response.status_code}，响应内容：{response.text}')

关键变化说明 #

• 请求端点：从UA的https://www.google-analytics.com/collect改为GA4的https://www.google-analytics.com/mp/collect，且必须在URL中携带measurement_id和api_secret
• 数据格式：UA使用表单格式（data=payload），GA4要求JSON格式（json=payload）
• 参数结构：
  • 原UA的tid（跟踪ID）改为URL参数中的measurement_id
  • 原UA的cid（client_id）移至JSON payload内
  • 原UA的t=event、ec、ea、el改为GA4的events数组，每个事件包含name（对应原ea）和params（存储原ec、el等自定义参数）
• 状态码：GA4成功响应的状态码为200或204，而UA仅返回200

验证注意事项 #

• GA4数据存在1-5分钟延迟，可在「实时」报告中查看事件是否接收
• 确保client_id格式合规（可使用任意字符串，建议与前端保持一致格式）
• 若发送失败，查看响应内容中的错误提示，通常为参数错误或API密钥/测量ID无效

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