Google Analytics gtag发送自定义维度异常：environment无数据求助

我来帮你一步步分析这个问题！首先可以明确的是：Google Analytics（UA）对字符串/URL类型的自定义维度并没有禁止性限制，所以大概率是长度超限、参数传递或配置细节出了问题，我们逐一排查：

1. 优先排查URL长度是否超过UA的限制 #

Universal Analytics中，hit级别的自定义维度最大允许255字节的内容（注意是字节，不是字符，比如含中文/特殊字符的URL会占用更多字节）。如果你的env.baseurl长度超过这个阈值，GA会直接丢弃这个维度值，导致报表无数据。

验证方法： #

临时把事件里的environment值换成短字符串测试，比如：

gtag('event', 'analytics', {'client_id': env.client_id, 'environment': 'test-url'});

如果测试后报表能正常显示这个短字符串，那就是原URL长度超限的问题。解决思路是对URL进行截断处理，或者提取关键部分（比如只保留域名/环境标识，如prod/staging）。

2. 用调试工具确认hit是否携带了dimension2的值 #

安装Chrome的「Google Analytics Debugger」插件，启用后刷新页面，打开浏览器控制台（F12），找到类似send hit type: event的日志，查看其中的cd2字段（dimension2在UA中对应cd2参数）：

• 如果cd2完全不存在：说明自定义维度的映射或参数传递有问题
• 如果cd2存在但值为空/错误：检查env.baseurl的取值时机是否正确（比如是否在gtag事件发送前就已赋值）
• 如果cd2存在但值被截断：回到第一步的长度问题

3. 检查参数名是否存在隐性冲突 #

虽然environment不是UA的内置参数，但极少数情况下，某些命名可能和第三方插件/GTAG的内部逻辑产生冲突。可以尝试临时修改参数名和映射关系测试：

// 修改custom_map
gtag('config', 'GTAG-UA', { 'custom_map': { 'dimension1': 'client_id', 'dimension2': 'env_type' } });
// 修改事件参数
gtag('event', 'analytics', {'client_id': env.client_id, 'env_type': env.baseurl});

如果修改后能正常上报，说明原参数名存在冲突。

4. 再次确认GA后台的自定义维度配置 #

别忽略最基础的检查：

• 登录GA后台，确认dimension2的作用域确实是「Hit」（和dimension1一致）
• 确认维度状态是「激活」
• 确认维度的索引是2（代码里写的是dimension2，对应后台的索引必须匹配）

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