Подключение FunnelFox к Adapty

FunnelFox создаёт веб-воронки: лендинги и квизы, которые продают ваши подписки за пределами App Store и Google Play. Подключите FunnelFox к Adapty, чтобы пользователи, совершившие покупку в интернете, получали доступ к платным функциям в вашем мобильном приложении, а их покупки отображались в том же дашборде, что и покупки из сторов.

Подключение требует один ключ и один идентификатор уровня доступа. После этого ваше приложение должно идентифицировать покупателя, чтобы предоставить ему этот уровень доступа. См. Предоставление доступа в приложении.

Как работает интеграция

FunnelFox собирает оплату на сайте. Затем FunnelFox вызывает Server-side API Adapty, чтобы создать профиль, записать транзакцию и предоставить уровень доступа, ID которого вы указываете в настройках интеграции FunnelFox. Продления, отмены и неудачные платежи обновляют тот же профиль. Веб-покупки отображаются в аналитике Adapty рядом с доходами из App Store и Google Play.

Adapty связывает веб-покупку с пользователем приложения по customer user ID. FunnelFox по умолчанию использует в качестве этого ID адрес электронной почты, введённый при оформлении заказа.

Чтобы реализовать аналогичный флоу с вашим собственным веб-чекаутом вместо воронки FunnelFox, см. Синхронизация покупок между вебом и мобильным приложением.

Подключение FunnelFox

Подключение настраивается на стороне FunnelFox по инструкции по интеграции FunnelFox с Adapty. Там потребуется указать два значения из Adapty:

• Secret API key: Откройте App Settings в Adapty и скопируйте секретный ключ.
• Access level ID: Уровень доступа, который нужно предоставить. Также можно задать отдельный уровень для каждого элемента чекаута — подробнее в разделе Настройка уровня доступа для каждого элемента чекаута.

Укажите уровень доступа для каждого элемента оформления заказа

В FunnelFox поле Custom entitlement на элементе оформления заказа определяет, какой уровень доступа Adapty предоставляет пользователю при покупке через этот элемент. В каждом приложении Adapty по умолчанию есть уровень доступа premium; чтобы предоставить другой, сначала создайте его.

Укажите это поле для каждого элемента оформления заказа в воронке. В одной воронке может быть несколько таких элементов — например, кнопка Wallet и аккордеон с оформлением заказа, — и у каждого есть своё поле Custom entitlement.

Предоставьте доступ в своём приложении

Чтобы открыть платные функции для пользователя, совершившего покупку через веб, вызовите Adapty.activate() или Adapty.identify() с тем же customer user ID, который использовал FunnelFox. По умолчанию это адрес электронной почты, введённый покупателем при оформлении заказа. Подробнее о вызове смотрите в разделах Идентификация пользователей iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform и Capacitor .

Установка приложения по ссылке из воронки не идентифицирует покупателя. Пока ваше приложение не вызовет Adapty.identify() с совпадающим ID, профиль с уровнем доступа и профиль, созданный приложением, остаются разделёнными, и приложение не показывает платный доступ. Вход через email, указанный при оплате, совмещает эти два профиля.

Чтобы открыть доступ без шага авторизации, передайте customer user ID из воронки в приложение через отложенный диплинк, затем вызовите Adapty.identify() с этим ID при первом запуске.

Затем считайте уровень доступа из профиля, чтобы открыть нужные функции. Подробнее — Проверка статуса подписки iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform и Capacitor .

Проверьте интеграцию

1. Совершите покупку в вашей воронке.
2. В Adapty откройте Profiles и найдите профиль по customer user ID, который использует FunnelFox.
3. Убедитесь, что уровень доступа, ID которого вы указали в настройках интеграции FunnelFox, активен на этом профиле.
4. Откройте приложение, авторизуйтесь под тем же пользователем и убедитесь, что платные функции разблокированы.

Устранение неполадок

Пользователь, купивший подписку через веб, открывает приложение без доступа

Ваше приложение не идентифицировало покупателя. FunnelFox предоставил уровень доступа профилю, привязанному к ID, который он использовал — по умолчанию это email, указанный при оформлении заказа, — а ваше приложение читает другой профиль. Вызовите Adapty.identify() с этим ID, как описано в разделе Предоставление доступа в приложении.

Другие интеграции FunnelFox

FunnelFox подключается к трём продуктам Adapty, каждый из которых настраивается отдельно.