创建 iOS 自动续订订阅

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

概述

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

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

前提条件

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

1. 创建订阅组 以组织您的订阅
2. 拥有一个活跃的 Apple Developer Program 会员资格
3. 在 App Store Connect 中获取完整的银行和税务信息

创建订阅

1. 前往订阅

   在 App Store Connect 中，选择您的应用并转到 收入 > 订阅.

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

   

2. 创建新订阅

   点击 + 订阅组旁边的

3. 添加新订阅

   参考名称: 为内部使用而设的描述性名称（不向客户显示）

   • 例如： “月度高级”， “年度极致”， “基本计划”

   产品 ID: 此订阅的唯一标识符（不能在以后更改）

   • 格式： com.yourcompany.yourapp.premium_monthly
   • 使用描述性、全小写的名称，使用下划线
   • 必填项，用于配置 native-purchases 插件

   

4. 配置有效期

   从可用选项中选择订阅有效期：

   • 1 周
   • 1 个月
   • 2 个月
   • 3 个月
   • 6 个月
   • 1 年

   计费周期决定了用户每次被收费的频率。

5. 设置定价

   点击 添加订阅价格 要配置定价，请：

   基本领土: 选择您的主要市场（通常是您的国家）

   价格: 设置订阅价格

   • 苹果会自动转换为其他货币
   • 选择苹果的价格等级
   • 考虑到用户的价值感和市场价格

   

6. 家庭共享（可选）

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

   注意

   启用家庭共享后，无法在此产品中关闭

   启用条件：

   • __CAPGO_KEEP_0__适合家庭观众
   • __CAPGO_KEEP_1__您希望增强价值提议
   • __CAPGO_KEEP_1__您的商业模式支持

   __CAPGO_KEEP_2__如果:

   • __CAPGO_KEEP_3__仅限个人订阅
   • __CAPGO_KEEP_4__内容针对用户
   • __CAPGO_KEEP_5__您希望最大化每用户收入

7. __CAPGO_KEEP_6__添加本地化

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

   __CAPGO_KEEP_8__订阅显示名称__CAPGO_KEEP_8__客户端显示名称（例如，“每月优质”）

   __CAPGO_KEEP_9__描述: 简要描述订阅包含的内容

   • Keep it concise and benefit-focused
   • 提及关键功能
   • 突出价值主张

   

8. App Store 推广图片 (选填)

   上传此订阅的推广图片 (312x390 像素):

   • 在 App Store 订阅页面显示
   • 应与您的应用设计相匹配
   • 包含订阅名称以增加清晰度

   注意

   虽然图片在初始提交中是可选的，但是在App Store的促销展示中是必需的。您可以在之后添加它们。

9. 保存并提交

   点击 以创建订阅 首次订阅：

   必须与新应用版本一起提交

   • 在下一次App Store提交中包含
   • 不能独立提交
   • 后续订阅：

   可以直接从订阅页面提交

   • 不需要新应用版本
   • 在App Store的促销展示中是必需的。您可以在之后添加它们。
   • 已通过首次订阅审批

订阅状态

您的订阅将具有以下状态之一：

状态	描述	是否可以测试？
缺少元数据	设置不完整	是（沙盒）
准备提交	已完成但未提交	是 (沙盒)
等待审批	已提交至 Apple	是 (沙盒)
在审批中	正在由 Apple 进行审查	是 (沙盒)
已通过	可供购买	是
被拒绝	需要修改	是 (沙盒模式)

提示

即使订阅显示“缺少元数据”或“已准备好提交”，您也可以在沙盒模式下测试订阅!

在您的应用中使用

创建后，请使用产品 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，低流失率
• 多个等级: 基本，高级，极致版为不同用户群提供
• 竞争分析: 研究类似应用的定价

产品 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 小时

无法提交订阅：

• 完成所有必填字段（名称、描述、价格）
• 添加至少一个本地化
• 确认银行/税务信息已通过审批
• 检查第一项订阅（需要应用程序版本）

家庭共享开关被禁用：

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

价格等级不可用：

• 在某些地区可能受限制
• 选择替代等级
• 关于定价问题，请联系苹果

“Invalid Product ID” error:

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

下一步

• 创建引入性优惠 吸引新订阅者
• 为支持的年度订阅计划配置定制月度付款计划 为支持的年度订阅计划配置定制月度付款计划
• 配置沙盒测试 测试您的订阅
• 为回归和保留设置促销活动
• 实施订阅分析跟踪

更多资源

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