---
title: "FunnelFoxをAdaptyに接続する"
description: "FunnelFoxのウェブファネルをAdaptyに接続して、ウェブで購入したユーザーがモバイルアプリ内でアクセスレベルを取得できるようにします。"
---

> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skill. Claude Code (self-updating via plugin): `claude plugin marketplace add adaptyteam/adapty-skills && claude plugin install adapty-skills@adapty` — other tools: `npx skills add adaptyteam/adapty-skills --all`

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

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

## インテグレーションの仕組み \{#how-the-integration-works\}

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

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

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

## FunnelFox を接続する \{#connect-funnelfox\}

接続の設定は FunnelFox 側で行います。[FunnelFox の Adapty インテグレーションガイド](https://funnelfox.com/docs/integrations/subscription-management/adapty#setup)に従って進めてください。Adapty から以下の 2 つの値が必要です：

- **Secret API key**：Adapty の [**App Settings**](https://app.adapty.io/settings/general) を開き、シークレットキーをコピーしてください。
- **Access level ID**：付与する[アクセスレベル](access-level)です。[各チェックアウト要素にアクセスレベルを設定する](#set-the-access-level-on-each-checkout-element)で説明されているように、チェックアウト要素ごとに個別に設定することもできます。

## 各チェックアウト要素にアクセスレベルを設定する \{#set-the-access-level-on-each-checkout-element\}

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

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

:::important
インテグレーション設定や**Custom entitlement**の値を変更した後は、フローを再公開してください。公開済みのフローは、再公開するまで以前の設定を使い続けます。
:::

## アプリ内でアクセスを付与する \{#provide-access-in-your-app\}

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

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

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

次に、プロファイルからアクセスレベルを読み取り、機能を解放します。詳しくは <InlineTooltip tooltip="サブスクリプションステータスの確認">[iOS](ios-check-subscription-status)、[Android](android-check-subscription-status)、[React Native](react-native-check-subscription-status)、[Flutter](flutter-check-subscription-status)、[Unity](unity-check-subscription-status)、[Kotlin Multiplatform](kmp-check-subscription-status)、[Capacitor](capacitor-check-subscription-status)</InlineTooltip> をご覧ください。

## インテグレーションをテストする \{#test-the-integration\}

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

## トラブルシューティング \{#troubleshooting\}

### ウェブで購入したユーザーがアクセス権なしでアプリを開く \{#a-web-buyer-opens-the-app-without-paid-access\}

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

## その他の FunnelFox 連携 \{#other-funnelfox-integrations\}

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

| プロダクト | FunnelFox が Adapty に送信するデータ | セットアップガイド |
|---|---|---|
| Core | プロファイル、トランザクション、アクセスレベル（Web での購入がアプリで有効になります） | この記事 |
| Adapty Attribution | キャンペーン、ファネル、実験データを含むトランザクションイベント | [FunnelFox と Adapty Attribution の連携](ua-funnelfox) |
| Adapty Mail | メールアドレス、購入履歴、サブスクリプションイベント | [FunnelFox を Adapty Mail に接続する](mail-funnelfox) |