UA与GA4自定义维度无数据及自定义变量映射排查咨询

1. 调试自定义维度无数据的步骤 #

• 检查代码语法完整性：你的示例代码存在语法错误，缺少闭合的大括号和括号，正确写法应为：

  gtag('config', 'GA_XXXXXXXX', {'custom_map': {'dimension1': 'product_id'}});
  

  语法错误会直接导致custom_map配置不生效，务必确保代码结构完整。
• 匹配后台维度索引：后台配置的自定义维度索引（如「Dimension1」）必须和代码中的dimension1完全一致，注意GA对索引大小写敏感，Dimension1和dimension1会被识别为两个不同维度。
• 验证数据上报请求：通过开发者工具抓取GA的上报请求（UA为collect请求，GA4为mp/collect请求），查看请求参数中是否包含cd1（对应dimension1）及对应的product_id值。如果请求中无该参数，说明product_id变量未正确赋值，或在gtag('config')执行时变量不存在。
• 确认维度范围匹配：后台配置自定义维度时，需选择正确的范围（用户/会话/事件）。例如事件级维度需确保触发事件时该维度变量有效，会话级维度需在会话初始化时完成赋值。
• 排除数据延迟：GA新配置的维度通常有24-48小时的数据处理延迟，不要在部署后立即排查，等待数据同步后再验证。
• 区分UA与GA4配置差异：UA使用dimensionN作为自定义维度标识，GA4则需将事件参数映射为自定义维度。若同时部署两种实例，需确认gtag('config')中的跟踪ID（UA-XXXXXX-X对应UA，G-XXXXXX对应GA4）与后台配置的属性匹配，避免配置串位。

2. 用谷歌开发者工具查找自定义变量映射 #

• 打开开发者工具：按F12或右键页面选择「检查」，切换到Network标签页。
• 过滤GA请求：在Network的搜索框输入collect（UA）或mp/collect（GA4），筛选出GA的上报请求。
• 查看请求参数：点击目标请求，切换到Payload（或Query String Parameters）标签：
  • UA中，自定义维度对应cdN参数（如cd1对应dimension1），旧版自定义变量可能出现在utmv参数中；
  • GA4中，自定义参数会包含在params字段内，通过custom_map映射的维度可关联到对应的事件参数。
• 查看gtag内部配置：在Console标签页输入以下命令（替换为你的跟踪ID），直接查看当前custom_map的映射关系：

  window.gtag('get', 'GA_XXXXXXXX', 'custom_map')
  

• 验证变量取值：在Console中直接输入变量名（如product_id），查看变量是否存在并持有预期值，确认变量在GA请求发送时已完成赋值。

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