React Native SDKのカスタムペイウォールで購入を有効にする

このガイドでは、Adaptyをカスタムペイウォールに統合する方法を説明します。ペイウォールの実装を完全にコントロールしながら、Adapty SDKがプロダクトの取得、新規購入の処理、過去の購入の復元を行います。

このガイドは、カスタムペイウォールを実装する開発者向けです。 購入機能を最も簡単に導入したい場合は、Adapty フローBuilder をご利用ください。フローBuilderを使えば、ノーコードのビジュアルエディターでフローを作成でき、購入ロジックはすべてAdaptyが自動的に処理します。また、アプリを再公開することなく、さまざまなデザインをテストできます。

始める前に

プロダクトの設定

アプリ内課金を有効にするには、3つの重要な概念を理解する必要があります。

プロダクト – ユーザーが購入できるもの（サブスクリプション、消耗型アイテム、永続アクセス）
ペイウォール – どのプロダクトを提供するかを定義する設定。Adapty では、プロダクトを取得する唯一の方法がペイウォールです。この設計により、アプリのコードを変更することなく、プロダクト・価格・オファーを修正できます。
プレースメント – アプリ内でペイウォールを表示する場所とタイミング（main、onboarding、settings など）。ダッシュボードでプレースメントにペイウォールを設定し、コード内ではプレースメント ID を指定してリクエストします。これにより、A/B テストの実施や、ユーザーごとに異なるペイウォールの表示が簡単に行えます。これらのコンセプトは、カスタムペイウォールを使う場合でも必ず把握しておいてください。要するに、アプリで販売するプロダクトを管理するための仕組みです。

カスタムペイウォールを実装するには、ペイウォールを作成し、プレースメントに追加する必要があります。この設定により、プロダクトを取得できるようになります。ダッシュボードで何をすべきかを確認するには、こちらのクイックスタートガイドを参照してください。

ユーザーの管理

バックエンド認証の有無にかかわらず使用できます。

ただし、Adapty SDKは匿名ユーザーと識別済みユーザーを異なる方法で処理します。詳細を把握し、ユーザーを適切に扱うために、識別クイックスタートガイドをお読みください。

ステップ 1. プロダクトを取得する

カスタムペイウォール用のプロダクトを取得するには、次の手順に従います。

プレースメント ID を getFlow メソッドに渡して flow オブジェクトを取得します。
getPaywallProducts メソッドを使用して、このフローのプロダクト配列を取得します。


async function loadPaywall() {
  try {
    const flow: AdaptyFlow = await adapty.getFlow('YOUR_PLACEMENT_ID');
    const products: AdaptyPaywallProduct[] = await adapty.getPaywallProducts(flow);
    
    // Use products to build your custom paywall UI
  } catch (error) {
    // Handle the error
  }
}

ステップ2：購入を受け付ける

ユーザーがカスタムペイウォール上でプロダクトをタップしたら、選択されたプロダクトを引数として makePurchase メソッドを呼び出します。これにより購入フローが処理され、更新されたプロファイルが返されます。


async function purchaseProduct(product: AdaptyPaywallProduct) {
  try {
    const purchaseResult: AdaptyPurchaseResult = await adapty.makePurchase(product);
    
    switch (purchaseResult.type) {
      case 'success':
        // Purchase successful, profile updated
        break;
      case 'user_cancelled':
        // User canceled the purchase
        break;
      case 'pending':
        // Purchase is pending (e.g., user will pay offline with cash)
        break;
    }
  } catch (error) {
    // Handle the error
  }
}

ステップ 3. 購入を復元する

アプリストアでは、サブスクリプションを提供するすべてのアプリに対して、ユーザーが購入を復元できる手段を提供することを義務付けています。

ユーザーが復元ボタンをタップしたときに restorePurchases メソッドを呼び出してください。これにより、ユーザーの購入履歴が Adapty と同期され、更新されたプロファイルが返されます。


async function restorePurchases() {
  try {
    const profile: AdaptyProfile = await adapty.restorePurchases();
    // Restore successful, profile updated
  } catch (error) {
    // Handle the error
  }
}

次のステップ

ご質問やお困りのことがあれば、サポートフォーラムをご覧ください。よくある質問への回答を見つけたり、ご自身の質問を投稿することができます。チームとコミュニティがサポートいたします！

ペイウォールをアプリに表示する準備が整いました。App Store サンドボックスまたはGoogle Play Storeでテスト購入を行い、ペイウォールからテスト購入が完了できることを確認してください。本番環境に対応した実装でどのように動作するかを確認するには、サンプルアプリのCustomPurchaseScreen.tsxを参照してください。エラー処理、ローディング状態、UI状態管理を含む購入処理の実装例が確認できます。次に、購入が完了しているかどうかを確認して、ペイウォールを表示するか有料機能へのアクセスを許可するかを判断します。