Create iOS Auto-Renewable Subscription

インストール手順とこのプラグインの全マークダウンガイドを含む設定用の質問をコピーする。

自動更新可能なサブスクリプションは、iOSアプリで利用可能なコンテンツ、サービス、またはプレミアム機能への繰り返しアクセスを提供します。このガイドでは、App Store Connectでサブスクリプションを作成する方法について説明します。

概要

自動更新可能なサブスクリプションは、各請求期間の終わりで自動的に更新されます。ユーザーがキャンセルするまで続きます。

プレミアムコンテンツと機能
広告なしのエクスペリエンス
クラウドストレージとSync
Streaming services
Professional tools and utilities

Prerequisites

Before creating subscriptions, you must:

Create a subscription group to organize your subscriptions
Have an active Apple Developer Program membership
Complete banking and tax information in App Store Connect

Creating a Subscription

Navigate to Subscriptions

App Store Connect から、 Monetize > サブスクリプション.

サブスクリプショングループを選択するか、必要に応じて新しいものを作成する
新しいサブスクリプションを作成する

サブスクリプショングループの隣にある + アイコンをクリックして、新しいサブスクリプションを追加する
基本情報を入力する

参照名: 内部使用のための説明的な名前 (顧客に表示されない)
- 例： “プレミアム月額”、 “アナイタル年額”、 “ベーシックプラン”
製品 ID: __CAPGO_KEEP_0__ (変更できません)
- Format: com.yourcompany.yourapp.premium_monthly
- __CAPGO_KEEP_0__ を使用し、下線で区切った小文字で記述してください
- native-purchases プラグインの設定に必要
期間の設定

選択可能な期間からサブスクリプションの期間を選択してください:
- 1 週間
- 1 か月
- 2 か月
- 3 か月
- 6 か月
- 1 年
期間は、ユーザーが請求される頻度を決定します。
価格設定を設定

クリック サブスクリプション価格を追加 価格設定を設定するには：

ベーステリトリー：主な市場を選択します（通常は国）

価格：サブスクリプション価格を設定
- Appleは自動的に他の通貨に変換します
- Appleの価格階層から選択
- Consider perceived value and market rates
Family Sharing (Optional)

Decide whether to enable Family Sharing, which allows up to 6 family members to access the subscription.

Once Family Sharing is enabled, it cannot be turned off for this product.

Enable if:
- Content is appropriate for family use
- You want to increase value proposition
- Your business model supports it
Don’t enable if:
- __CAPGO_KEEP_0__は個人用途のみ対象です
- __CAPGO_KEEP_0__はユーザーに合わせてカスタマイズされています
- __CAPGO_KEEP_0__はユーザーあたりの収益を最大化したい
ロケールを追加

__CAPGO_KEEP_0__をすべてのサポートするアプリの言語で表示する

サブスクリプション名サブスクリプション名（顧客向け）(例：「プレミアム月額」)

説明サブスクリプションの説明（簡潔で利点を強調）
- 主な機能を紹介
- 価値提案を強調する
- __CAPGO_KEEP_1__
アプリストアのプロモーション画像（任意）

このサブスクリプションのプロモーション画像をアップロードしてください（312x390ピクセル）：
- アプリストアのサブスクリプションページで表示
- アプリのデザインに合うように
- サブスクリプション名を明確に含める
While images are optional for initial submission, they’re required for promotional display in the App Store. You can add them later.
保存して送信

Click 保存 __CAPGO_KEEP_0__を購入する.

For First Subscription:
- __CAPGO_KEEP_1__の新しいアプリバージョンとともに提出する必要があります
- __CAPGO_KEEP_2__の次のApp Store提出に含める
- 独立して提出することはできません
For Subsequent Subscriptions:
- 直接Subscriptionsページから提出することができます
- __CAPGO_KEEP_3__の新しいアプリバージョンが必要ありません
- 最初のサブスクリプションが承認された後利用可能です

サブスクリプションの状態

サブスクリプションは次のいずれかの状態になります:

状態	説明	テスト可能か？
メタデータ不足	セットアップ不完全	Yes (sandbox)
提出可能	完了但未提交	Yes (sandbox)
レビュー待ち	Appleに提出	Yes (sandbox)
In Review	Being reviewed by Apple	Yes (sandbox)
Approved	Available for purchase	Yes
Rejected	Needs changes	Yes (sandbox)

アプリ内での使用

アプリ内でサブスクリプションを使用するには、次の製品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をドキュメント化してください

ファミリー向けアプリ（ゲーム、教育、娯楽）向けに有効にします。
収益に及ぼす影響を考慮してください
共有の動作を徹底的にテストしてください
マーケティングで共有機能を伝えます。

ローカライゼーション

すべてのサブスクリプション名と説明を翻訳する
地域の価格差を考慮する
すべてのサポート言語で表示をテストする
文化的に適切なマーケティング言語を使用する

プロモーショナルイメージ

一貫した視覚的スタイルを維持する
サブスクリプション名と主な利点を含める
シーズンごとのプロモーション用に更新する
アプリのデザイン言語に合わせる

共通のサブスクリプションパターン

Single Tier (フリーミアム)

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

Multi-Tier (良し、良し、最高)

- 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)

トラブルシューティング

アプリ内でサブスクリプションが読み込まれていない

__CAPGO_KEEP_0__を正確に (ケース感受性) 検証します
__CAPGO_KEEP_0__のサブスクリプションがサブスクリプショングループ内にあることを確認します
__CAPGO_KEEP_0__のバンドルIDがApp Store Connectと一致していることを確認します
__CAPGO_KEEP_0__を作成した後、2-3時間待ってください

__CAPGO_KEEP_0__を送信できません:

必要なすべてのフィールド (名前、説明、価格) を完了してください
少なくとも 1 つのローカライゼーションを追加してください
__CAPGO_KEEP_0__の銀行/税務情報が承認されていることを確認します
最初のサブスクリプション (アプリのバージョンが必要) を確認してください

__CAPGO_KEEP_0__のファミリーシェアリングを無効にできません:

既に有効化されています (無効にすることはできません)
__CAPGO_KEEP_0__のサブスクリプション詳細を確認してください
__CAPGO_KEEP_0__に連絡してください

__CAPGO_KEEP_1__の価格帯が利用できません:

__CAPGO_KEEP_2__の地域では利用できない可能性があります
代替の価格帯を選択してください
__CAPGO_KEEP_0__に連絡して価格に関する質問をしてください

「製品IDが無効です」エラー:

逆ドメイン形式でなければなりません
スペースや特殊文字を含めることはできません
タイプミスを確認してください
すべての製品で一意であることを確認してください

次のステップ

新規サブスクライバーを引き付けるための紹介オファーを作成新規サブスクライバーを引き付けるための紹介オファーを作成
年間サブスクライバーのサポート対象の月々のコミットメント請求計画年間サブスクライバーのサポート対象の月々のコミットメント請求計画
サンドボックステストを設定サンドボックステストを設定
再契約と保持のためのプロモーショナルオファーを設定
再契約と保持のためのプロモーショナルオファーを設定

サブスクリプション分析トラッキングを実装

詳細については、公式のAppleドキュメントを参照してください。自動更新可能なサブスクリプション.

iOS Auto-Renewable サブスクリプションの作成から続けて

Capgo を使用している場合 Create iOS Auto-Renewable Subscription ストアの承認と配布の計画に使用し、Capgo と接続する @capgo/native-purchases を使用 @capgo/native-purchases の Capgo のネイティブ機能を使用 @capgo/capacitor-in-app-review を使用 @capgo/capacitor-in-app-review の Capgo の実装詳細を使用 @capgo/capacitor-in-app-review を使用 @capgo/capacitor-in-app-review の Capgo のネイティブ機能を使用 @capgo/capacitor-native-market を使用 @capgo/capacitor-native-marketの実装詳細について @capgo/capacitor-native-marketを使用する @capgo/capacitor-native-marketのネイティブ機能について