创建 iOS 自动续订订阅

GitHub

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

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

概述

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

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

前提条件

在创建订阅之前，您必须：

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

创建订阅

在App Store Connect中，选择您的应用并转到

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

转到订阅
创建新订阅

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

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

选择可用的订阅时长选项：
- 1 周
- 1 个月
- 2 个月
- 3 个月
- 6 个月
- 1 年
时长决定用户每次被收费的频率.
设置定价

点击 添加订阅价格 为配置价格：

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

价格：设置订阅价格
- Apple 自动将其转换为其他货币
- 选择 Apple 的价格等级
- 考虑人们对产品的看法和市场价格
家庭共享（可选）

决定是否启用家庭共享功能，允许最多 6 名家人访问订阅。

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

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

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

订阅显示名称：客户端显示的名称（例如，“每月优惠”）

描述：订阅所包含的简要描述
- 请保持简洁且重点在于好处
- 提及关键功能
- 突出价值提议
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 与订阅 ID 匹配（区分大小写）
检查订阅是否在订阅组中
确保 bundle identifier 与 App Store Connect 匹配
创建产品后等待 2-3 小时

无法提交订阅：

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

家庭共享开关禁用：

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

价格级别不可用：

可能在某些地区受限制
选择替代级别
联系苹果询问价格问题

“产品ID无效”错误：

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

下一步

创建引流新订阅者吸引新订阅者的入门优惠
为支持的年度订阅计划制定月度承诺付款计划 for supported annual subscription offers
配置沙盒测试环境测试您的订阅
设置促销活动以实现回归和保留
实现订阅分析跟踪

额外资源

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

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

创建 iOS 自动续订订阅 __CAPGO_KEEP_0__ 为了规划商店审批和分发，连接它与使用 @capgo/native-purchases 在使用 @capgo/native-purchases 中的原生能力 @capgo/capacitor-in-app-review 在 @capgo/capacitor-in-app-review 中的实现细节使用 @capgo/capacitor-in-app-review 在使用 @capgo/capacitor-in-app-review 中的原生能力 @capgo/capacitor-native-market 在 @capgo/capacitor-native-market 中的实现细节，以及使用 @capgo/capacitor-native-market 在使用 @capgo/capacitor-native-market 中的原生能力

创建 iOS 自动续订订阅

概述

前提条件

创建订阅

订阅状态

在您的应用中使用

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

最佳实践

定价策略

产品ID

["Family Sharing"]

["本地化"]

促销图片

常见订阅模式

复制到剪贴板

复制到剪贴板

混合型消耗 + 订阅

故障排除

下一步

额外资源

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