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

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

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

始める前に

プロダクトのセットアップ

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

  • プロダクト – ユーザーが購入できるもの(サブスクリプション、消耗型アイテム、永続アクセス)
  • ペイウォール – どのプロダクトを提供するかを定義する設定。Adaptyでは、ペイウォールがプロダクトを取得する唯一の手段ですが、この設計によりアプリのコードを変更することなくプロダクト・価格・オファーを変更できます。
  • プレースメント – アプリのどこでどのタイミングでペイウォールを表示するか(mainonboardingsettingsなど)。ダッシュボードでプレースメントにペイウォールを設定し、コード内ではプレースメントIDで取得します。これにより、A/Bテストの実施や、ユーザーごとに異なるペイウォールの表示が簡単に行えます。

カスタムペイウォールを使用する場合でも、これらの概念を理解しておいてください。基本的には、アプリで販売するプロダクトを管理するための仕組みです。

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

ユーザーの管理

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

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

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

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

  1. getPaywallメソッドにプレースメントIDを渡してpaywallオブジェクトを取得する。
  2. getPaywallProductsメソッドを使用して、このペイウォールのプロダクト配列を取得する。

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

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

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

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

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

次のステップ

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

ペイウォールをアプリに表示する準備が整いました。Google Play Storeでの購入テストを行い、ペイウォールからテスト購入が完了できることを確認してください。本番対応の実装例については、サンプルアプリのProductListFragment.ktをご覧ください。適切なエラーハンドリング、UIフィードバック、サブスクリプション管理を含む購入処理のデモが確認できます。

次に、ユーザーが購入を完了したかどうかを確認し、ペイウォールを表示するか有料機能へのアクセスを許可するかを判断してください。