GA4自定义事件无法记录问题求助及调试方法咨询

我通过Tag Manager将GA4添加到网站，代码如下：

<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
</script>
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-XXXX1234');</script>
<!-- End Google Tag Manager -->

他人建议前四行是触发GA4自定义事件的必要代码，我的自定义事件调用如下（位于某个执行无错误的函数内）：

gtag('event', 'my_event', {
    'event_date': document.getElementById('date').value,
    'param1': 'false',
    'param2': 3,
    'param3': thing.is_done? 'correct' : 'incorrect'
}); 

目前遇到的问题：

• 浏览器调试器中看不到该事件向谷歌发起的请求（是否应该看到？）
• GA4实时报告中找不到该事件，但page_view、session_start等默认事件能正常接收

请问该如何调试这个问题？

调试步骤与排查方向 #

• 检查GTM的事件转发配置
  你用gtag()只是把事件推送到了dataLayer，但GTM需要配置对应的触发器和GA4标签，才能将数据转发到GA4：

  1. 登录GTM后台，创建自定义事件触发器，触发条件设为event等于my_event
  2. 创建GA4事件标签，填写事件名称my_event，并添加需要传递的参数（event_date、param1等），将上述触发器绑定到该标签
  3. 发布GTM的配置版本，确保修改生效

• 验证dataLayer是否正确接收事件
  在浏览器控制台输入dataLayer，查看数组中是否存在['event', 'my_event', {...}]这条记录。如果没有，说明gtag()调用未执行或存在隐藏错误（比如thing未定义、document.getElementById('date')找不到元素），可以在调用前后添加日志排查：

  console.log('触发my_event前的日期值:', document.getElementById('date')?.value);
  console.log('thing的状态:', thing?.is_done);
  gtag('event', 'my_event', {
      'event_date': document.getElementById('date')?.value || '',
      'param1': 'false',
      'param2': 3,
      'param3': thing?.is_done? 'correct' : 'incorrect'
  }); 
  console.log('my_event已推送至dataLayer');
  

• 检查GA4事件参数的合法性
  GA4对参数有格式要求：避免传递undefined、null值，字符串参数长度不能超标，数值参数必须为合法数字。比如如果日期元素不存在，event_date会是undefined，可能导致事件上报失败，建议给参数添加默认值。

• 使用GTM预览模式调试
  开启GTM预览模式，在网站触发自定义事件后，查看GTM调试面板：

  • 确认my_event事件是否被捕获
  • 查看对应的GA4标签是否触发成功
  • 如果标签触发失败，查看面板中的错误提示（比如缺少GA4测量ID配置）

• 确认浏览器请求是否被拦截
  事件正常上报时，浏览器网络面板会出现/mp/collect开头的GA4请求。如果GTM标签触发成功但看不到该请求，可能是广告拦截器阻止了请求，或者GA4测量ID配置错误。

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