GA4/GTM调试中自定义JS事件始终返回undefined，求排查思路

问题描述 #

我在GA4/GTM的自定义JavaScript变量中尝试了多种脚本，从简单的"hello world"到复杂的页面加载时间获取脚本，示例代码如下：

function() {
if (window.performance && window.performance.getEntriesByType) {
    var entries = window.performance.getEntriesByType("navigation");
    if (entries.length > 0) {
        var navTiming = entries[0];
        var pageLoadTime = navTiming.loadEventEnd - navTiming.startTime;
    return Math.round(((pageLoadTime / 1000) + Number.EPSILON) * 100) / 100;
    }
}
}

但在预览测试时，该变量始终返回undefined。已确认：

• 触发器设置为全页面触发
• 控制台直接执行性能相关代码可正常获取结果
• 网络请求无异常，无404或脚本阻塞提示
  怀疑是GA4配置问题，寻求排查建议。

排查步骤 #

• 调整变量执行时机：GTM默认的"全页面"触发器是DOM就绪状态，此时loadEventEnd可能还未完成赋值。将触发器改为Window Loaded，确保页面完全加载后再执行变量脚本。
• 补全默认返回值：当前脚本仅在嵌套条件全部满足时返回值，任意条件不成立都会返回undefined。在脚本末尾添加默认返回值（比如return 0;），先验证变量能否正常返回默认值，再逐步排查条件逻辑。
• 确认变量类型：检查你创建的是自定义JavaScript变量，而非自定义HTML或其他类型。变量类型错误会直接导致逻辑失效。
• 利用GTM预览调试：在GTM预览界面的「变量」标签中，找到目标自定义JS变量，查看实时执行日志。日志会显示哪一步判断失败（比如entries.length为0、window.performance未被识别等）。
• 排查容器加载顺序：若GTM容器为异步加载，可能在window.performance数据未初始化时就执行了变量。可尝试将GTM代码移至<body>末尾，或在变量脚本中添加延迟执行逻辑（如setTimeout包裹核心代码，测试延迟1000ms后能否获取值）。
• 简化脚本定位问题：先使用极简脚本测试变量可用性：

  function() {
    return window.performance ? 'performance已就绪' : 'performance未加载';
  }
  

  逐步恢复原逻辑，定位哪一步导致返回undefined。
• 验证GA4关联配置：检查GA4测量ID是否正确关联到GTM的GA4配置标签，确保变量值能正确传递到事件参数中（此为补充排查项，不会直接导致变量返回undefined）。

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