如何通过GA4测量协议发送页面浏览位置、来源、IP及用户代理？

API 探路者

2026-7-23

GA4 Measurement Protocol 迁移踩坑解决

对应你要传的数据，GA4需要用这些参数

访问页面URL：填 page_location，属于page_view事件的核心参数
用户代理：直接传 user_agent，GA4会自动解析成设备信息
推荐URL：用 page_referrer 参数
用户IP：GA4默认会从请求的源IP解析地理位置，要是需要手动指定（比如服务器转发用户真实IP），就加 ip_override 参数

完整请求示例（POST）

请求地址是 https://www.google-analytics.com/mp/collect，必须带api_secret（GA4后台数据流设置里获取）和measurement_id（数据流ID）作为URL参数。

JSON请求体示例：

{
  "client_id": "xxxx.xxxx", // 必须传，用来关联用户和会话
  "events": [
    {
      "name": "page_view", // 别发自定义事件，用官方page_view才能统计默认指标
      "params": {
        "page_location": "https://your-site.com/your-page",
        "page_referrer": "https://referrer-site.com",
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36"
      }
    }
  ]
}