FunnelFoxをAdaptyに接続する

FunnelFoxはウェブファネルを構築するツールです。App StoreやGoogle Play以外でサブスクリプションを販売するランディングページやクイズを作成できます。FunnelFoxをAdaptyに接続することで、ウェブ購入者がモバイルアプリの有料機能にアクセスできるようになり、ストアでの購入と同じダッシュボードでウェブ購入も確認できます。

接続にはキーが1つとアクセスレベルIDが1つ必要です。その後、アプリはそのアクセスレベルに到達した購入者を識別する必要があります。アプリでアクセスを提供するを参照してください。

インテグレーションの仕組み

FunnelFox はウェブ上で決済を処理します。その後、FunnelFox が Adapty サーバーサイド API を呼び出してプロファイルを作成し、トランザクションを記録し、FunnelFox のインテグレーション設定で指定した ID のアクセスレベルを付与します。更新・キャンセル・決済失敗が発生した場合も、同じプロファイルが更新されます。ウェブ購入は App Store および Google Play の売上と並んで Adapty アナリティクスに表示されます。

Adapty は、カスタマーユーザーIDを使って、ウェブ購入とアプリユーザーを紐付けます。FunnelFox はデフォルトで、チェックアウト時に入力されたメールアドレスをそのIDとして使用します。

独自のウェブチェックアウトで同じフローを構築する場合は、ウェブとモバイル間での購入の同期を参照してください。

FunnelFox を接続する

接続の設定は FunnelFox 側で行います。FunnelFox の Adapty インテグレーションガイドに従って進めてください。Adapty から以下の 2 つの値が必要です：

• Secret API key：Adapty の App Settings を開き、シークレットキーをコピーしてください。
• Access level ID：付与するアクセスレベルです。各チェックアウト要素にアクセスレベルを設定するで説明されているように、チェックアウト要素ごとに個別に設定することもできます。

各チェックアウト要素にアクセスレベルを設定する

FunnelFox では、チェックアウト要素の Custom entitlement フィールドで、その要素を通じた購入がどの Adapty アクセスレベルを付与するかを設定します。すべての Adapty アプリは premium アクセスレベルから始まります。別のアクセスレベルを付与したい場合は、まず作成してください。

ファネル内のすべてのチェックアウト要素にこのフィールドを設定してください。ファネルには、ウォレットボタンとアコーディオンチェックアウトなど、複数のチェックアウト要素を含めることができ、それぞれに独自の Custom entitlement フィールドがあります。

アプリ内でアクセスを付与する

ウェブ購入者に有料機能を解放するには、FunnelFox が使用したものと同じ顧客ユーザー ID で Adapty.activate() または Adapty.identify() を呼び出します。デフォルトでは、この ID はチェックアウト時に購入者が入力したメールアドレスです。呼び出し方法については ユーザーの識別 iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor を参照してください。

ファネル内のリンクからアプリをインストールしても、購入者は自動的に識別されません。アプリが対応するIDで Adapty.identify() を呼び出すまで、アクセスレベルを保持するプロファイルとアプリが作成したプロファイルは別々のままとなり、アプリには有料アクセスが表示されません。チェックアウト時のメールアドレスでサインインすることで、この2つが紐付けられます。

サインインのステップなしにアクセスを解除するには、ファネルからのカスタマーユーザーIDを遅延ディープリンク経由でアプリに渡し、初回起動時にそのIDで Adapty.identify() を呼び出してください。

次に、プロファイルからアクセスレベルを読み取り、機能を解放します。詳しくは サブスクリプションステータスの確認 iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor をご覧ください。

インテグレーションをテストする

1. ファネル内で購入を完了する。
2. Adapty で Profiles を開き、FunnelFox が使用しているカスタマーユーザー ID でプロファイルを検索する。
3. FunnelFox のインテグレーション設定で入力したアクセスレベルの ID が、そのプロファイルで有効になっていることを確認する。
4. アプリを開き、同じユーザーを特定して、有料機能のロックが解除されていることを確認する。

トラブルシューティング

ウェブで購入したユーザーがアクセス権なしでアプリを開く

アプリがその購入者を識別できていません。FunnelFox はデフォルトでチェックアウト時のメールアドレスをキーとしたプロファイルにアクセスレベルを付与しましたが、アプリは別のプロファイルを参照しています。アプリでアクセスを提供するの説明に従って、そのIDで Adapty.identify() を呼び出してください。

その他の FunnelFox 連携

FunnelFox は Adapty の 3 つのプロダクトと連携しており、それぞれ個別にセットアップが必要です。