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

モバイルアプリ内にペイウォールを表示することは、ユーザーにプレミアムコンテンツやサービスへのアクセスを提供する上で欠かせないステップです。ただし、ペイウォールビルダーを使ってペイウォールをカスタマイズしている場合に限り、ペイウォールを表示するだけで購入が完了します。

ペイウォールビルダーを使用しない場合は、.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) {
          // 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
}

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

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

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

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

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

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

adapty.presentCodeRedemptionSheet();

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

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

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