如何在Google Analytics 4(GA4)中更新全局自定义用户属性？

问题原因及解决方案 #

1. 参数作用域和类型不匹配

你初始在gtag('config')中直接传入的test: false属于全局事件参数，会默认附加到后续所有事件中，不属于用户属性范畴。你用到的两种更新写法和初始参数不属于同一作用域，自然不会生效：

• gtag('set', 'user_properties', {test: true}) 是更新用户属性维度的test，和你之前的全局事件参数test是完全独立的两个字段，不会覆盖原来的事件参数值
• gtag('set', {test: true}) 属于通用全局参数更新写法，GA4的gtag存在已知行为：如果config调用时已经初始化了某个绑定测量ID的全局事件参数，后续直接用无测量ID的set命令不会覆盖对应测量ID的原有参数值

2. 正确的更新写法

如果你要更新原来的全局事件参数test，需要明确指定对应测量ID：

gtag('set', 'G-1234567890', {'test': true});

如果你打算改用用户属性来承载test字段，需要调整初始配置的参数结构：

// 初始配置写法
gtag('config', 'G-1234567890', {
  user_properties: {
    test: false
  }
});
// 后续更新用户属性写法
gtag('set', 'user_properties', {test: true});

3. 额外排查点

如果你是单页应用手动触发page_view事件，需要检查手动调用事件上报的代码里，是否硬编码传入了test: false，硬编码的事件参数优先级高于全局参数，会覆盖你更新后的值。
如果以上操作后网络请求里已经携带了更新后的参数，但GA4后台看不到对应数据，需要确认你已经在GA4后台的「自定义定义」模块注册了对应维度：事件级参数要注册为事件自定义维度，用户属性要注册为用户自定义维度，未注册的参数GA4不会做数据落地展示。

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