从UA迁移至GA4后自定义维度无数据，求问题排查

问题重现 #

近期将应用从UA迁移至GA4，在母版页_layout.cshtml中通过gtag.js配置自定义维度，预期所有继承该母版页的页面事件都能携带自定义维度数据，但GA4控制台中事件的自定义维度均显示“(not set)”。

母版页配置代码：

<script async src='https://www.googletagmanager.com/gtag/js?id=<my gtag id>'></script>
<script type="text/javascript">
window.dataLayer=window.dataLayer || [];
function gtag() { dataLayer.push(argumnts);}
gtag('js', new Date());
gtag('config', '<my gtag id>');
gtag('set', {'dimension1':'getUserId()'});
gtag('set', {'dimension2':'getUserName()'});
gtag('event', 'page_view');
</script>

页面点击事件代码：

scope.onclickAction= function(){
gtag('event', 'click'{
'event_category': 'myEventCategory',
'event_label': 'an event label',
'event_value': <some int value>
});
}

错误点分析与修正 #

1. 语法错误导致gtag函数失效 #

• 问题：function gtag() { dataLayer.push(argumnts);}中argumnts是拼写错误，应为arguments，这会直接导致gtag无法正常向dataLayer推送数据。
• 修正：

function gtag() { dataLayer.push(arguments);}

2. 函数调用错误，传递字符串而非函数返回值 #

• 问题：gtag('set', {'dimension1':'getUserId()'});中，'getUserId()'是字符串字面量，未实际调用函数获取用户ID，导致维度值为无效内容。
• 修正：去掉引号，直接调用函数获取返回值：

gtag('set', {'dimension1': getUserId()});
gtag('set', {'dimension2': getUserName()});

3. GA4自定义维度配置逻辑与UA不兼容 #

• 问题：UA中的dimension1/dimension2命名规则在GA4中不适用，GA4需要先在后台配置自定义维度，绑定对应的参数名（而非直接使用dimensionN）。
• 操作步骤：
  • 登录GA4后台，进入管理 > 自定义定义 > 自定义维度
  • 点击“创建自定义维度”，设置维度名称（如用户ID），选择参数范围（用户/事件），填写参数名（如user_id）
  • 代码中对应修改为：

    gtag('set', {'user_id': getUserId()});
    gtag('set', {'user_name': getUserName()});
    

4. 点击事件的语法错误与GA4参数规范 #

• 问题：gtag('event', 'click'{缺少逗号，且event_category/event_label是UA专属参数，GA4需使用自定义参数或适配GA4的事件规范。
• 修正：

scope.onclickAction = function(){
  gtag('event', 'click', {
    'event_category': 'myEventCategory', // 若需保留该参数，需在GA4后台将其绑定到自定义维度
    'event_label': 'an event label',
    'event_value': <some int value>
  });
}

5. 确保函数返回有效值 #

需确认getUserId()和getUserName()在执行gtag('set')时已能返回有效值（比如用户已完成登录），若函数返回undefined也会导致维度显示“(not set)”。

验证步骤 #

1. 修复代码后，使用浏览器开发者工具的Network面板，查看发送到www.google-analytics.com/g/collect的请求，检查请求参数中是否包含自定义维度对应的参数值。
2. GA4数据存在延迟，建议等待1-2小时后再查看报告数据。

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