GA4自定义维度失效：gtag set()方法使用问题排查

问题原因 #

你当前的问题核心有两点：

• custom_map是UA（通用分析）时代的遗留配置项，GA4完全不需要，留着反而可能干扰参数传递逻辑；
• 用gtag("set")设置的全局参数，不会自动附加到自定义事件（比如你这里的Button click）上，只有GA4内置事件（如page_view）才会默认携带全局参数。

解决方法 #

下面给你三种可行的实现方式，按需选择：

方式1：设置为用户属性（推荐，适合用户级维度）

如果chain_id是每个用户的固定标识，把它设为用户属性，这样所有事件都会自动携带这个参数：

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

  // 设置用户属性，所有事件自动携带
  gtag("set", {
    user_properties: {
      chain_id: "Test chain id"
    }
  });

  gtag("config", "<my-ga-id>", {
    debug_mode: true
    // 删掉custom_map，GA4不需要该配置
  });
</script>

触发事件的代码无需修改，打开GA调试器就能看到事件的user_properties里包含chain_id。

方式2：触发事件时直接传递参数（适合事件级维度）

如果chain_id只需要在特定事件里携带，直接在事件调用时传入参数：

document.getElementById("another").addEventListener("click", function(event) {
  gtag("event", "Button click", {
    chain_id: "Test chain id"
  });
});

这种方式最直接，调试器里能直接看到事件参数列表中的chain_id。

方式3：全局参数自动附加到所有事件（进阶）

如果要让所有自定义事件都自动携带全局设置的chain_id，可以通过重写gtag函数实现：

<script>
  window.dataLayer = window.dataLayer || [];
  // 保存原始gtag函数
  const originalGtag = window.gtag;
  window.gtag = function() {
    const args = Array.from(arguments);
    // 判断是否为事件触发调用
    if (args[0] === "event") {
      // 追加全局参数
      args[2] = args[2] || {};
      args[2].chain_id = "Test chain id";
    }
    originalGtag.apply(window, args);
  };

  // 后续初始化代码不变
  gtag("js", new Date());
  gtag("config", "<my-ga-id>", { debug_mode: true });
</script>

额外注意事项 #

1. 不管用哪种方式，都需要在GA4后台配置自定义维度：将chain_id（用户属性选对应用户属性类型，事件参数选事件参数类型）映射到对应的自定义维度，才能在GA4报告中查看该维度的数据。
2. 用GA调试器验证时，查看Event Parameters（事件参数）或User Properties（用户属性）板块，而非单独的维度字段。

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