通过gtag.js设置GA4用户角色后自定义维度无数据如何解决？

GA4用户属性无数据排查修正方案 #

• 首先修正错误的上报代码：GA4的gtag API不存在gtag('send', 'user_properties')这种调用方式，用户属性不需要单独触发上报，会自动附加到调用之后发送的所有事件中，你写的这段send语句属于无效代码，不会产生任何作用。
• 调整用户属性的设置时机：你当前的代码顺序是先调用gtag('config')触发page_view事件，之后才设置用户属性，这会导致首次page_view事件不会携带你设置的role相关用户属性，只有后续触发的事件才会携带。建议直接把用户属性参数放到config的配置项中，确保首次事件就能携带属性，正确代码示例：

gtag('config', MEASUREMENT_ID, {
  user_id: String(user?.id || ''),
  user_properties: {
    role: String(user?.roles?.[0]?.key || ''),
    role_name: String(user?.roles?.[0]?.name || '')
  }
});
// 无需额外调用gtag('set', 'user_properties')和gtag('send', 'user_properties')

• 检查自定义维度的配置范围：你在GA4后台创建自定义维度时，维度范围必须选择「用户」，如果误选了「事件」范围，会导致上报的用户属性无法和维度匹配，自然不会显示数据。
• 确认数据同步状态：GA4自定义维度的数据存在最长48小时的延迟，只有维度创建成功之后上报的、携带了对应属性的事件才会被关联到维度中，历史数据不会回溯填充。如果刚创建完维度立刻查询，大概率会出现无数据的提示。
• 验证属性是否正常上报：你可以通过浏览器开发者工具的网络面板，过滤collect请求，查看请求参数中是否存在up.role、up.role_name字段，存在则说明属性已经正常上报，等待数据同步即可；如果不存在，需要检查代码中user?.roles[0]是否可能为undefined，导致属性值为空未被上报。

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