> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 订阅升级配置参考

本页汇总了订阅升级设置向导背后的详细规则：价格如何得出、生效时间和折扣选项如何运作、资格触发条件，以及为什么 offer 产品是一个占位产品。关于分步操作演练，请参阅[设置订阅升级](/zh/aftersell/subscription-upgrades-setup)。

<div id="api-key-verification-states">
  ## API 密钥验证状态
</div>

在第 1 步中，**Test API key** 会针对你的提供商验证你的令牌，检查它能否通过身份验证、是否具备所有必需的权限范围，以及是否属于你的商店。结果会显示以下两种状态之一：

* **绿色对勾，"API key verified"。** 令牌已通过身份验证，具备所有必需的权限范围，并且属于你的商店。**Continue** 按钮可用。
* **红色取消图标。** 检查结果不通过。图标旁的消息会说明发生了以下两种情况中的哪一种：你的提供商**拒绝**了该令牌（已被撤销或缺少必需的权限范围，消息会指出具体问题），或者 Aftersell **无法完成检查**（"Could not verify the API key. Please try again."），这是一次调用失败，而非令牌有问题。如果令牌被拒绝，请修复令牌；否则只需重新测试。

不存在第三种较温和的状态，而且"无法验证"的结果看起来与拒绝完全一样，因此请阅读消息内容而不是只看图标。在检查结果变为绿色之前，**Continue** 会一直处于禁用状态。编辑提供商或令牌会清除之前的结果，因此任何更改后都需要重新测试。设置这一关卡是为了防止订阅升级失败，否则这些失败只有在客户已被扣款后才会暴露出来。

<div id="the-eligibility-trigger-variant-on-subscription">
  ## 资格触发条件：Variant on subscription
</div>

向导会自动为你配置一个触发条件；你无需手动设置：

| 触发条件 | 设置 |
| - | - |
| **Variant on subscription** | 设置为你符合条件的（目标）款式。仅当该款式**以订阅行的形式**出现在订单中时才会触发。 |

所有已启用的触发条件都使用 AND 逻辑：必须满足每个条件，漏斗才会显示。你可以在漏斗编辑器的 **Triggers** 步骤中叠加其他可选触发条件（它们归入一个可折叠的 **Additional triggers** 部分，该部分会显示数量，并在设置了可选触发条件时自动展开）。

<Warning>
  **不要用 Product 触发条件加 Subscription 触发条件来替代它。** 那种旧组合是两个独立的条件，因此如果一笔订单中包含作为*一次性*购买的触发产品，以及一个*不相关*的订阅商品，就会同时满足两个条件：漏斗触发，但升级随后会在下游失败，因为没有可更改的匹配订阅。**Variant on subscription** 是单一条件，不会以这种方式被拆开，而且向导会自动将旧漏斗从该组合迁移过来。
</Warning>

<Warning>
  如果没有针对特定产品的触发条件，漏斗可能会向订单中不含符合条件订阅产品的客户显示。这会浪费展示次数，并产生一次静默失败的订阅修改：offer 产品被添加到订单中，但 Recharge、Skio 或 Loop 中的订阅没有任何更改。
</Warning>

<Warning>
  如果启用了 **Show this funnel for all customers**，它会覆盖所有其他触发条件，漏斗会在每次结账时触发。不建议将此设置用于订阅升级漏斗。
</Warning>

<div id="which-price-the-recurring-subtotal-shows">
  ## Recurring subtotal 显示哪个价格
</div>

offer 中的 **Recurring subtotal** 告诉客户其下次续订的费用。该价格取自哪个产品取决于升级类型：

| 升级类型 | 价格来源 |
| - | - |
| Change delivery or billing frequency | **触发**产品 |
| Replace with a different subscription product | **替换**产品 |
| Both, change frequency and replace subscription product | **替换**产品 |
| Add another subscribable item to subscription | **添加的**商品 |

这是最常见的困惑来源。仅更改频率的升级在设计上会保留相同的产品，因此无论你设置什么频率，其循环小计都只能显示触发产品的价格。如果你期望那里显示另一个产品的价格，那么你很可能需要的是 **Both, change frequency and replace subscription product**。

所使用的数量取自 **Override subscription quantity**，该选项仅出现在替换类型中。对于仅更改频率的升级，数量始终为 1。

<div id="upgrade-timing">
  ## 升级生效时间
</div>

默认情况下，升级从客户的**下一个计费周期**开始生效，并保留其现有的续订日期。

如果你的商店启用了生效时间选项，频率字段下方会出现一个复选框：

> **My fulfillment provider ships the upgraded item on the current order**

勾选后，新的计费间隔会立即开始，而不是在下次续订时开始，并且会解锁第 4 步中的 **One-time upgrade price** 字段。

<Warning>
  Aftersell 不会更改客户刚刚下的订单。此设置只会移动计费间隔。只有当你的履约服务商已设置为能识别升级的占位产品，并在当前订单中发出升级后的商品时，才应勾选此项。
</Warning>

<Note>
  此复选框默认处于关闭状态，并非所有商店都可用。它仅出现在 **Change delivery or billing frequency** 和 **Both, change frequency and replace subscription product** 升级类型中，且仅在你的商店启用了该选项后才会出现。如需使用，请通过应用内聊天联系支持团队。
</Note>

<div id="recurring-discount">
  ## 循环折扣
</div>

一种可选的激励措施，适用于升级后订阅的**每一次未来续订**（而不仅仅是第一个周期）。不适用于添加商品类型。该字段的显示方式取决于所选销售计划是否具有阶梯定价策略：

* **当选择了带有折扣档位的销售计划时**（例如，一个首次扣款减 \$20、从第二次扣款起减 \$10 的 Loop 计划），自由输入字段会被替换为一组单选按钮，每个档位一个。每个选项都会显示折扣金额及其适用的扣款范围（例如"Charge 1"或"Charge 2 onward"）。选择要应用于每一次未来续订的档位。
* **当未选择销售计划，或所选计划没有折扣档位时**，会显示标准的自由输入字段。输入金额并选择 **Percentage** 或 **Fixed amount**。

<div id="one-time-upgrade-price-by-upgrade-type">
  ## 按升级类型划分的 One-time upgrade price
</div>

**One-time upgrade price** 是客户接受时在本次 Shopify 订单上支付的金额。

* 在 **Change delivery or billing frequency** 和 **Both** 类型中，它默认锁定为 `0`，因为你的订阅提供商会在当前计费周期结束时扣款，而占位产品会以 \$0.00 显示在 Shopify 订单上。只有当第 3 步中的[升级生效时间复选框](#upgrade-timing)被勾选时，它才可编辑。
* 在 **Replace with a different subscription product** 和 **Add another subscribable item to subscription** 类型中，生效时间复选框不适用，因此价格字段始终可编辑。

应填写的内容取决于升级类型：

* **频率、替换或两者兼有：** 原订阅与升级后订阅之间的价格*差额*。客户保留其订阅，此笔扣款用于补足差价。
* **添加另一个可订阅商品：** 本次订单中所添加商品的费用。由于没有替换任何东西，因此无需计算差额：这只是客户现在为新商品支付的金额，之后该商品会随其订阅循环扣款。请参阅[向现有订阅添加商品](/zh/aftersell/subscription-upgrades-add-item)。

**First-order discount（首单折扣）。** 一种仅适用于本次升级购买的可选折扣，以百分比（`%`）或固定金额输入。它位于 **One-time upgrade price** 旁边，只要该字段可编辑就会出现，在 **Create new** 和 **Pick existing** 两个选项卡中均如此。在添加商品类型中，该字段仍会出现，但始终保存为 `0`；添加商品的 offer 从不附带折扣，因此请直接在 offer 产品上设置你想要的价格。

<div id="why-the-offer-product-is-a-placeholder">
  ## 为什么 offer 产品是占位产品
</div>

offer 产品**仅是一个视觉占位**，而不是客户实际购买的真实产品。Shopify 不允许在已包含订阅的订单之后将订阅产品显示为购后 upsell，因此 Aftersell 改用一个非订阅的占位 SKU 来收取升级之间的差价。

* 你设置的图片、标题和价格会显示在 offer 卡片中。
* 接受后，显示的价格会在 Shopify 订单上扣款，并由 Recharge、Skio 或 Loop 在下一个周期将实际升级应用到订阅上。
* 如果你选择 **Pick existing** 而不是新建，该产品必须支持一次性购买；仅限订阅的产品会从选择器中被过滤掉。