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

このガイドでは、カスタムペイウォールへのAdapty統合方法を説明します。ペイウォールの実装を完全にコントロールしながら、Adapty SDKがプロダクトの取得、新規購入の処理、過去の購入の復元を担当します。このガイドはAdapty Flutter SDK v4のAPIを使用しています。v3をお使いの場合は、対応するメソッド名についてマイグレーションガイドをご参照ください。

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

始める前に

プロダクトの設定

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

プロダクト – ユーザーが購入できるもの（サブスクリプション、消耗型アイテム、永続アクセスなど）
ペイウォール – どのプロダクトを提示するかを定義する設定。Adapty ではペイウォールを通じてのみプロダクトを取得できます。この設計により、アプリのコードを変更せずにプロダクト・価格・オファーを更新できます。SDK v4 では、プレースメントのペイウォールのバリアントは flow オブジェクトで管理されます。flow を取得してプロダクトを参照します。
プレースメント – アプリ内でペイウォールを表示する場所やタイミング（main、onboarding、settings など）。ダッシュボードでプレースメントにペイウォールを設定し、コードからプレースメント ID で呼び出します。これにより A/B テストの実施や、ユーザーごとに異なるペイウォールの表示が簡単に行えます。これらのコンセプトは、カスタムペイウォールを使用する場合でも必ず理解しておいてください。基本的に、これらはアプリで販売するプロダクトを管理するための仕組みです。

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

ユーザーを管理する

バックエンド認証の有無に関わらず、どちらの方法でも利用できます。

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

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

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

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


Future<void> loadPaywall() async {
  try {
    final flow = await Adapty().getFlow(placementId: 'YOUR_PLACEMENT_ID');
    final products = await Adapty().getPaywallProducts(flow: flow);
    
    // Use products to build your custom paywall UI
  } on AdaptyError catch (adaptyError) {
    // Handle the error
  } catch (e) {
    // Handle the error
  }
}

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

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


Future<void> purchaseProduct(AdaptyPaywallProduct product) async {
  try {
    final purchaseResult = await Adapty().makePurchase(product: product);
    
    switch (purchaseResult) {
      case AdaptyPurchaseResultSuccess(profile: final profile):
        // Purchase successful, profile updated
        break;
      case AdaptyPurchaseResultUserCancelled():
        // User canceled the purchase
        break;
      case AdaptyPurchaseResultPending():
        // Purchase is pending (e.g., user will pay offline with cash)
        break;
    }
  } on AdaptyError catch (adaptyError) {
    // Handle the error
  } catch (e) {
    // Handle the error
  }
}

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

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

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


Future<void> restorePurchases() async {
  try {
    final profile = await Adapty().restorePurchases();
    // Restore successful, profile updated
  } on AdaptyError catch (adaptyError) {
    // Handle the error
  } catch (e) {
    // Handle the error
  }
}

ステップ 4. サブスクリプションのステータスを確認する

購入やリストアの後、アクセスレベルを確認して、ペイウォールを表示するか有料機能を解放するかを決定します。makePurchase メソッドと restorePurchases メソッドはすでに更新されたプロファイルを返しますが、アプリの他の場所で現在のステータスが必要な場合は、getProfile メソッドを使用してください。


Future<bool> hasPremiumAccess() async {
  try {
    final profile = await Adapty().getProfile();
    return profile.accessLevels['premium']?.isActive ?? false;
  } on AdaptyError catch (adaptyError) {
    // Handle the error
  } catch (e) {
    // Handle the error
  }
  return false;
}

サブスクリプションステータスの確認方法やリアルタイム更新のリスニングなど、詳細についてはサブスクリプションステータスの確認をご覧ください。

次のステップ

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

ペイウォールをアプリに表示する準備ができました。App Store サンドボックスまたは Google Play Store でテスト購入を行い、ペイウォールからテスト購入を完了できることを確認してください。本番環境に近い実装例を確認したい場合は、サンプルアプリの PurchasesObserver をご覧ください。エラーハンドリング、UI オブザーバー、包括的な SDK インテグレーションを含む購入処理の実装例が確認できます。