跳过内容
Capgo - Capacitor Live Updates Capgo

创建 iOS 自动续费订阅

GitHub

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

概述

标题为“概述”的部分

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

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

前提条件

前提条件

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

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

创建订阅

创建订阅

  1. 前往订阅

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

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

    前往订阅

  2. 创建新订阅

    点击 + 订阅组旁边的图标添加一个新的订阅。

  3. 输入基本信息

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

    • Examples: “Premium Monthly”， “Ultimate Annual”， “Basic Plan”

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

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

    输入订阅详细信息

  4. 配置持续时间

    从可用选项中选择订阅持续时间：

    • 一周
    • 一个月
    • 两个月
    • 三个月
    • 6个月
    • 1年

    时间长度决定了用户的账单频率。

  5. 设置定价

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

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

    价格: 设置订阅价格

    • 苹果会自动将价格转换为其他货币
    • 选择 Apple 的价格等级
    • 考虑被接受的价值和市场价格

    配置价格

  6. 家庭共享（可选）

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

    启用条件：

    • 内容适合家庭使用
    • 您希望增加价值提议
    • 您的商业模式支持它

    如果以下条件不满足，请勿启用:

    • 订阅仅限个人使用
    • 内容将根据用户进行个性化
    • 您希望最大化每用户的收入

  7. 添加本地化

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

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

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

    • 请保持简洁且以利益为导向
    • 请提及关键功能
    • 突出价值主张

    添加本地化

  8. App Store 推广图片（选填）

    上传此订阅的推广图片（312x390像素）：

    • 在 App Store 订阅页面显示
    • 应与您的应用设计相符
    • 包含订阅名称以提高清晰度

  9. 保存并提交

    点击 保存 创建订阅。

    首次订阅:

    • 必须与新版应用一起提交
    • 在下一次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个月的承诺计划

每月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每月承诺计费计划.

最佳实践

Section titled “最佳实践”

定价策略

Section titled “定价策略”
  • 月度计划: 入门门槛更低，培养习惯
  • 年度计划: 更好的价值，高的LTV，低的流失率
  • 多个等级: 基本，高级，极致版为不同用户群
  • 竞争分析: 研究类似应用的定价

产品ID

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

家庭共享

家庭共享
  • 为家庭导向的应用程序（游戏、教育、娱乐）启用
  • 考虑到对收入的影响
  • 彻底测试共享行为
  • 在营销中传达共享能力

本地化

Section titled “国际化”
  • 将所有订阅名称和描述都翻译
  • 考虑区域价格差异
  • 在所有支持语言中测试显示
  • 使用适当的文化营销语言

促销图片

Section titled “促销图片”
  • 保持一致的视觉风格
  • 包含订阅名称和关键优势
  • 更新季节性促销
  • 匹配应用的整体设计语言

常见订阅模式

常见订阅模式

单层模式（免费版)

单层模式（免费版）
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 匹配（大小写敏感）
  • 检查订阅是否在订阅组中
  • 确保包标识符与 App Store Connect 匹配
  • 创建产品后等待 2-3 小时

无法提交订阅:

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

家庭共享开关已禁用:

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

价格等级不可用：

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

“无效产品ID”错误：

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

下一步

Section titled “下一步”

Section titled “更多资源”

有关更多详细信息，请参见

protectedTokens 苹果官方文档关于自动续订订阅.

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

标题：继续从创建 iOS 自动续订订阅

如果您正在使用 创建 iOS 自动续订订阅 如果您正在使用 使用@capgo/native-purchases 使用 @capgo/native-purchases @capgo/capacitor-内购评论 @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 的原生能力