Skip to main content
本页完整介绍替换型 Upsell 背后的机制：替换如何处理、哪些场景受支持或会被静默阻止、付款和折扣规则、Beta 保护机制（failsafe），以及完整的问题排查目录。关于如何创建替换型 Upsell，请参阅替换型 upsell 指南。

​
替换如何处理

当顾客接受替换型 Upsell 时：
  1. 原一次性行项目会在 Shopify 中被退款。
  2. 替换行项目会被添加到同一订单中，以一次性购买或订阅的形式（取决于你的配置）。
  3. 顾客在同一订单上为替换商品付款。
  4. 顾客的账单会显示两笔交易：原商品的退款，以及替换商品的扣款。显示的 Accept Offer 按钮反映的是两者价格之间的净差额。
这是通过 Shopify 的购后 API 实现的：
  • 对于一次性替换（不同款式、数量或商品），Aftersell 会发送 add_variant changeset。
  • 对于订阅替换，Aftersell 会发送 add_subscription changeset。
  • 原行项目通过 Shopify 的退款 API 移除。
对于订阅替换，Aftersell 不会直接调用你的订阅应用的 API。订阅由 Shopify 原生的 Subscription API 创建，你的订阅应用会通过其自身的 Shopify 集成获取该订阅。

​
受支持的场景

替换型 Upsell 支持四种场景。在每种场景中，原行项目都必须是一次性购买。替换商品可以是一次性购买，也可以是订阅。
  • 一次性到一次性，同一商品，不同款式。 例如，将 Twin 尺寸替换为 Queen 尺寸。
  • 一次性到一次性，同一商品，不同数量。 例如，将单瓶替换为同款商品的 3 瓶装。在替换商品上启用 Override quantity 以设置实际发货的数量。
  • 一次性到一次性，完全不同的商品。 例如，将入门装替换为另一个 SKU 的正装版本。
  • 一次性到订阅。 例如，将一次性购买的单瓶替换为同款商品的月度订阅，或替换为另一商品的订阅版本。这是最常见的用例。

​
被阻止的场景

这些场景在 offer 展示时就会被 Aftersell 阻止。如果顾客的订单匹配其中任何一种，offer 会被静默跳过。
  • 订阅到一次性。 移除订阅行项目并不会取消 Recharge、Skio 或 Loop 中的订阅合约。顾客仍会被扣费，同时还会收到替换商品。
  • 订阅到另一个订阅。 根本原因同上，此外 Shopify 的”每笔订单一个订阅”规则也会阻止向已包含订阅的订单添加新订阅。
  • 订阅到订阅的款式或频率替换。 根本原因相同。
如果你需要更改顾客现有的订阅，请改用订阅升级。订阅升级会直接修改 Recharge、Skio 或 Loop 中的现有合约，而不会尝试移除并重新添加订阅行。
每当替换型 Upsell 被跳过时（上述被阻止的场景、不受支持的支付网关，或触发行带有折扣），Aftersell 会自动尝试改为展示同一漏斗中的 downsell offer。使用替换型 Upsell 时，请始终设置一个 downsell 作为后备，让顾客仍能看到一个 offer。

​
顾客看到的内容

了解顾客看到的内容，可以避免最常见的支持工单：“为什么我被重复扣款了？“

​
在购后 offer 中

Accept Offer 按钮显示原商品与替换商品之间的净差额。例如，如果顾客购买了一瓶 $30 的商品，而你提供一个 $45 的 3 瓶装，接受按钮会显示”Add $15.00 to your order.”。如果替换商品比原商品便宜，按钮会显示为一笔抵扣。 offer 卡片会显示替换商品的图片、标题和价格。如果 Shopify 中的款式标记了专属图片，offer 卡片会使用该款式的图片。如果款式没有标记图片，offer 卡片会回退为父商品的第一张图片。这意味着在同一商品的两个款式之间替换时，图片可能会变化也可能不会，这取决于每个款式是否在 Shopify 中设置了自己的图片。

​
接受后的 Shopify 订单

订单最终会同时显示：
  • 已应用退款的原行项目。
  • 替换商品的新行项目，按全价扣款。
订单总额反映的是净结果，但顾客的银行账单会显示两笔交易：一笔是替换商品的扣款，一笔是原商品的退款。这是 Aftersell 在付款层面处理替换型 Upsell 接受操作的方式。净金额与显示的 Accept Offer 按钮一致。 为减少困惑：
  • 在 offer 文案中加入一句明确说明退款并替换机制的话。例如：“接受后，我们会退还原商品款项并对替换商品扣款。你的账单上会显示两条记录，净额即为此按钮上显示的升级价格。”
  • 为替换型 upsell 启用 Aftersell 的自动退款通知邮件，它会向顾客发送一封解释该退款的确认邮件。

​
在订阅服务商门户中（当替换商品为订阅时）

如果替换商品是订阅，顾客会在你的订阅服务商的客户门户（Recharge、Skio、Loop、Appstle、Smartrr、Stay.ai）中看到新的订阅。该门户归你的订阅服务商所有，而非 Aftersell。请确保你的订阅服务商的欢迎邮件已配置为在接受后几分钟内发送。

​
兼容的订阅平台

当替换商品为订阅时，替换型 Upsell 可与任何使用 Shopify 原生 Subscription API 的订阅应用配合使用。在此流程中，Aftersell 不会直接调用服务商的 API；订阅由 Shopify 创建，你的订阅应用会通过其自身的 Shopify 集成获取该订阅。 兼容的服务商包括 Recharge、Skio、Loop、Stay.ai、Appstle、Smartrr、Bold Subscriptions（在 Shopify 原生订阅 API 上运行时），以及 Shopify 原生的销售计划。 如果你的替换目标配置了预付订阅计划（例如每 3 个月预先扣款一次），请与你的订阅服务商确认是否支持将预付计划作为替换目标。不同服务商对预付的处理方式各不相同。

​
付款方式要求

Aftersell 会在某些支付网关上明确阻止替换型 Upsell，因为它们无法在购后时间窗口内可靠地支持退款再扣款的模式：
  • Authorize.net（authorize_net）。Authorize.net 要求交易结算后才能发起退款，而结算存在延迟，因此 Aftersell 无法可靠地在同一 Shopify 订单上退还原商品款项并添加替换商品。如果 Authorize.net 是你的支付处理商，请将这些顾客引导至感谢页面 offer。
  • 手动支付网关（manual）。包括货到付款、自定义付款方式、草稿订单结账，以及任何不会保存授权的其他手动支付处理商。替换型 Upsell 需要一个有效的已保存付款方式才能发起后续扣款，而手动网关无法提供。
当订单的支付网关属于上述之一时，替换型 Upsell 会静默跳过该 offer。跳过原因会在 Aftersell 订单浏览器中显示为 “Payment gateway does not support replacement upsells.” 关于影响所有 Aftersell 购后 offer（不仅仅是替换型 Upsell）的更广泛付款方式列表，请参阅付款方式。

​
折扣处理

替换型 Upsell 在折扣方面有一些特定行为，常常让合作伙伴措手不及。

​
原行项目上的折扣不会转移到替换商品

当 Aftersell 对原行项目退款时，应用于其上的任何折扣也会随之退回。替换行按全价扣款（如果你配置了替换 offer 折扣，则按该折扣扣款），但顾客原有的折扣不会转移。 如果你希望顾客保留同等折扣，请直接在替换 offer 上配置。

​
目标商品有折扣时允许替换

默认情况下，如果触发行带有订单级折扣，替换型 Upsell 会跳过该 offer。这是一项保护性默认设置，用于避免退款金额不匹配。 若要在触发行有折扣时仍允许 offer 触发，请在 offer 的高级设置中启用 Allow replacement when target has a discount 开关。启用后，退款金额为折后价格（而非全价），替换商品则按你的 offer 配置扣款。

​
订阅替换的首期折扣

当替换商品为订阅时，你在 offer 上配置的折扣仅适用于第一个计费周期。之后的周期性订单按常规订阅价格扣款。顾客可以在 offer 的 Recurring subtotal 下看到周期性价格。

​
按款式设置漏斗

单个替换型 Upsell offer 在每一侧都只针对一个特定的商品和款式。如果你的订阅计划因款式而异（不同尺寸、口味或价格），你无法配置一个”将顾客购买的任一款式替换为其对应订阅款式”的 offer。每一组款式配对都需要单独的漏斗。 例如，如果你销售三种规格的精华液（Small / Medium / Large），并希望每种都替换为对应的订阅版本，你需要创建三个漏斗：
  • 漏斗 1：触发条件 = Small 一次性购买，替换商品 = Small 订阅。
  • 漏斗 2：触发条件 = Medium 一次性购买，替换商品 = Medium 订阅。
  • 漏斗 3：触发条件 = Large 一次性购买，替换商品 = Large 订阅。
Aftersell 目前没有内置的款式配对功能，因此每组款式配对都需要单独的漏斗。

​
分析与报告

替换型 Upsell 产生的退款在 Shopify 中带有备注 “AfterSell Post-Purchase Replacement Upsell”，便于识别与替换相关的退款。 Aftersell 分析不会从 upsell 价值中扣除退款金额。将 $100 的商品替换为 $200 的商品，会被记录为 $200 的 upsell，而不是净额 $100。

​
Beta 保护机制

在替换型 Upsell 处于 Beta 阶段期间，Aftersell 会追踪每个 offer 的错误，一旦错误数超过阈值，就会停止向新顾客展示该 offer。这可以防止大范围的错误配置在不知不觉中影响大量顾客。
订单浏览器中的替换型 Upsell Beta 保护机制

​
配置保护机制阈值

保护机制阈值可以在 Settings → Replacement Upsells 中配置。它会在滚动 7 天窗口内统计替换错误，并在该窗口内达到你选择的阈值时暂停替换型 upsell。你可以选择：
  • Stop on any issue in the past 7 days（推荐，也是默认值）。滚动窗口内第一次替换失败时，offer 就会停止。
  • Stop after 3 issues in the past 7 days。
  • Stop after 5 issues in the past 7 days。
  • Stop after 7 issues in the past 7 days（最宽松）。
  • Custom 会显示一个数字字段，你可以输入 1 到 100 之间的任意整数。如果你的商店订单量很大、预设值触发得太快，请使用此选项。
如果你对 offer 的配置有信心，并希望在不禁用 offer 的情况下容忍少量暂时性的 Shopify 或订阅服务商错误，请选择较高的阈值。如果面向顾客的失败对你的商店代价很高，请选择较低的阈值。

​
哪些情况会触发保护机制

替换流程中的任何异常都会在滚动 7 天窗口内计为一次错误。最常见的原因：
  • Shopify 因结账已完成而拒绝 changeset。
  • 替换商品在 offer 设置后到顾客接受前被删除或取消发布。
  • 订阅替换上的销售计划被停用。
  • Shopify API 或订阅服务商出现暂时性故障。

​
保护机制触发时

当滚动 7 天窗口内的错误数达到你的阈值时，该 offer 会停止向新顾客展示。你会在两个地方看到提示：
  • 主页横幅。 你的 Aftersell 主页上会出现一条标题为 “Replacement upsells are paused” 的警告横幅，并带有一个链接到 Settings → Replacement Upsells 的 Review failsafe 按钮。
  • 保护机制状态卡片（Settings → Replacement Upsells）。状态卡片会显示 Failsafe tripped（琥珀色）或 Not tripped（绿色）徽章，以及你当前的滚动计数和阈值，例如”4 of 5 errors in the past 7 days”。
由于保护机制使用滚动 7 天窗口，它可以自我恢复：一旦错误数降至阈值以下，替换型 upsell 就会自动恢复，无需任何操作。

​
如何重置

你可以在 Settings → Replacement Upsells 中自行重置保护机制。解决根本问题后，点击 Reset failsafe 并在弹窗中确认。滚动错误计数会立即清零，替换型 upsell 会对新订单恢复。（当你当前的错误计数已经为零时，该按钮处于禁用状态。） 只有在修复根本原因后才应重置，否则一旦再次达到阈值，保护机制会再次触发。如果你不确定错误的原因，请在重置前通过应用内聊天联系支持团队。

​
问题排查

替换型 Upsell 是一项 Beta 功能，需要由 Aftersell 支持团队手动启用。请通过应用内聊天联系支持团队申请访问权限。启用后，Replace item in original order with upsell 开关会出现在 offer 的高级设置中。
有三个原因：
  • 漏斗触发条件不匹配。 确认触发商品与测试订单购物车中的商品相同。
  • 订单已包含订阅。 替换型 Upsell 会跳过触发行为订阅的任何订单。这种情况下请改用订阅升级。
  • 原行项目有折扣。 默认情况下，替换型 Upsell 会跳过带有订单级折扣的行。请在 offer 的高级设置中启用 Allow replacement when target has a discount。
替换型 Upsell offer 在编辑器中有三个独立的商品选择项，必须保持一致的配置，替换才会触发：
  1. 漏斗触发条件。 在漏斗级别设置。决定哪些订单会看到该 offer。
  2. Upsell 商品。 在 offer 的 Upsell Products 部分设置。顾客接受时被添加到订单中的商品。
  3. Edit product to replace。 在 Replace item in original order with upsell 部分中，点击 Edit product to replace 按钮进行设置。这是顾客购物车中将被退款并移除的确切商品和款式。
最常见的配置错误：要替换的商品与顾客购物车中实际的款式不匹配。发生这种情况时，Aftersell 找不到可移除的匹配行项目，替换就会静默地不触发。修复方法：
  • 打开替换型 Upsell offer。
  • 点击 Edit product to replace，确认所选商品和款式与顾客应已购买的商品+款式（根据漏斗触发条件）完全一致。
  • 如果你是在同一商品的不同款式之间替换（Small → Large），“要替换的商品”必须明确指向 Small 款式。如果你将其指向 Large 或顾客未购买的任何款式，offer 会被跳过。
  • 保存，并用一笔包含你想要替换的确切款式的真实低价订单进行测试。
这是预期行为。原行项目被退款，替换商品被扣款，因此即使净金额等于显示的 offer 价格，顾客的银行账单仍会显示两笔交易。为减少困惑：
  • 在 offer 文案中加入一句解释退款并替换机制的话。
  • 为替换型 upsell 启用 Aftersell 的自动退款通知邮件。
  • 培训你的支持团队，在顾客咨询时解释这种两条记录的模式。
某些支付网关（包括 Authorize.net 以及其他延迟批量结算交易的网关）在原交易结算之前不允许退款。由于替换型 Upsell 会在结账后立即对替换商品扣款并退还原商品款项，退款步骤可能会失败，并显示错误”Partial refunds are not allowed until the transaction is settled. Please try again later.”。Aftersell 不会在结算后自动重试退款，因此你需要在原交易结算后（通常在 24 小时内，取决于你的网关结算时间表）从 Shopify 订单中手动发起退款。为避免这种情况，替换型 Upsell 会对已知不受支持的网关完全跳过。如果你在受支持的网关上仍反复看到此错误，请联系支持团队以便我们调查。
当 Aftersell 对原行项目退款时，应用于其上的任何折扣都会随退款一起退回。替换行单独扣款。如果你希望顾客保留折扣，请使用 offer 的折扣字段直接在替换 offer 上配置。
不能。如果订单中的原行项目已经是订阅，替换型 Upsell 不会触发。这是因为移除订阅行项目并不会取消你的订阅应用中的订阅合约；顾客仍会被扣费，同时还会收到替换商品。要修改现有订阅（更改频率、替换商品或两者兼有），请改用订阅升级。
替换型 Upsell 会在滚动 7 天窗口内追踪每个 offer 的错误，一旦错误数超过你在 Settings → Replacement Upsells 中配置的阈值（默认：过去 7 天内出现任何问题即停止），就会停止展示该 offer。保护机制触发时，你的 Aftersell 主页上会出现 “Replacement upsells are paused” 横幅，并带有一个链接到 Settings → Replacement Upsells 的 Review failsafe 链接，那里的状态卡片会显示你当前的错误计数以及保护机制是否已触发。如果错误不再发生，一旦滚动 7 天计数降至阈值以下，offer 会自动恢复。若要在修复问题后立即恢复，请在该设置页面点击 Reset failsafe。如果你不确定根本原因，请通过应用内聊天联系支持团队。
如果 Shopify 中的款式标记了专属图片，offer 卡片会使用该款式的图片。如果款式没有标记图片，offer 卡片会回退为父商品的第一张图片。如果你在同一商品的不同款式之间替换而图片没有变化，请确认每个款式都在 Shopify 中设置了自己的图片。
为每个款式创建一个漏斗。每个漏斗都有一个商品+款式触发条件，以及对应的替换商品+款式。Aftersell 目前没有内置的款式配对功能。
与订阅 Upsell 的失败模式相同：最常见的原因是销售计划在 offer 渲染后到顾客接受前被停用。Shopify 接受了 changeset，但下游没有登记任何订阅。请确认该销售计划在 Shopify 中仍处于启用状态，并已分配给替换商品。检查你的订阅应用中受影响订单的订单导入或 webhook 日志。如果订阅缺失，你的订阅应用的支持团队通常可以手动为顾客登记。
Aftersell 不管理订阅取消。后续周期的取消在你的订阅服务商的客户门户中进行，或由顾客自行操作。第一个周期的 Shopify 退款机制与任何其他行项目相同。
这是预期行为。Authorize.net 在 Aftersell 的代码中被明确禁止使用替换型 Upsell，因为它要求交易结算后才能发起退款，而结算延迟会破坏替换型 Upsell 所依赖的退款再扣款模式。作为替代方案，请为 Authorize.net 顾客运行感谢页面 offer。你可以在 Aftersell 订单浏览器中打开该订单来确认原因；跳过原因会显示为”Payment gateway does not support replacement upsells.”。
手动支付网关（货到付款、自定义付款方式、草稿订单结账）被明确禁止使用替换型 Upsell，因为它们不会保存卡片用于后续扣款。订单浏览器会将跳过原因显示为”Payment gateway does not support replacement upsells”。关于购后 offer 更广泛的付款方式限制，请参阅付款方式。