React Native SDKでモバイルアプリ内の購入を行う

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

独自のコードで画面をレンダリングする場合は、購入を完了してコンテンツをアンロックするために、.makePurchase() という別のメソッドを使用する必要があります。このメソッドは、ユーザーがペイウォールを通じて希望するトランザクションを実行するための入り口となります。

ペイウォールに、ユーザーが購入しようとしているプロダクトに対してアクティブなプロモーションオファーがある場合、Adapty は購入時に自動的にそのオファーを適用します。

すべてのステップを漏れなく完了した上で初期設定を終えていることを確認してください。設定が完了していないと、購入の検証ができません。

購入を実行する

try {
    const purchaseResult = await adapty.makePurchase(product);
    switch (purchaseResult.type) {
      case 'success':
        const isSubscribed = purchaseResult.profile?.accessLevels['YOUR_ACCESS_LEVEL']?.isActive;

        if (isSubscribed) {
          // Grant access to the paid features
        }
        break;
      case 'user_cancelled':
        // Handle the case where the user canceled the purchase
        break;
      case 'pending':
        // Handle deferred purchases (e.g., the user will pay offline with cash)
        break;
    }
} catch (error) {
    // Handle the error
}

リクエストパラメーター：

レスポンスパラメーター：

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

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

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

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

try {
    const purchaseResult = await adapty.makePurchase(product, params);
    switch (purchaseResult.type) {
      case 'success':
        const isSubscribed = purchaseResult.profile?.accessLevels['YOUR_ACCESS_LEVEL']?.isActive;

        if (isSubscribed) {
          // 有料機能へのアクセスを付与する
        }
        break;
      case 'user_cancelled':
        // ユーザーが購入をキャンセルした場合の処理
        break;
      case 'pending':
        // 延期購入を処理する（例：ユーザーが後で現金で支払う場合）
        break;
    }
} catch (error) {
    // エラーを処理する
}

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

makePurchase(product, {
    android: {
        subscriptionUpdateParams: {
            oldSubVendorProductId: 'old_product_id',
            prorationMode: 'charge_prorated_price'
        },
        isOfferPersonalized: true
    }
});

:::

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

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

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

アプリ内にコード利用シートを表示するには：

adapty.presentCodeRedemptionSheet();

App Storeからのプロモートされたアプリ内課金

ユーザーが App Store のプロダクトページから購入を開始し、そのトランザクションがアプリに引き継がれると、SDK は自動的に処理を完了します — Apple の購入システム画面がすぐに表示され、Adapty は他の購入と同様にトランザクションを処理します。この動作にはコードの変更は不要です。

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

完了処理を自分で制御したい場合（たとえば、先に独自の画面を表示したい場合など）、'onPromotedPurchaseReceived'イベントをリッスンし、プロダクトをmakePromotedPurchaseに渡してください：

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

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

リスナーは加算式で機能します。複数登録した場合、それぞれのリスナーがプロダクトを受け取りますが、あるリスナーが別のリスナーの代わりに購入を完了させることはありません。

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

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

adapty.activate("PUBLIC_SDK_KEY", {
    android: { pendingPrepaidPlansEnabled: true }
});