GTM自定义JS变量仅返回布尔值 其他类型及加ga.getAll()返回undefined问题

核心原因 #

• 执行时机不匹配：GTM自定义JS变量默认会在容器加载阶段同步执行，此时Universal Analytics（UA）的ga全局对象大概率还未完成初始化，直接调用ga.getAll()会抛出未定义引用错误，导致整个函数执行中断返回undefined。
• GA版本不兼容：如果你当前站点部署的是GA4而非老版本UA，全局对象默认是gtag而非ga，ga对象本身不存在，调用相关方法必然报错。
• 自定义全局对象命名：如果部署UA时修改了默认的全局对象名称，没有使用ga作为命名空间，也会出现调用失败的问题。

修复方案 #

在调用ga相关方法前必须先做存在性校验，避免报错中断函数执行，参考代码如下：

function() {
  // 先校验ga对象是否存在且为可调用的函数
  if (typeof window.ga === 'function') {
    var trackers = ga.getAll();
    // 补充你自己的业务逻辑，比如返回第一个跟踪器的ID
    if (trackers.length > 0) {
      return trackers[0].get('trackingId');
    }
    // 无有效跟踪器时返回预设默认值
    return 'no_available_tracker';
  }
  // ga未初始化完成时返回预设默认值，避免返回undefined
  return 'ga_not_ready';
}

额外适配说明 #

如果使用GA4，不存在ga.getAll()的等价原生方法，若需要获取GA4测量ID，可以直接调用GTM内置的「GA4测量ID」变量，无需手动调用全局对象获取。

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