---
title: "12个月承诺套餐"
description: "通过 Apple 的12个月承诺月度订阅，以12次月付的形式提供年度 App Store 订阅，并了解 Adapty 如何在分析和事件中显示该套餐。"
---

> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skills: `npx adapty skills install --yes`

:::important
要提供承诺套餐，您需要一个年度 App Store 订阅、一个[自定义付费墙](paywalls)以及 Adapty SDK v4.3 或更高版本。流程无法显示该套餐。
:::

承诺方案并非独立产品——而是 App Store Connect 和 Adapty 中年度产品的可选设置。它是对标准*预付方案*的补充。将其提供给对预付价格有顾虑的用户。

非美国地区的用户无需一次性支付年度 App Store 产品的全部费用，可以选择以略高的价格按月分期付款，并承诺连续订阅 12 个月。此选项需要在 App Store Connect 和 Adapty 中进行[额外配置](set-up-12-month-commitment)。Apple 将此方案称为[包含 12 个月承诺的月度订阅](https://developer.apple.com/documentation/storekit/supporting-monthly-subscriptions-with-a-12-month-commitment)。

## 承诺计划的运作方式 \{#how-a-commitment-plan-works\}

采用预付计划时，Apple 每年一次性收取年费。采用承诺计划时，Apple 将价格分为 12 期分期付款。你可以设置每期金额，并可在其中加收附加费。Apple 将遵循以下[生命周期规则](https://developer.apple.com/documentation/storekit/managing-lifecycle-of-monthly-subscriptions-with-a-12-month-commitment-)：

- **付款计划**：每次月付均为独立交易。
- **访问权限**：首次购买*不会*解锁一整年的访问权限，而是每次付款解锁一个月的访问权限。
- **续订**：第 12 个月结束后，订阅将自动续订新一轮 12 个月的承诺期，除非已取消。
- **取消**：取消仅关闭第 12 次付款后的续订。订阅者仍需支付剩余款项，并在承诺期结束前保留访问权限。
- **付款失败**：Apple 最多重试 90 天。宽限期不适用，因此在 Apple 重试期间订阅者无法访问内容。若 Apple 追回款项，后续付款日期及承诺期结束日期将顺延至追回日期之后。若 Apple 在 90 天内未能追回款项，承诺期终止，访问权限不予恢复。
- **升级与降级**：升级至同一订阅组中更高层级的订阅立即生效，并终止承诺期，无论新订阅的时长如何。订阅者可能会收到当月剩余时间的按比例退款。降级至更低层级的订阅在承诺期结束后生效。跨级操作的生效时间取决于两个订阅的时长和计费计划。
- **退款**：对过去某个月的退款不影响承诺期。对当前月份的退款将终止承诺期。
- **价格变更**：价格变更遵循 Apple 针对年度订阅的[涨价规则](https://developer.apple.com/documentation/storekit/managing-price-increases-for-auto-renewable-subscriptions)，尽管订阅者按月付款。预付计划与承诺计划各自独立定价，修改其中一项不影响另一项。

当订阅者首次购买承诺计划时，Apple 会向该 Apple 账户展示一次月付款次数说明。订阅设置和取消页面会显示剩余付款次数。你的应用无需自行显示这些说明。

### 优缺点 \{#pros-and-cons\}

#### 优点 \{#pros\}

- **与一次性付款相比**：每笔付款只是一次性价格的一小部分。不过，每年最高可加收 50% 的附加费用，仍可提升每位用户的收益。
- **与月度订阅相比**：订阅者需承诺完成全部 12 次付款。取消订阅仅会在第 12 次付款后停止续订。在[4 个国家/地区](https://support.apple.com/en-us/108098)，订阅者也可以通过 Apple 支持立即取消订阅。

#### 缺点 \{#cons\}

- **收入延迟**：收入分12期到账，而非一次性到账。
- **覆盖范围有限**：此购买方式需要 iOS 26.4 或更高版本，且在美国或 watchOS 上不可用。
- **支付失败时行为非标准**：宽限期不适用，订阅者一旦支付失败即会立即失去访问权限。
- **无法保证获得全部金额**：承诺的有效期仅取决于订阅者的支付方式是否正常。若支付失败且 Apple 在 90 天内无法完成扣款，承诺将终止，订阅也随之到期，剩余款项将无法收到。

## 分析 \{#analytics\}

Adapty 分析对承诺计划的处理方式有所不同：

- **产品 ID**：数据分析和数据导出中，承诺计划使用其独立的商店产品 ID `<product_id>:monthly` 显示，但仍属于同一个 Adapty 产品（与预付计划共享）。
- **收入**：尽管承诺期为一年，每笔月付款会单独计入收入。
- **时长**：当你按 **Duration** 筛选或分组时，承诺计划会被视为年度订阅。同期群、LTV 和趋势预测同样按年处理。
- **[取消订阅续订](cancelled-subscriptions)**：取消操作以订阅者实际取消的日期为准。订阅者在承诺期结束前仍会持续付款。
- **[留存](analytics-retention)**：每笔月付款都计为一次续订，因此承诺计划的留存率在承诺期结束前会接近 100%。
- **[A/B 测试](ab-tests)**：承诺计划的收入需要 12 个月才能完整积累，因此早期数据会偏向预付计划。建议通过转化率来对比两种方案。

如果跳过 [Adapty 配置](set-up-12-month-commitment#2-adapty-configuration)，承诺计划的购买记录仍会出现在分析数据中。当 Adapty 收到第一笔承诺计划购买时，会将该承诺计划添加到你的年度产品中。该产品必须已与 App Store 订阅关联。

## 订阅事件 \{#subscription-events\}

以下[订阅事件](webhook-event-types-and-fields)在承诺计划中的工作方式有所不同：

| 发生的情况 | 事件 |
|---|---|
| 首次之后的每次月付 | `subscription_renewed`，即使承诺本身在第 12 次付款后才续期 |
| 订阅者取消 | `subscription_renewal_cancelled`，然后对剩余的每次付款触发 `subscription_renewed` |
| 订阅者在预付方案和承诺方案之间切换 | 旧方案触发 `subscription_refunded`，新方案触发 `subscription_renewed`。若在账单周期结束时切换生效，退款金额为零；否则按比例退款 |
| 某次月付失败 | `billing_issue_detected`。账单宽限期不适用于承诺方案 |

在 webhook 和集成事件中，承诺计划携带的产品 ID 为 `<product_id>:monthly`，与分析中的格式相同。

## 故障排除 \{#troubleshooting\}

- **订阅者在付款失败后失去了访问权限**：承诺计划不适用宽限期。待 Apple 追回付款后，访问权限将恢复。
- **Adapty 显示的年度产品收入少于 App Store Connect**：Adapty 将承诺计划作为独立产品 `<product_id>:monthly` 进行上报。要与 App Store Connect 的收入进行对比，请在 Adapty 数据图表中[同时筛选](discrepancies-and-troubleshooting#12-month-commitment-plans)年度产品及其承诺计划。
- **后端无法判断承诺计划订阅者是否已取消**：在[服务端 API](api-adapty/operations/getProfile) 返回的用户画像中，订阅的 `renewal_cancelled_at` 始终为 `null`，因为每月付款仍在继续。如需判断当前承诺计划到期后是否会续期，请读取 `commitment.will_renew`——订阅者取消后该值为 `false`。