Google Analytics 4自定义事件无法发送：非调试模式无网络请求

可能的原因及对应解决方法 #

• GA4事件采样机制
  GA4默认会对低流量场景下的事件进行采样，非调试模式下事件可能被合并或延迟发送，不会生成单独的collect请求；而调试模式会强制发送所有事件，所以能正常看到请求。
  解决：

  1. 在gtag('config')中关闭自动页面视图，避免和自定义事件冲突：

     gtag('config', 'G-K...', {'send_page_view': false});
     

  2. 登录GA4后台，检查管理 > 数据设置 > 采样设置，确认是否有针对自定义事件的采样规则，按需调整。

• 脚本加载顺序问题
  页面加载时gtag.js可能还未完全初始化，此时调用gtag('event')会导致事件无法被正确捕获；调试模式下GA会提升脚本加载优先级，所以能正常触发。
  解决：将自定义事件放在脚本加载完成的回调中，确保初始化完成后再执行：

  <script async src="https://www.googletagmanager.com/gtag/js?id=G-K..." onload="triggerTestEvent()"></script>
  <script>
    window.dataLayer = window.dataLayer || [];
    function gtag(){dataLayer.push(arguments);}
    gtag('js', new Date());
    gtag('config', 'G-K...');
  
    function triggerTestEvent() {
      gtag('event', 'testing', { 'start': true });
    }
  </script>
  

• 事件参数不符合GA4规范
  GA4对事件参数的格式有严格要求，比如参数值类型不匹配、参数名包含特殊字符时，正式模式下会过滤该事件；调试模式则会宽松处理。
  解决：修正参数格式，将字符串类型的'true'改为布尔值true：

  gtag('event', 'testing', { 'start': true })
  

• 事件节流合并
  GA4会对短时间内重复触发的相同事件进行节流合并，若自定义事件和自动页面视图事件触发时机接近，可能被合并成一个请求，导致看不到单独的事件请求。
  解决：延迟事件触发时间，或添加唯一标识参数避免合并：

  // 延迟1秒触发事件
  setTimeout(() => {
    gtag('event', 'testing', { 'start': true, 'event_id': Date.now() });
  }, 1000);
  

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