本文详解如何在 woocommerce 外部产品中，根据目标跳转域名（如 sitea.com、siteb.com）自动追加对应联盟 id 参数，实现多 affiliate 平台的精准路由与参数注入。
本文详解如何在 woocommerce 外部产品中，根据目标跳转域名（如 sitea.com、siteb.com）自动追加对应联盟 id 参数，实现多 affiliate 平台的精准路由与参数注入。
在 WooCommerce 中，外部产品（external 类型）的“加入购物车”按钮实际跳转至第三方网址。默认情况下，该链接由产品设置中的「外部链接」字段决定。若需为不同联盟平台（如 Facebook、Microsoft、Amazon 等）动态注入专属追踪参数（如 ?affiliateID-1），不能简单统一追加，而应基于目标 URL 域名进行条件判断——这正是多渠道联盟营销（Multi-Affiliate Routing）的核心需求。
以下是一个健壮、可扩展的实现方案，使用 woocommerce_product_add_to_cart_url 过滤器，在不修改主题模板的前提下完成智能参数拼接：
add_filter( 'woocommerce_product_add_to_cart_url', 'custom_product_add_to_cart_url', 20, 2 );
function custom_product_add_to_cart_url( $add_to_cart_url, $product ) {
// 仅处理外部产品，其他类型（如虚拟/实物）保持原链接不变
if ( ! $product->is_type( 'external' ) ) {
return $add_to_cart_url;
}
// 移除协议头并标准化为小写，提升匹配鲁棒性（支持 http://、https://、无协议等）
$parsed_url = wp_parse_url( $add_to_cart_url );
$host = isset( $parsed_url['host'] ) ? strtolower( $parsed_url['host'] ) : '';
// 定义联盟映射规则：域名 → 追加参数（支持完整域名或子域名通配）
$affiliate_rules = array(
'facebook.com' => '?affiliateID-1',
'microsoft.com' => '?affiliateID-2',
'amazon.com' => '?ref=yourstore-20',
'example-affiliate.net' => '?utm_source=wc&utm_medium=affiliate&utm_campaign=v2',
);
// 匹配并追加对应参数（注意：仅在无现有查询参数时使用 '?'，否则用 '&'）
if ( ! empty( $host ) && isset( $affiliate_rules[ $host ] ) ) {
$separator = ( strpos( $add_to_cart_url, '?' ) !== false ) ? '&' : '?';
$add_to_cart_url .= $separator . ltrim( $affiliate_rules[ $host ], '?' );
}
return $add_to_cart_url;
}
✅ 关键特性说明：
- ✅ 域名精准匹配：使用 wp_parse_url() 提取并标准化 host，避免路径、协议、大小写干扰；
- ✅ 安全参数拼接：自动识别 URL 是否已含查询参数（?），智能选用 ? 或 & 分隔符，防止链接损坏；
- ✅ 高可维护性：联盟规则集中定义在 $affiliate_rules 数组中，新增平台只需添加一行键值对；
- ✅ 兼容性强：适配 HTTP/HTTPS、www/non-www、子域名（如 shop.amazon.com 需单独配置，或改用 str_ends_with() 做后缀匹配）。
⚠️ 注意事项：
- 请将代码添加至子主题的 functions.php 文件中，切勿修改父主题或 WooCommerce 核心文件；
- 若需匹配子域名（如 us.amazon.com），可将键改为 'amazon.com' 并配合 str_ends_with( $host, '.amazon.com' ) || $host === 'amazon.com' 判断；
- 生产环境建议启用 WordPress 对象缓存，并对高频访问的 $affiliate_rules 做静态缓存优化；
- 测试时务必清空浏览器缓存及任何页面级缓存插件（如 WP Rocket），确保新逻辑实时生效。
通过此方案，您即可轻松管理数十个联盟渠道，每个外部产品自动携带其归属平台的唯一追踪标识，为流量归因、佣金结算与 ROI 分析提供坚实基础。
