Веб-пейвол

С помощью Adapty вы можете создать пейвол или флоу с кнопкой, которая перенаправляет пользователей в браузер для оплаты. После успешной покупки пользователь возвращается в приложение, и подписка активируется. Это позволяет обойти комиссию стора и при этом отслеживать платежи пользователей.

Как это работает

Веб-пейвол — это уникальный URL, который генерируется для каждого из ваших встроенных пейволов. Он открывается в браузере для оплаты и работает с различными платёжными провайдерами (Stripe, Paddle и другими), поддерживая как простую страницу с кнопкой Apple Pay, так и более сложные флоу с дополнительными предложениями.

Веб-пейволы работают следующим образом:

1. Настройте внешний вид веб-пейвола и его поведение в редакторе.
2. Привяжите веб-пейвол в настройках пейвола.
3. В пейволе приложения добавьте кнопку, перенаправляющую пользователей в браузер.
4. Когда пользователи нажимают кнопку, Adapty SDK генерирует уникальный URL, содержащий Adapty profile ID пользователя.
5. Пользователи переходят на страницу веб-пейвола и оплачивают подписку через внешний способ оплаты.
6. При возвращении в приложение Adapty SDK проверяет обновления профиля, чтобы подтвердить активацию подписки.
7. Adapty фиксирует покупку и отслеживает статус подписки: продления, отмены и другие изменения.

Идентификатор профиля в URL связывает веб-покупку с пользователем приложения. Покупка привязывается к профилю, который уже используется в вашем приложении, поэтому вызывать Adapty.identify() для веб-покупателя не нужно.

Шаг 1. Создайте веб-пейвол

1. Подготовьте пейвол:
   • Чтобы добавить внешние платежи к существующему пейволу, дублируйте его. Так вы сможете показывать веб-пейвол нужному сегменту, а оригинал — всем остальным.
   • Чтобы начать с нуля, создайте новый пейвол.
2. На странице пейвола перейдите на вкладку Web paywall и нажмите Create web paywall. Вы будете перенаправлены на новую страницу.

3. Настройте веб-пейвол и подключите способ оплаты.

4. Вернитесь на страницу Web paywall и вставьте ссылку на пейвол.

5. Нажмите Save.

Шаг 2. Запуск пейвола

Чтобы использовать ваш веб-пейвол, его нужно запустить — способ зависит от вашей конфигурации:

• Если вы используете Flow & Paywall Builder, достаточно добавить новую кнопку, которая будет использовать указанную вами ссылку для отслеживания покупок и отправки данных обратно в Adapty.
• Если вы используете SDK, необходимо настроить метод openWebPaywall для обработки веб-пейволов.

Шаг 2a. Добавьте кнопку веб-покупки

Если вы используете Flow & Paywall Builder, нужно добавить кнопку веб-пейвола. Кнопка будет использовать указанную вами ссылку для отслеживания покупок и передачи данных в Adapty.

1. Откройте флоу и добавьте кнопку.

   Если вы используете шаблон или существующий пейвол, добавьте кнопку веб-пейвола рядом с существующей кнопкой покупки. Настроить её можно точно так же.

2. На панели Interactions справа нажмите Add trigger. Затем назначьте этому триггеру действие Purchase.

   

3. В настройках действия перейдите на вкладку Web payment. Там выберите продукт и — при необходимости — оффер, который будет связан с кнопкой веб-покупки.

4. Вставьте ссылку на веб-пейвол в поле Web paywall URL.

5. По умолчанию веб-пейволы открываются во встроенном браузере, чтобы пользователи не покидали ваше приложение. Если вы хотите открывать их во внешнем браузере, выберите Open in external browser.

Шаг 2б. Вызовите метод SDK

Если вы работаете с пейволом, разработанным самостоятельно, необходимо обработать веб-пейволы через метод SDK. Ознакомьтесь с гайдами для конкретных платформ:

• iOS
• Android
• React Native
• Flutter
• Unity

Шаг 3. Настройте плейсмент

Поскольку App Store разрешает внешние способы оплаты только в США и Японии, создайте отдельный сегмент пользователей для iOS-пользователей в этих регионах и настройте плейсмент так, чтобы разные пейволы показывались разным сегментам. Для Android-пользователей географических ограничений нет — создайте отдельный Android-сегмент без фильтра по стране.

1. Создайте новый сегмент со следующими атрибутами:
   • Country from store account: United States, Japan
   • Platform: iOS and iPadOS
   • App version: последняя версия, использующая Adapty SDK.

2. Создайте плейсмент или отредактируйте существующий. Добавьте новую аудиторию с веб-пейволом и созданным сегментом.

Добавление воронки отмены

Воронка отмены — это веб-страница, которую подписчик открывает, чтобы отменить подписку. Прежде чем отмена вступит в силу, воронка может предложить паузу, скидку или бесплатный период. Вы создаёте её в том же редакторе, что и веб-пейвол, а приложение открывает её по URL. Воронка отменяет подписку напрямую через платёжного провайдера, так что приложению не нужно делать никаких API-вызовов для отмены.

Чтобы создать воронку отмены, откройте вкладку Cancellation в редакторе веб-пейвола. Действия по удержанию доступны только в воронках отмены — добавить их в воронку, обслуживающую веб-пейвол, нельзя. Подробнее о самой воронке читайте в гайде FunnelFox по воронкам отмены.

Получите ID профиля подписчика в FunnelFox

Воронка отмены идентифицирует подписчика по его ID профиля FunnelFox. После покупки веб-подписки FunnelFox записывает этот ID в профиль Adapty как пользовательский атрибут fnlfx_profile_id, вместе с fnlfx_funnel_id, fnlfx_session_id, vendor_profile_id и vendor.

FunnelFox записывает эти атрибуты один раз — при первой покупке веб-подписки. Последующие покупки не изменяют их. Для расходуемой покупки FunnelFox записывает их только в том случае, если у элемента оформления заказа есть пользовательский уровень доступа.

Ваше приложение считывает fnlfx_profile_id из customAttributes профиля пользователя. Чтобы увидеть это же значение в Adapty, откройте Profiles и найдите профиль пользователя.

Открытие флоу из приложения

Приложение само формирует URL отмены подписки. Он не указывается в поле Web paywall URL — это поле предназначено для пейвола, который продаёт продукт, и Adapty добавляет к нему adapty_profile_id, а не fpid.

Объедините опубликованный URL флоу отмены с fnlfx_profile_id подписчика:

https://<your-project>.fnlfx.com/cancel?fpid=<fnlfx_profile_id>

Передайте значение атрибута в том виде, в котором оно хранится, без каких-либо префиксов. Откройте URL, когда пользователь нажимает кнопку отмены.

Пользователи могут закрыть страницу в любой момент, в том числе после того, как флоу отменит подписку. Не воспринимайте их возврат в приложение как подтверждение. Запросите профиль, чтобы получить актуальное состояние. Отменённая подписка сохраняет уровень доступа до конца оплаченного периода.