如何将用户属性发送到测量协议（Google Analytics 4）？

Question

通过 Google Analytics 4 的测量协议，我们可以发送自定义事件（来源）。然而，通过Google Analytics， GA 会自动跟踪gtag.js几个预定义的用户维度。

该文档页面提到：

只要您使用 SDK 或 gtag.js，就无需编写额外的代码即可从您的移动应用和/或网站收集以下用户维度。

然而，我们如何使用测量协议收集这些用户维度（如语言、浏览器、国家/地区）？不幸的是，这没有记录在协议参考中。（我在其他地方也找不到这方面的信息。）

编辑

以下是我发送的 JSON 数据的示例：

{
    "client_id": "xxx",
    "timestamp_micros": 1666280202293304,
    "events": [
        {
            "name": "page_view",
            "params": {
                "event_source": "server",
                "page_location": "https://somedomain.com/page2",
                "page_referrer": "/page1",
                "page_title": "A test page",
                "ip_override": "xxx.xxx.xxx.0",
                "user_agent": "Mozilla/5.0 (Linux; Android 9; RMX1805) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.0.0 Mobile Safari/537.36",
                "debug_mode": false,
                "engagement_time_msec": 1,
                "session_id": "yyy"
            }
        }
    ],
    "user_properties": {
        "country": {
            "value": "US"
        },
        "device_category": {
            "value": "None"
        },
        "language": {
            "value": "en-us"
        },
        "platform": {
            "value": "web"
        }
    }
}

Answer 1

user_propertiesJos， GA4 测量协议有效负载中现在有一些语法文档。client_id它与定义并存events。

  const queryParams = `?measurement_id=${measurementId}&api_secret=${apiSecret}`;
  fetch(`https://www.google-analytics.com/mp/collect${queryParams}`, {
    method: "POST",
    body: JSON.stringify({
      "client_id": clientId,
      "user_properties": {
        "customer_tier": {
          "value": customerTier
        }
      },
      "events": JSON.parse(events)
    })
  });

https://developers.google.com/analytics/devguides/collection/protocol/ga4/user-properties?client_type=gtag#example_usage