GTM增强电商Purchase数据层推送仅Tag Assistant生效问题排查

核心故障原因 #

模拟上报正常、真实用户上报失败的问题，核心是调试场景和真实用户场景的运行环境差异导致，常见原因如下：

• dataLayer推送时机错误：如果你的dataLayer.push代码放在GTM容器引入代码之前，且没有提前声明dataLayer变量，会导致推送的事件在GTM加载前丢失。Tag Assistance调试模式会提前监听所有dataLayer操作，所以可以正常捕获，真实环境下GTM加载完成前的推送会直接丢失。
• 页面提前跳转：多数电商感谢页会设置下单后自动跳转到个人中心/首页，跳转速度过快时GTM的上报请求还没发出页面就被卸载，调试时你会停留在感谢页等待结果，所以上报正常。
• 尾逗号语法兼容问题：你当前代码中foreach循环输出每个商品后都加了逗号，最后一个商品尾部也会多出逗号，低版本浏览器、部分移动端内置浏览器会直接报JS语法错误，导致整个dataLayer推送代码不执行。现代浏览器默认兼容尾逗号，所以调试时不会触发问题。
• 数值类型错误：你把revenue、price、quantity字段都用引号包裹变成了字符串类型，GA的增强电商要求这些字段为数字类型，正式上报时会因为数据格式校验失败被拒收，调试场景下校验规则更宽松所以可以正常上报。
• 触发器路径匹配错误：如果你的触发器配置了仅在指定路径触发，测试环境和生产环境的感谢页路径不一致时，生产环境触发器不会被触发，调试时用的是测试路径所以正常。
• 广告拦截器拦截：普通用户大量安装广告拦截插件，会直接拦截GA/GTM的上报请求，调试时你一般关闭了拦截工具所以不受影响。

排查解决步骤 #

1. 调整dataLayer相关代码顺序
   首先在GTM引入代码的最顶部提前声明dataLayer：

   window.dataLayer = window.dataLayer || [];
   

   将订单上报的dataLayer.push代码放在GTM容器引入代码之后，避免事件丢失。
2. 修复代码语法和数据格式问题
   修正后的感谢页代码如下：

   <script type="text/javascript">
   dataLayer.push({ ecommerce: null });
   // 先组装商品数组避免尾逗号问题
   const products = [];
   <?php foreach ($order->get_items() as $key => $item): ?>
   products.push({
       'name': '<?php echo $item['name']; ?>',
       'id': '<?php echo $item['product_id']; ?>',
       'price': <?php echo number_format($item->get_total(), 2, ".", ""); ?>,
       'quantity': <?php echo $item['qty']; ?>
   });
   <?php endforeach; ?>
   dataLayer.push({
       'event': 'transaction',
       'ecommerce': {        
           'purchase': {
               'actionField': {
                   'id': '<?php echo $order->get_order_number() ?>',
                   'revenue': <?php echo number_format($order->get_subtotal(), 2, ".", ""); ?>, 
                   'number_of_products': <?php echo $order->get_item_count(); ?>
               },
               'products': products
           }
       }
   });
   </script>
   

3. 调整感谢页跳转逻辑
   给感谢页添加至少1.5秒的跳转延迟，或者监听GTM上报完成回调后再执行跳转，避免请求未发出就卸载页面。
4. 校验触发器配置
   确认触发器的页面路径匹配规则适配生产环境的感谢页路径，建议使用「包含」匹配规则，避免动态参数导致匹配失败。
5. 兼容广告拦截场景
   可以配置GTM服务器端中转（Server Side Tagging），将上报请求先发送到你自己的域名下再转发到GA，避免被广告拦截器拦截。

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