Capacitor SDKでモバイルアプリ内課金を行う

ペイウォールをモバイルアプリ内に表示することは、ユーザーにプレミアムコンテンツやサービスへのアクセスを提供する上で欠かせないステップです。ただし、ペイウォールを表示するだけで購入が完結するのは、Adapty が画面を描画する場合、つまりフローまたは旧ペイウォールビルダーで作成したペイウォールを使用している場合に限られます。

独自のコードで画面を描画している場合は、.makePurchase() という別のメソッドを使って購入を完了し、目的のコンテンツを解放する必要があります。このメソッドは、ユーザーがペイウォールを通じて取引を進めるための入口となります。

ペイウォールに、ユーザーが購入しようとしているプロダクトへの有効なプロモーションオファーが設定されている場合、Adapty は購入時に自動的にそれを適用します。

初期設定をすべてのステップを省略せずに完了していることを確認してください。これが済んでいないと、購入を検証できません。

購入を行う

try {
  const result = await adapty.makePurchase({ product });
  
  if (result.type === 'success') {
    const isSubscribed = result.profile?.accessLevels?.['YOUR_ACCESS_LEVEL']?.isActive;
    
    if (isSubscribed) {
      // Grant access to the paid features
      console.log('User is now subscribed!');
    }
  } else if (result.type === 'user_cancelled') {
    console.log('Purchase cancelled by user');
  } else if (result.type === 'pending') {
    console.log('Purchase is pending');
  }
} catch (error) {
  console.error('Purchase failed:', error);
}

リクエストパラメータ：

レスポンスパラメータ：

購入時にサブスクリプションを変更する

ユーザーが現在のサブスクリプションを更新するのではなく、新しいサブスクリプションを選択した場合、動作はアプリストアによって異なります。

• App Store の場合、サブスクリプショングループ内でサブスクリプションは自動的に更新されます。ユーザーがあるグループのサブスクリプションを購入済みの状態で別のグループのサブスクリプションを購入した場合、両方のサブスクリプションが同時にアクティブになります。
• Google Play の場合、サブスクリプションは自動的に更新されません。以下で説明するように、アプリのコード内で切り替えを管理する必要があります。

Androidでサブスクリプションを別のものに切り替えるには、追加パラメーターを指定して .makePurchase() メソッドを呼び出します。

try {
  const result = await adapty.makePurchase({ 
    product,
    params: {
      android: {
        subscriptionUpdateParams: {
          oldSubVendorProductId: 'old_product_id',
          prorationMode: 'charge_prorated_price'
        },
        isOfferPersonalized: true
      }
    }
  });
  
  if (result.type === 'success') {
    const isSubscribed = result.profile?.accessLevels?.['YOUR_ACCESS_LEVEL']?.isActive;
    
    if (isSubscribed) {
      // Grant access to the paid features
      console.log('Subscription updated successfully!');
    }
  } else if (result.type === 'user_cancelled') {
    console.log('Purchase cancelled by user');
  } else if (result.type === 'pending') {
    console.log('Purchase is pending');
  }
} catch (error) {
  console.error('Purchase failed:', error);
}

追加リクエストパラメーター:

MakePurchaseParamsInput 構造体には以下が含まれます：

{
  android: {
    subscriptionUpdateParams: {
      oldSubVendorProductId: 'old_product_id',
      prorationMode: 'charge_prorated_price'
    },
    isOfferPersonalized: true
  }
}

サブスクリプションと置き換えモードの詳細については、Google Developer ドキュメントをご参照ください：

• 交換モードについて
• Googleによる交換モードの推奨事項
• 交換モード CHARGE_PRORATED_PRICE。注意: このメソッドはサブスクリプションのアップグレードにのみ使用可能です。ダウングレードはサポートされていません。
• 交換モード DEFERRED。注意: 実際のサブスクリプション変更は、現在のサブスクリプションの請求期間が終了した時点でのみ行われます。

プリペイドプランの管理（Android）

アプリユーザーがプリペイドプラン（例: 数ヶ月分の非更新型サブスクリプションを購入）を利用できる場合、プリペイドプランに対して保留中のトランザクションを有効にできます。

await adapty.activate({
  apiKey: 'YOUR_PUBLIC_SDK_KEY',
  params: {
    android: {
        pendingPrepaidPlansEnabled: true,
    },
  }
});

iOSでオファーコードを利用する

アプリでコード引き換えシートを表示するには:

try {
  await adapty.presentCodeRedemptionSheet();
} catch (error) {
  console.error('Failed to present code redemption sheet:', error);
}

App Storeからのプロモーション済みアプリ内課金

ユーザーがApp Storeのプロダクトページから購入を開始し、そのトランザクションがアプリに引き継がれると、SDKが自動的に処理します。Appleの購入システム画面がすぐに表示され、Adaptyは通常の購入と同じようにトランザクションを処理します。このために追加のコードは不要です。

プロモーション対象のプロダクトにサブスクリプションオファーが設定されている場合、SDKは購入時に自動的にそのオファーを適用します。オファーはApp Storeの購入インテントから読み取られ、iOS 18.0以降で利用できます。iOS 16.4〜17.xでは、通常価格で購入が処理されます。

独自の処理（例：先に独自の画面を表示するなど）を行うには、'onPromotedPurchaseReceived' イベントをリッスンし、プロダクトを makePromotedPurchase に渡します：

const listener = await adapty.addListener('onPromotedPurchaseReceived', async ({ product }) => {
  const result = await adapty.makePromotedPurchase({ product });
  // process the purchase result
});

makePromotedPurchase は購入パラメーターを受け取りません。プロモーション対象のプロダクトはペイウォールではなく App Store から渡されるため、ペイウォールのコンテキストを持ちません。返り値は makePurchase と同じ AdaptyPurchaseResult です。

adapty.removeAllListeners() を呼び出すと、プロモーション購入のリスナーも他のリスナーと一緒に削除され、SDK の自動完了処理が再開されます。アプリが引き続き完了処理を担当する場合は、リスナーを再登録してください。