Connect FunnelFox to Adapty

FunnelFox builds web funnels: landing pages and quizzes that sell your subscriptions outside the App Store and Google Play. Connect FunnelFox to Adapty to give web buyers access to paid features in your mobile app, and to see their purchases in the same dashboard as your store purchases.

Connecting takes one key and one access level ID. Your app must then identify the buyer to reach that access level. See Provide access in your app.

How the integration works

FunnelFox collects the payment on the web. FunnelFox then calls the Adapty Server-side API to create the profile, record the transaction, and grant the access level whose ID you enter in the FunnelFox integration settings. Renewals, cancellations, and failed payments update the same profile. Web purchases appear in Adapty analytics alongside your App Store and Google Play revenue.

Adapty links a web purchase to an app user by customer user ID. FunnelFox uses the email address entered at checkout as that ID by default.

To build the same flow against your own web checkout instead of a FunnelFox funnel, see Sync purchases between web and mobile.

Connect FunnelFox

You set the connection up on the FunnelFox side, following FunnelFox’s Adapty integration guide. It asks for two values from Adapty:

• Secret API key: Open App Settings in Adapty and copy the secret key.
• Access level ID: The access level to grant. You can also set one per checkout element, as described in Set the access level on each checkout element.

Set the access level on each checkout element

In FunnelFox, the Custom entitlement field on a checkout element sets which Adapty access level a purchase through that element grants. Every Adapty app starts with a premium access level; to grant a different one, create it first.

Set the field on every checkout element in the funnel. A funnel can hold more than one, such as a Wallet button and an accordion checkout, and each has its own Custom entitlement field.

Provide access in your app

To unlock paid features for a web buyer, call Adapty.activate() or Adapty.identify() with the same customer user ID that FunnelFox used. By default, that ID is the email address the buyer entered at checkout. See Identifying users iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, and Capacitor for the call.

Installing the app from a link in the funnel does not identify the buyer. Until your app calls Adapty.identify() with the matching ID, the profile holding the access level and the profile the app created stay separate, and the app shows no paid access. Signing in with the checkout email matches the two.

To unlock access without a sign-in step, pass the customer user ID from the funnel to the app through a deferred deep link, then call Adapty.identify() with that ID on first launch.

Then read the access level from the profile to unlock the features. See Checking subscription status iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, and Capacitor .

Test the integration

1. Complete a purchase in your funnel.
2. In Adapty, open Profiles and find the profile by the customer user ID FunnelFox used.
3. Confirm the access level whose ID you entered in the FunnelFox integration settings is active on that profile.
4. Open your app, identify the same user, and confirm the paid features unlock.

Troubleshooting

A web buyer opens the app without paid access

Your app hasn’t identified the buyer. FunnelFox granted the access level to a profile keyed by the ID it used, which is the checkout email by default, and your app is reading a different profile. Call Adapty.identify() with that ID, as described in Provide access in your app.

Other FunnelFox integrations

FunnelFox connects to three Adapty products, each set up separately.