Миграция на флоу
В Adapty флоу объединяет онбординг и пейвол в единую сущность за одним плейсментом. Флоу заменяет отдельные онбординг и пейвол, которые вы создаёте и показываете независимо друг от друга.
С 1 октября 2026 года создавать и редактировать пейволы и онбординги в устаревших билдерах будет невозможно, а их поддержка прекратится. Всё, что у вас уже есть, продолжит работать — смотрите что изменится в эту дату.
Этот гайд объясняет, что меняется при переходе на флоу и как провести это изменение без сбоев для пользователей старых версий приложения.
Флоу требуют Adapty SDK v4.0 или выше.
Флоу vs. онбординги и пейволы
С отдельными онбордингами и пейволами вы поддерживаете два билдера и два плейсмента. Переход пользователя от онбординга к пейволу приходится обрабатывать в собственном коде.
Флоу заменяет оба — вводные экраны, квиз и экран покупки — собраны в одном редакторе и отдаются из одного плейсмента.
В таблице ниже сравниваются оба варианта:
| Флоу | Пейвол в Paywall Builder | Онбординг | |
|---|---|---|---|
| Несколько экранов | Да | Нет — один экран | Да |
| Отрисовка | Нативная | Нативная | WebView |
| Продукты и плейсмент | Один плейсмент; продукты добавляются непосредственно во флоу | Один плейсмент; продукты добавляются непосредственно в пейвол | Один плейсмент, но собственных продуктов нет — для продаж нужно создать отдельный пейвол и подключить его через отдельный плейсмент |
Стоит ли переходить на флоу?
Если вы строите продукт на перспективу, флоу — более надёжная основа — переходите на них, когда это вписывается в ваш план релизов.
Как выполнить миграцию
Миграция состоит из четырёх шагов. Основная часть работы — это разовое обновление SDK: создание и предпросмотр флоу не требуют написания кода.
- Создайте флоу: Конвертируйте существующий пейвол в один клик или создайте флоу из шаблона — без участия разработчика.
- Проверьте на устройстве: Посмотрите, как выглядит флоу на реальном устройстве через мобильное приложение Adapty — без сборки приложения.
- Создайте новый плейсмент для флоу: Создайте новый плейсмент для флоу с уникальным ID и определите, как он будет сосуществовать с существующими плейсментами.
- Обновите SDK: Обновитесь до Adapty SDK v4, загрузите флоу из плейсмента и проверьте покупку в песочнице. Это основная задача разработчика.
Создайте свой флоу
Если ваш пейвол был создан в старом Paywall Builder, вы можете конвертировать его в флоу вместо того, чтобы пересобирать вручную. В противном случае можно воспользоваться готовым шаблоном или создать флоу с нуля. Подробнее о флоу и Paywall Builder:
- Документация по Flow builder: Подробное описание возможностей билдера и того, что в нём можно создать.
- Типовые рецепты для флоу: Пошаговые гайды по наиболее распространённым экранам.
- Ask AI: Используйте чат на любой странице документации, если зашли в тупик.
Превью на устройстве
Вы можете просмотреть флоу на реальном устройстве, не трогая приложение. Скачайте мобильное приложение Adapty для iOS или Android. Затем в конструкторе флоу нажмите Test on device, выберите локаль и отсканируйте QR-код с устройства. Вы увидите реальные экраны, ветвление, тексты и дизайн.
В режиме предпросмотра Adapty не может получить информацию о ваших продуктах из сторов, поэтому отображаемые цены ненастоящие. Реальные покупки проверяются позже — в сборке v4 с аккаунтом песочницы. Подробнее: Обновление SDK.
Создайте новый плейсмент для вашего флоу
Плейсмент обслуживает только один тип контента — флоу, пейвол или онбординг. Преобразовать существующий плейсмент онбординга или пейвола в плейсмент флоу нельзя (см. типы плейсментов). Для флоу нужен отдельный новый плейсмент.
Присвойте новому плейсменту флоу полностью уникальный идентификатор. Он не может совпадать с идентификатором существующего плейсмента пейвола или онбординга.
Не отключайте старые плейсменты во время перехода Пользователи на старых версиях приложения имеют ID плейсментов онбординга и пейвола, скомпилированные в приложении. Они продолжают вызывать методы онбординга и пейвола и видят ваши существующие онбординг и пейвол до обновления. Выводите старые плейсменты из эксплуатации только после того, как уровень принятия SDK v4 станет достаточно высоким.
Вам не нужно переводить все плейсменты на флоу сразу. В SDK v4 метод getFlow получает данные как из плейсментов с флоу, так и из плейсментов с пейволами, поэтому в приложении везде вызывается один и тот же метод. Оставьте пейволы Paywall Builder там, где они вам нужны, а флоу используйте в остальных плейсментах.
В переходный период каждый тип плейсмента отслеживает собственные метрики. Пока в работе находятся и старая, и новая версии приложения, данные распределяются между двумя наборами плейсментов. Старые плейсменты онбординга и пейвола охватывают более ранние версии; новый плейсмент флоу — SDK v4+. Сравнивайте их как отдельные когорты и ожидайте, что доля плейсмента флоу будет расти по мере обновления пользователей.
Вы можете проводить A/B-тесты с флоу: запустите обычный A/B-тест на нескольких вариантах флоу в плейсменте флоу. Кросс-плейсментные A/B-тесты пока доступны только для пейволов, поэтому запустить их на плейсментах флоу пока нельзя. Сравнение нового флоу со старым пейволом — это сравнение когорт, а не единый тест: они находятся на разных типах плейсментов.
Обновите SDK
Когда плейсмент для флоу готов, укажите на него в приложении. Флоу отображаются только в Adapty SDK v4 и выше. Обновите SDK и получите флоу из нового плейсмента с помощью getFlow. Ознакомьтесь с гайдом по миграции на v4 для вашей платформы — iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform или Capacitor — чтобы узнать конкретные шаги обновления.
После подключения флоу проверьте его так же, как любой другой флоу покупки: запустите на устройстве или симуляторе и совершите покупку в песочнице, чтобы убедиться, что продукты, покупка и уровень доступа работают корректно. Смотрите гайд по тестированию для вашей платформы: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform или Capacitor.
Флоу видят только пользователи, которые установили приложение с SDK v4+. Те, кто использует более старую версию приложения, по-прежнему видят прежние онбординг и пейвол — поэтому старые плейсменты остаются активными в период перехода.
