GA4中如何通过JS正确发送用户范围自定义维度？

明确说：不需要依赖Google Tag Manager，纯gtag.js完全可以实现用户范围自定义维度的上报。你之前的问题大概率是配置细节没做对，下面是正确步骤和排查要点：

一、先确认GA4后台的维度配置 #

在GA4管理后台「自定义定义」→「自定义维度」里，必须确保：

• 维度名称是test_custom_dimension（和前端传的key完全一致）
• 范围选择「用户」
• 绑定的用户属性填test_custom_dimension（就是你前端要传递的参数名）

二、正确的gtag.js代码写法 #

场景1：页面加载时就拿到用户属性 #

初始化config时，要把用户属性嵌套在user_properties对象里，这是你之前漏掉的关键：

gtag('config', 'G-XXXXXXX', {
    send_page_view: false,
    user_id: userId,
    user_properties: {
        test_custom_dimension: 'true'
    }
});

场景2：后续动态获取用户属性 #

用set方法设置全局用户属性，之后所有上报的事件都会自动关联这个用户维度：

// 设置用户属性
gtag('set', 'user_properties', {
    test_custom_dimension: 'true'
});

// 比如发送自定义事件时，会自动带上该用户维度
gtag('event', 'user_action');

你之前的错误：直接把test_custom_dimension放在config的根对象里，GA4不会识别为用户属性，必须放在user_properties中。

三、验证数据是否上报成功 #

1. 实时报告：GA4后台「实时」→「用户属性」，查看是否有test_custom_dimension的数据（延迟1-2分钟）
2. 浏览器控制台：打开Network标签，找collect请求，检查参数里的up.test_custom_dimension是否存在且值正确
3. 用户探索：等1-2小时后，在「探索」里创建用户探索，添加自定义维度test_custom_dimension查看数据

四、常见问题排查 #

• 确保userId是有效非空值，用户范围维度依赖用户标识，匿名用户可能无法正确关联
• 不要重复多次调用config，除非是切换用户或更新属性时
• 刚创建的自定义维度需要10-15分钟才会开始接收数据

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