如何在VueJS应用中向Google Analytics 4传递自定义用户维度

问题根因 #

你遇到的自定义维度显示(not set)问题，主要由三个错误导致：

• GA4 不再支持旧版 UA 中dimensionX格式的直接传参方式，需要匹配你在 GA4 后台配置的自定义维度对应参数名
• 你仅将自定义维度绑定到了单次age_dimension事件上，Pages and Screens等报表依赖的page_view等自动上报事件未携带该参数
• 用户作用域维度需要全局持久化设置，单次事件临时传参无法覆盖全量上报数据

正确实现步骤 #

1. 确认GA4后台配置的参数名 #

首先确认你在GA4后台创建用户作用域自定义维度时，填写的事件参数字段名，后续上报需要完全匹配该字段名，不需要使用dimension2这类UA时代的标识。

2. 登录成功后全局设置用户维度 #

用户登录获取到用户属性后，调用set方法全局挂载维度，后续所有上报事件（包括自动触发的page_view、scroll等事件）都会自动携带该参数：

// 登录成功后执行，user_age替换为你GA4后台配置的事件参数名
this.$gtag.set({ user_age: 35 })
// 可同步设置用户ID关联用户数据
this.$gtag.set({ user_id: '当前登录用户的唯一标识' })

如果需要使用customMap方法做参数映射，正确写法如下：

// 先做映射：将业务代码中用的age参数，映射为GA4后台配置的user_age参数
this.$gtag.customMap({ 'age': 'user_age' })
// 全局设置业务参数
this.$gtag.set({ age: 35 })

3. 验证上报逻辑 #

打开浏览器控制台网络面板，筛选collect关键词，查看所有GA上报请求的参数中是否携带了你设置的自定义维度字段：

• 只要请求中已携带该字段，等待24-48小时报表数据同步完成后，(not set)的提示就会消失
• 实时报表仅展示部分事件数据，非实时报表的数据同步存在最长48小时的延迟，属于正常情况

内容的提问来源于stack exchange，提问作者Rohît Jíndal