Google Analytics 4自定义维度未记录数据，求排查遗漏配置

问题描述 #

我通过以下代码配置Google Analytics以采集自定义维度：

<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXX"></script>
<script>
    window.dataLayer = window.dataLayer || [];
    function gtag() { dataLayer.push(arguments); }
    gtag('js', new Date());


    // Set custom dimensions for user ID and unit ID
    gtag('set', { 'user_id': @authorizationService.UserId });
    // Retrieve unit ID from the cookie and set as a custom dimension
    var unitId = parseInt(getCookieValue('UnitFilter'));
    if (!isNaN(unitId)) {
        gtag('set', { 'unit_id': unitId });
    }
    gtag('config', 'G-XXX');

    function getCookieValue(name) {
        var value = "; " + document.cookie;
        var parts = value.split("; " + name + "=");
        if (parts.length == 2) {
            return parts.pop().split(";").shift();
        }
    }
</script>

随后按以下步骤在Google Analytics中添加自定义维度：

1. 登录Google Analytics；
2. 点击“Admin”，进入目标属性；
3. 在“PROPERTY”栏中点击“Custom Definitions > Custom Dimensions”；
4. 点击“New Custom Dimension”；
5. 添加名称为“unit id”；
6. 选择范围为“user”；
7. 点击保存。

配置完成已超过48小时，但“unit id”维度仍显示无可用数据且无法点击，请问遗漏了哪些配置？

遗漏的关键配置点 #

1. 代码未关联自定义维度的索引ID #

在GA后台创建自定义维度后，系统会为每个维度分配一个索引ID（如dimension1、dimension2），代码中必须使用这个索引ID来对应后台的维度，而非自定义的unit_id名称。

修正方式：

• 回到GA后台的自定义维度列表，找到“unit id”对应的索引（比如显示为「Dimension 1」）
• 将代码中的gtag('set', { 'unit_id': unitId });替换为gtag('set', { 'dimension1': unitId });（把dimension1换成实际的索引ID）

2. 未启用User ID功能 #

代码中设置了user_id，但如果GA后台未启用User ID功能，会影响用户范围维度的数据采集：

• 进入GA后台Admin面板，在PROPERTY栏点击User ID
• 按照向导完成User ID功能的启用配置，确保与代码中的user_id采集逻辑一致

3. Cookie读取逻辑可能存在问题 #

• 在浏览器控制台执行getCookieValue('UnitFilter')，确认该Cookie存在且返回有效数值
• 检查Cookie的作用域（域名、路径），确保当前页面能正常读取到UnitFilter Cookie

4. 未验证数据发送是否正常 #

• 打开浏览器开发者工具的Network标签，过滤collect请求，查看发送到www.google-analytics.com/g/collect的请求参数中，是否包含对应维度索引（如dimension1）及正确值
• 查看GA的实时报告（Realtime > Overview），确认是否有携带自定义维度的会话数据（实时报告可快速验证数据是否成功发送）

5. 维度范围与采集逻辑不匹配 #

你设置的维度范围是「user」，需确保unit_id是用户级别的固定属性（如用户绑定的永久单元ID）。如果UnitFilter是会话内临时选择的筛选值，需将维度范围调整为「session」，避免数据不匹配导致无法统计

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