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