如何在 GTM4WP 中排除特定商品 ID 的订单收入数据发送至数据层

本文介绍如何通过修改 GTM4WP 插件的 gtm4wp_get_purchase_datalayer() 函数，精准过滤含指定商品 ID（如 224112 或 159324）的 WooCommerce 订单，使其不向 Google Tag Manager 数据层发送实际收入值，从而避免污染 GA4 购买事件数据。

本文介绍如何通过修改 gtm4wp 插件的 `gtm4wp_get_purchase_datalayer()` 函数，精准过滤含指定商品 id（如 224112 或 159324）的 woocommerce 订单，使其不向 google tag manager 数据层发送实际收入值，从而避免污染 ga4 购买事件数据。

在使用 GTM4WP 追踪 WooCommerce 购买事件时，若需排除特定 SKU 或商品 ID（例如测试订单、内部采购、赠品等）对 GA4 收入指标的影响，最可靠的方式是在数据进入数据层（dataLayer）前就进行逻辑拦截——而非依赖 GTM 触发器或 GA4 过滤器（后者无法修正已上报的 revenue 字段）。由于 GTM4WP 是通过 PHP 主动构造 purchase 数据并推入 dataLayer，因此我们应在 gtm4wp_get_purchase_datalayer() 函数中注入商品级判断逻辑。

关键在于：不能仅检查单个 $product_id 变量（该变量不存在于订单上下文中），而必须遍历订单内所有商品项，提取其真实 product ID 并与目标黑名单比对。以下是推荐的、安全且可维护的实现方式：

✅ 正确实现步骤（替换原函数中的 revenue 计算逻辑）

将原始代码中关于 $order_revenue 的赋值部分（位于 if ( $gtm4wp_options[ GTM4WP_OPTION_INTEGRATE_WCEXCLUDETAX ] ) { … } 之前）替换为以下逻辑：

// 获取当前订单中所有商品的 ID 列表
$order_product_ids = array();
foreach ( $order->get_items() as $item ) {
    $product = $item->get_product();
    if ( $product ) {
        $order_product_ids[] = $product->get_id();
    }
}

// 定义需排除收入的商品 ID 黑名单
$excluded_product_ids = array( 224112, 159324 );

// 判断订单是否包含任一被排除的商品
$is_excluded_order = ! empty( array_intersect( $order_product_ids, $excluded_product_ids ) );

// 根据判断结果设置 revenue：含黑名单商品则设为 0；否则按配置计算
if ( $is_excluded_order ) {
    $order_revenue = 0.0;
} else {
    if ( $gtm4wp_options[ GTM4WP_OPTION_INTEGRATE_WCEXCLUDETAX ] ) {
        $order_revenue = (float)( $order->get_total() - $order->get_total_tax() );
    } else {
        $order_revenue = (float) $order->get_total();
    }

    $order_shipping_cost = (float) $order->get_shipping_total();
    if ( $gtm4wp_options[ GTM4WP_OPTION_INTEGRATE_WCEXCLUDESHIPPING ] ) {
        $order_revenue -= $order_shipping_cost;
    }
}

⚠️ 注意事项与最佳实践

• 不要直接修改插件核心文件：GTM4WP 更新会覆盖你的修改。请将上述逻辑封装为子主题 functions.php 中的 add_filter 钩子，或使用 Code Snippets 插件管理：

  add_filter( 'gtm4wp_purchase_datalayer', function( $dataLayer, $order, $order_items ) {
      // 在此处插入上述判断逻辑，并修改 $dataLayer['ecommerce']['purchase']['actionField']['revenue'] 等字段
      return $dataLayer;
  }, 10, 3 );

  ✅ 推荐：GTM4WP 提供了 gtm4wp_purchase_datalayer 过滤钩子，应优先使用它替代直接修改插件源码，确保升级兼容性。

• Revenue 设为 0 后，其他字段仍保留：订单编号、商品列表、运费、税额等仍将正常发送，仅 revenue 和衍生指标（如 transactionTotal）归零，符合 GA4 EEC 规范，不会导致事件失效。

• 支持多商品混合订单：即使订单同时含黑名单和普通商品，整单 revenue 也将归零（业务规则需明确此策略）。如需更精细控制（如仅剔除黑名单商品金额），需重构 $_order_items[‘products’] 并重算净收入，但会显著增加复杂度，通常不建议。

• 验证方法：部署后，在浏览器开发者工具 Console 中执行 window.dataLayer.filter(e => e.event === ‘gtm4wp.orderCompletedEEC’)，检查 ecommerce.purchase.actionField.revenue 是否符合预期。

通过这一方案，你既能精准拦截异常订单的数据污染，又保持 GTM4WP 架构完整性，为 GA4 报告提供干净、可信的转化与营收数据基础。