如何通过GA4 Measurement Protocol填充Tech Overview数据

你传自定义UA不生效的核心原因是：GA4 Measurement Protocol内置的UA解析规则仅覆盖网页、安卓、iOS端的标准UA格式，Roku这类自定义格式的UA不在匹配范围内，不会自动解析映射到技术概览的各个维度。所有技术类维度必须手动传GA4预留的保留参数，才能正常填充报表数据。

技术概览里的5个核心指标，全部对应GA4的固定保留参数，直接在事件的params字段中传值即可，不需要额外配置：

• 各平台用户数（Users by Platform）：传参数platform，Roku场景固定填roku
• 各操作系统用户数（Users by Operating System）：传参数os填操作系统名（值为Roku），搭配os_version参数传具体系统版本，比如你示例里的11.0.0.4184-AE
• 各设备类别用户数（Users by Device Category）：传参数device_category，Roku属于大屏电视端，固定填枚举值tv
• 各应用版本用户数（Users by App version）：传参数app_version，值填你当前上架的Roku应用版本号，比如2.1.0
• 各设备型号用户数（Users by Device Model）：传参数device_model，值填Roku设备的具体型号，比如Roku Streaming Stick 4K

你的请求头、查询参数格式不需要改动，ua查询参数可以保留但不需要依赖它做维度解析，核心是补全事件参数里的保留字段，同时修正你之前client_id的生成逻辑：

{
    "client_id": "为每个设备生成的固定唯一ID，需要本地持久化存储，同设备多次请求保持一致，禁止每次请求随机生成",
    "user_id": "设备侧生成的用户唯一标识",
    "non_personalized_ads": false,
    "user_properties": {
        "device_id": {
            "value": "设备唯一标识，可与user_id保持一致"
        }
    },
    "events": [
        {
            "name": "custom_event1",
            "params": {
                "engagement_time_msec": "1",
                "session_id": "会话级唯一ID，同一会话内所有事件共用该值",
                "platform": "roku",
                "os": "Roku",
                "os_version": "11.0.0.4184-AE",
                "device_category": "tv",
                "app_version": "替换为你的Roku应用实际版本号",
                "device_model": "替换为当前设备的实际Roku型号",
                "param1": "xyz"
            }
        }
    ]
}

• 上述参数名必须严格和GA4保留字段名完全一致，自定义命名的参数不会自动同步到技术概览报表
• client_id绝对不能每次请求随机生成，否则会导致用户数严重虚高，所有技术维度的统计都会失准
• device_category必须传GA4支持的固定枚举值：desktop/mobile/tablet/tv，传自定义值不会被正确归类
• 数据上报后不会立刻在标准报表中展示，GA4的数据处理延迟通常为24-48小时，可先通过实时报表验证参数是否上报成功

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