如何通过GA4 Measurement Protocol发送事件时设置设备类别信息？

GA4 的 Measurement Protocol 不支持通过 URL 的 GET 参数传递 User-Agent，必须把设备相关信息放在请求的 JSON 负载中，而非 URL 参数里。以下是两种可行的解决方法：

方法1：直接指定设备类别 #

在事件的 JSON 体中加入 device 对象，通过 category 字段明确设置设备类型，可选值为 mobile、desktop 或 tablet：

{
  "client_id": "你的客户端ID",
  "events": [
    {
      "name": "purchase",
      "params": {
        "transaction_id": "T12345",
        "value": 99.99,
        "currency": "USD"
        // 其他电商事件参数
      }
    }
  ],
  "device": {
    "category": "mobile"
  }
}

方法2：传递 User-Agent 让 GA4 自动解析 #

如果不想硬编码设备类别，可在 device 对象中加入 user_agent 字段，GA4 会根据该字段的值自动识别设备类别：

{
  "client_id": "你的客户端ID",
  "events": [
    {
      "name": "purchase",
      "params": {
        "transaction_id": "T12345",
        "value": 99.99,
        "currency": "USD"
        // 其他电商事件参数
      }
    }
  ],
  "device": {
    "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1"
  }
}

注意事项 #

• 请求必须使用 POST 方法，设备字段仅能在 POST 请求的 JSON 体中生效（GA4 虽支持 GET 请求，但不适合传递复杂负载）
• client_id 为必填项，需保证每个用户/设备的唯一性
• URL 中的 ua 这类 GET 参数不会被 GA4 的 Measurement Protocol 识别，无需添加

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