独自の決済システムでAdaptyフローを使用する

Adaptyのフローを使用するために、購入処理をAdaptyに移行する必要はありません。Observerモードでは、既存のコードがすべての購入処理を行いつつ、Adaptyがペイウォールまたはオンボーディングのレンダリング、表示対象ユーザーの決定、A/Bテスト、および結果のレポートを担当します。

このガイドでは、変わる点、変わらない点、そしてセットアップに必要なことを説明します。

Tip

フローを初めて使いますか?フロー & ペイウォールビルダーでは、実装前に作れるものを紹介しています。

あなたのコードが担うこと、Adaptyが担うこと

あなたのコードが担う処理:

  • 購入の呼び出し
  • トランザクションの完了と確認
  • アクセスの付与と取り消し
  • 更新と請求の再試行

Adaptyが担う処理:

課金に関するコードは何も変わりません。Adaptyがフローをレンダリングし、購入タップをあなたのコードに渡すと、あなたのコードが決済を処理します。

Adapty でプロダクトを作成する

フロー内のどの画面でも価格を表示したり購入を行わない場合は、このセクションをスキップしてください。オンボーディング画面だけのフローには、Adapty のプロダクトは不要です。

画面にプロダクトが表示される場合は、提供するサブスクリプションや買い切り購入ごとに Adapty でプロダクトを作成してください。フローはカードの価格をプロダクトから読み取るため、カードには現在のストア価格が表示され、その価格を A/B テストしたり、Adapty がアナリティクスでプロダクト別に収益を集計したりできます。

Adapty のプロダクトはすでに販売しているストアのプロダクトを参照しているため、プロダクトを作成しても課金は発生しません。すべての請求処理はあなたのコードが行います。各プロダクトにはアクセスレベルを指定する必要があります。Observer モードでは Adapty はアクセスを付与しません(アクセス管理はあなたのコードが行います)が、それでもプロダクトにはアクセスレベルが必要です。

Adapty CLI を使うと、ダッシュボードを開かずにプロダクトを作成できます。Node.js 18 以降をインストールし、サインインしてください:

npm install -g adapty
adapty auth login

アプリ ID と、紐付けるアクセスレベルを取得します。新しいアプリにはデフォルトで premium アクセスレベルが用意されています:

adapty apps list
adapty access-levels list --app <app-id>

次に、App Store Connect と Google Play Console のプロダクト ID を使用して、販売するストアプロダクトごとに Adapty プロダクトを作成します:

adapty products create --app <app-id> --title "Monthly" --access-level-id <access-level-id> --period monthly --ios-product-id com.example.monthly --android-product-id com.example.monthly --android-base-plan-id monthly

買い切り購入の場合は --period lifetime を渡し、ウェブで販売するものには --stripe-product-id と --stripe-price-id(または Paddle の対応するペア)を指定します。すべてのフラグは products create に一覧があります。作成後にストアのプロダクト ID は変更できないため、別のストアプロダクトを指定する場合は新しいプロダクトを作成する必要があります。

Warning

プロダクト要素に何も割り当てていないと、保存・公開がブロックされるため、ビルダー上で気づくことができます。一方、Purchase アクションにプロダクトが設定されていない場合は保存できますが、デバイス上では失敗します(ボタンが何もしない)。すべての Purchase アクションにプロダクトを設定してください。

プロダクトをスキップして価格を静的テキストとして記述する場合

プロダクト要素がないフローは保存・公開できるため、テキストに価格を直接入力して、タップ時に何を購入するかは独自のコードで判断させることができます。その場合のデメリットは次のとおりです:

  • ストアとフローのテキストの2か所に価格を保持する必要があり、どちらかを変更した時点でズレが生じます。
  • 価格の A/B テストができません。これはフローの主な用途です。
  • Adapty はあなたが報告したトランザクションからプロダクトを把握するため、チャートやインテグレーションでの売上のグループ化が不明確になります。
  • タップされた要素をプロダクトにマッピングするコードが必要で、フローからプロダクトを受け取ることができません。

セットアップ方法

  1. SDKをオブザーバーモードで有効化する。 SDK設定時に observerMode をオンにします: iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。
  2. AdaptyでプロダクトをSDKで作成する。 フロー内に価格表示がない場合を除き必要です。プロダクトごとにCLIコマンドを1つ実行します — Adaptyでプロダクトを作成するを参照してください。
  3. フローを構築する。 画面についてはフロー&ペイウォールビルダーを参照し、ペイウォール画面のプロダクトについては購入のセットアップを、フローをアプリ内のどこに表示するかについてはプレースメントの作成を参照してください。
  4. 自分のコードでフローを表示し、購入を実行する。 購入タップはAdaptyから登録したハンドラーに渡されます。
  5. トランザクションを報告する。 購入したプロダクトのペイウォールバリアントIDを使って報告することで、購入データがそのペイウォールに帰属したアナリティクスに反映されます。

ステップ4と5はプラットフォームごとに異なります。各スニペットで、flowはプレースメントに対して取得したAdaptyFlow、productはユーザーがタップしたAdaptyPaywallProduct、myPurchaseApiまたはyourBillingClientはすでに持っている購入コードの代わりです。

オブザーバーモードの制限

  • Adapty はアクセスを付与しません: 購入イベントに応じてアクセスの付与や制限を行わず、更新や請求の再試行も処理しません。アクセスレベルの管理はあなた自身のコードが担います。
  • トランザクションの完了はあなたのコードが行います: Adapty はあなたのコードが行った購入を完了・確認しないため、各トランザクションのクローズはあなたの責任です。
  • レポートは省略できません: レポートと共に渡す variationId は、購入とそれを生み出したフローを結びつける唯一の手がかりです。すべてのトランザクションをレポートしないと、フローの指標や A/B テストの結果が不正確になります。

別のベンダーをすでに使っている場合

オブザーバーモードで必要なのは、コードで購入処理を行うことだけです。どのSDKを使って処理するかは関係ありません。RevenueCat、Superwall、Qonversionの上でも、自前のStoreKitやBilling Libraryコードの上でも、フローは同じように動作します。

リリース前に決めておくべき3つのポイント:

  • 1つのシステムがトランザクションを完結させる: 2つのSDKが同じ購入を両方で完結させようとすることが、最もよくある失敗です。
  • 1つのシステムがアクセスを管理する: Observerモードでは Adapty は何も付与しないため、アクセスレベルはそのままにしておいてください。
  • 各購入を1回だけ報告する: 同じトランザクションを2か所から報告すると、分析データが歪みます。

他のベンダーから完全に移行する場合は、RevenueCatからの移行またはSuperwallからの移行を参照してください。

代わりにAdaptyで購入処理を行う

Tip

ここではアプリがAdaptyを通じて購入を行うため、コード側は通常のAdaptyインテグレーションになります。クイックスタートやRevenueCatからの移行を参照するか、SDKインテグレーションスキルに任せてください。

オブザーバーモードは最も手軽な導入方法です。RevenueCatのアナリティクスを維持しつつオブザーバーモードの制限を回避したい場合は、両者の役割を入れ替えてください。Adaptyがフルモードで動作してすべての購入処理を行い、RevenueCatは独自のオブザーバーモードで動作してAdaptyが行った購入を記録します。

これにより、各課金がどのフロー、プレースメント、A/B テストのバリアントから発生したかをAdaptyが把握し、アクセスレベルの付与、更新処理、請求リトライ、返金対応を行います。

RevenueCat側では、SDKを設定する際に purchasesAreCompletedBy をアプリ側に設定してください。iOSでは .myApp、Androidでは MY_APP を使用します。RevenueCatのUsing the SDK with your own IAP codeには、各プラットフォームの設定方法、iOSが必要とするStoreKitのバージョン、および既存の購入履歴を取り込む syncPurchases() の呼び出し方が記載されています。AdaptyとRevenueCatの両方のSDKに同じユーザーIDを渡してください。AdaptyのカスタマーユーザーIDとRevenueCatの appUserID を一致させないと、2つのダッシュボードで異なるユーザーを参照することになります。

Warning

この設定により、RevenueCat のエンタイトルメントが信頼できる情報源としての役割を終え、Adapty のアクセスレベルがその役割を引き継ぎます。RevenueCat は引き続き監視を続け、ダッシュボードでのレポートも継続しますが、各購入情報は間接的に取得されるようになり、RevenueCat 自身のドキュメントに記載されているカバレッジ制限の範囲内での動作となります。現在 RevenueCat のエンタイトルメントを参照しているもの(アプリ、バックエンド、Web やデスクトップのビルドなど)はすべて、Adapty への移行またはコピーの参照が必要です。リリース前にこの点を整理しておいてください。その他は変更ありません。RevenueCat のアカウント、履歴、インテグレーションはすべてそのまま維持されます。