Миграция на флоу

В Adapty флоу объединяет онбординг и пейвол в единую сущность за одним плейсментом. Флоу заменяет отдельные онбординг и пейвол, которые вы создаёте и показываете независимо друг от друга.

В этом гайде объясняется, что меняется при переходе на флоу и как выполнить этот переход, не нарушая работу у пользователей со старыми версиями приложения.

Флоу и отдельные онбординги с пейволами

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

Флоу заменяет оба инструмента одним опытом — вводные экраны, квиз и экран покупки — собранным в одном редакторе и поставляемым из одного плейсмента. Этот плейсмент создаётся новый: флоу — отдельный тип контента, поэтому он не может использовать плейсменты для онбординга или пейвола, которые он заменяет.

В таблице ниже показано, что даёт каждый из вариантов:

Стоит ли переходить на флоу?

Если вы строите проект надолго, флоу — более надёжная основа — переходите на них, когда это вписывается в ваш релизный цикл.

Как выполнить миграцию

Миграция состоит из четырёх шагов. Основная часть работы — это единовременное обновление SDK: создание и предпросмотр флоу выполняются без написания кода.

1. Создайте флоу: Конвертируйте существующий пейвол в один клик или создайте флоу из шаблона — разработчик не нужен.
2. Проверьте на устройстве: Просмотрите флоу на реальном устройстве через мобильное приложение Adapty — сборка приложения не нужна.
3. Создайте новый плейсмент для флоу: Создайте новый плейсмент флоу с уникальным ID и решите, как он будет сосуществовать с существующими плейсментами.
4. Обновите 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. Затем в Flow & Paywall Builder нажмите Test on device, выберите локаль и отсканируйте QR-код с устройства. Вы увидите реальные экраны, ветвление, тексты и дизайн.

Создайте новый плейсмент для вашего флоу

Флоу, пейволы и онбординги — это три разных типа контента, и каждый из них измеряется собственным набором метрик. Именно поэтому плейсмент обслуживает только один тип. Тип плейсмента фиксируется при создании, поэтому конвертировать существующий плейсмент онбординга или пейвола в плейсмент флоу не получится (см. типы плейсментов). Для каждого флоу нужен собственный новый плейсмент.

Не обязательно переводить все места в флоу сразу. В 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.