创建 iOS 自动续订订阅

GitHub

复制一个包含安装步骤和该插件的完整Markdown指南的设置提示。

自动续订订阅提供 iOS 应用程序中的内容、服务或高级功能的连续访问。本指南将指导您在 App Store Connect 中创建订阅。

概述

自动续订订阅将在每个billing周期结束时自动续订，直到用户取消。它们适用于:

高级内容和功能
无广告体验
云存储和同步
流媒体服务
专业工具和实用程序

前提条件

在创建订阅之前，必须：

创建订阅组以组织您的订阅
拥有有效的Apple Developer Program会员资格
在App Store Connect中完成银行和税务信息

创建订阅

导航到订阅

在App Store Connect中，选择您的应用程序并转到 营利>订阅.

选择您的订阅组或如果需要则创建一个新的
创建新订阅

点击 + 订阅组旁边的图标添加新订阅。
输入基本信息

参考名称: 为内部使用而设的描述性名称（不向客户显示）
- 示例：“月度Premium”，“年度Ultimate”，“基本计划”
产品ID: 订阅的唯一标识符（不能在之后更改）
- 格式： com.yourcompany.yourapp.premium_monthly
- 使用描述性、小写的名称，使用下划线
- 必填项，用于配置native-purchases插件
配置时长

从可用选项中选择订阅时长:
- 1 周
- 1 个月
- 2 个月
- 3 个月
- 6 个月
- 1 年
时长决定用户被计费的频率。
设置定价

点击 添加订阅价格 配置价格:

基础地区: 选择您的主要市场（通常是您的国家）

价格: 设置订阅价格
- 苹果会自动将价格转换为其他货币
- 选择苹果的价格等级
- 考虑到人们的价值观和市场价格
家庭共享（可选）

决定是否启用家庭共享，允许最多 6 名家庭成员访问订阅

一旦开启家庭共享功能，就无法在此产品中关闭。

启用条件:
- 内容适合家庭使用
- 您希望增加价值提议
- 您的商业模式支持
不启用条件:
- 订阅仅限个人使用
- 内容针对个人用户
- 您希望最大化每用户收入
添加本地化

在您的应用程序支持的所有语言中添加订阅显示信息：

订阅显示名称: 客户端显示名称（例如“Premium Monthly”）

描述: 订阅所包含的简要描述
- 请保持简洁并聚焦于好处
- 提及关键功能
- 突出价值提议
App Store 推广图像（可选）

上传此订阅的推广图像（312x390像素）：
- 在App Store订阅页面显示
- 应与您的应用设计相匹配
- 包含订阅名称以提高清晰度
虽然图像在初始提交中是可选的，但在 App Store 中的促销显示中是必需的。您可以稍后添加它们。
保存并提交

点击保存以创建订阅。

对于首次订阅:
- 必须与新应用版本一起提交
- 包含在您的下一个 App Store 提交中
- 无法独立提交
续订后:
- 可以直接从订阅页面提交
- 不需要新版本的应用
- 首次订阅被批准后可用

订阅状态

您的订阅将处于以下状态之一:

状态	描述	是否可测试
缺少元数据	未完成设置	是（沙盒）
准备提交	已完成但未提交	是（沙盒）
等待苹果审查	已提交给苹果	是（沙盒）
正在苹果审查中	是（沙盒）	已通过审查
是（沙盒）	可购买	是
被拒绝	需要修改	是（沙盒）

在您的应用中使用

创建后，请使用产品 ID 在应用中引用订阅：

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

// Fetch subscription products direct from StoreKit
const { products } = await NativePurchases.getProducts({
  productIdentifiers: [
    'com.yourcompany.yourapp.premium_monthly',
    'com.yourcompany.yourapp.premium_annual',
  ],
  productType: PURCHASE_TYPE.SUBS,
});

products.forEach((product) => {
  console.log(`${product.title}: ${product.priceString}`);
  console.log(`Duration: ${product.subscriptionPeriod}`);
  console.log(`Description: ${product.description}`);
});

// Purchase a subscription (StoreKit 2 automatically handles intro pricing and offers)
try {
  const transaction = await NativePurchases.purchaseProduct({
    productIdentifier: 'com.yourcompany.yourapp.premium_monthly',
    productType: PURCHASE_TYPE.SUBS,
  });

  console.log('Transaction ID:', transaction.transactionId);

  // StoreKit receipts are included on iOS for server-side validation
  await sendReceiptToBackend(transaction.receipt);
} catch (error) {
  console.error('Purchase failed:', error);
}

// Check subscription status using the store's data
const { purchases } = await NativePurchases.getPurchases({
  productType: PURCHASE_TYPE.SUBS,
});

const premium = purchases.find(
  (purchase) => purchase.productIdentifier === 'com.yourcompany.yourapp.premium_monthly',
);

if (premium?.isActive) {
  console.log('Expires:', premium.expirationDate);
  console.log('Will renew:', premium.willCancel === false);
  console.log('Store state:', premium.subscriptionState);
  unlockPremiumFeatures();
} else {
  showPaywall();
}

每月付款计划（12个月承诺）

如果您的App Store Connect订阅配置为每月付款计划和12个月承诺，StoreKit可以返回该产品的额外定价条款。使用这些条款显示每月付款、总承诺价格和全承诺期限之前购买。

const yearlyProduct = products.find(
  (product) => product.identifier === 'com.yourcompany.yourapp.premium_annual',
);

const monthlyCommitment = yearlyProduct?.pricingTerms?.find(
  (term) => term.billingPlanType === 'monthly',
);

if (yearlyProduct && monthlyCommitment) {
  console.log('Monthly charge:', monthlyCommitment.billingDisplayPrice);
  console.log('Total commitment:', monthlyCommitment.commitmentInfo?.priceString);

  await NativePurchases.purchaseProduct({
    productIdentifier: yearlyProduct.identifier,
    productType: PURCHASE_TYPE.SUBS,
    billingPlanType: 'monthly',
  });
}

查看完整的付墙和权利流程，请参见 iOS每月承诺付款计划.

最佳实践

定价策略

每月计划:降低进入门槛，培养习惯
年度计划: 更高的价值、更高的LTV、更低的流失率
多个等级: 基本、Premium、Ultimate 等级适用于不同用户群
竞争分析: 研究类似应用的定价

产品ID

使用一致的命名: company.app.tier_duration
包括等级和持续时间在ID中: premium_monthly, ultimate_annual
避免更改产品ID（它们是永久的）
为您的团队记录所有产品ID

适用于家庭导向的应用（游戏、教育、娱乐）
考虑到收入的影响
彻底测试共享行为
在营销中宣传共享功能

本地化

将所有订阅名称和描述都翻译
考虑到地区价格差异
测试在所有支持的语言中显示
使用适当的文化营销语言

促销图片

保持一致的视觉风格
包含订阅名称和关键优势
更新季节促销
与应用的整体设计语言相匹配

常见订阅模式

单级（免费）

Free App + Premium Subscription
- Basic: Free (limited features)
- Premium Monthly: $4.99
- Premium Annual: $39.99 (save 33%)

多级（好、更好、最好）

- Basic Monthly: $4.99
- Premium Monthly: $9.99
- Ultimate Monthly: $19.99

- Basic Annual: $49.99
- Premium Annual: $99.99
- Ultimate Annual: $199.99

可消耗 + 订阅混合

- Credit packs (consumable)
- Monthly subscription (unlimited credits)
- Annual subscription (unlimited + bonus features)

故障排除

应用内订阅未加载：

确认产品 ID 完全匹配（大小写敏感）
检查订阅是否在订阅组中
确保包标识符与 App Store Connect 匹配
创建产品后等待 2-3 小时

无法提交订阅：

请完成所有必填字段（名称、描述、价格）
添加至少一个本地化
验证银行/税务信息已通过
检查首次订阅（需要应用程序版本）

家庭共享开关已禁用：

已启用（无法禁用）
检查订阅详细信息
如果卡住，请联系Apple支持

价格级别不可用：

可能在某些地区受限制
请选择替代级别
联系苹果获取定价问题

“无效产品 ID”错误：

必须以反向域名格式
不能包含空格或特殊字符
检查拼写错误
验证所有产品的唯一性

下一步

为新订阅者创建引流吸引新订阅者
定制每月承诺的计费计划为支持的年度订阅计划提供商品
配置沙盒测试环境测试您的订阅
设置促销活动以实现回归和保留
实现订阅分析跟踪

额外资源

为了获取更多详细信息，请参阅苹果官方文档关于自动续订订阅.

继续从创建 iOS 自动续订订阅

如果您正在使用 创建 iOS 自动续订订阅 为了计划商店审批和分发，连接它与 Using @capgo/native-purchases for the native capability in Using @capgo/native-purchases, @capgo/capacitor-in-app-review for the implementation detail in @capgo/capacitor-in-app-review, Using @capgo/capacitor-in-app-review for the native capability in Using @capgo/capacitor-in-app-review, @capgo/capacitor-native-market for the implementation detail in @capgo/capacitor-native-market, and Using @capgo/capacitor-native-market for the native capability in Using @capgo/capacitor-native-market.