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

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

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

Флоу vs. онбординги и пейволы

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

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

В таблице ниже сравниваются возможности каждого варианта:

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

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

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

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

1. Создайте флоу: Конвертируйте существующий пейвол в один клик или создайте флоу из шаблона — без участия разработчика.
2. Проверьте на устройстве: Посмотрите, как выглядит флоу на реальном устройстве через мобильное приложение Adapty — без сборки приложения.
3. Создайте новый плейсмент для флоу: Создайте новый плейсмент для флоу с уникальным ID и определите, как он будет сосуществовать с существующими плейсментами.
4. Обновите SDK: Обновитесь до Adapty SDK v4, загрузите флоу из плейсмента и проверьте покупку в песочнице. Это основная задача разработчика.

Создайте свой флоу

Если ваш пейвол был создан в legacy Paywall Builder, конвертируйте его, а не пересоздавайте с нуля. Действие Move to new builder одним кликом воссоздаёт его как черновик флоу — с макетом, текстами на всех языках и продуктами с ценами в виде переменных — при этом оригинал остаётся активным, пока вы редактируете и тестируете. См. Конвертация пейвола во флоу.

Чтобы создать что-то новое, выберите подходящий вариант:

• Начать с шаблона: Стартовый шаблон или пустой флоу в Flow & Paywall Builder, без кода.
• Использовать агентский навык: Ваш AI-инструмент для разработки самостоятельно создаёт и редактирует флоу прямо из терминала — удобно для квизов, ветвления и массового добавления локалей.

Reference while you build:

• Документация по Flow и Paywall Builder: Знакомит с билдером и тем, что в нём можно создать.
• Типовые рецепты флоу: Пошаговые гайды для самых распространённых экранов.
• Спросить AI: Используйте чат на любой странице документации, если зашли в тупик.

Предпросмотр на устройстве

Вы можете просмотреть флоу на реальном устройстве, не меняя приложение. Скачайте мобильное приложение Adapty для iOS или Android. Затем в Flow & Paywall Builder нажмите Test on device, выберите локаль и отсканируйте QR-код с устройства. Вы увидите реальные экраны, ветвление, тексты и дизайн.

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

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

Переносить все плейсменты на флоу сразу необязательно. В SDK v4 метод getFlow обращается как к плейсментам флоу, так и к плейсментам пейвола — приложение вызывает один и тот же метод везде. Оставляйте пейволы Paywall Builder в тех плейсментах, где они нужны, и используйте флоу в остальных.

В переходный период каждый тип плейсмента отслеживает собственные метрики. Пока в работе находятся и старая, и новая версии приложения, данные распределяются между двумя наборами плейсментов. Старые плейсменты онбординга и пейвола охватывают более ранние версии; новый плейсмент флоу — SDK v4+. Сравнивайте их как отдельные когорты и ожидайте, что доля плейсмента флоу будет расти по мере обновления пользователей.

Вы можете продолжать A/B-тестирование с флоу: запускайте обычный A/B-тест на разных вариантах флоу в плейсменте флоу. Кросс-плейсментные A/B-тесты пока доступны только для пейволов, поэтому запустить такой тест между плейсментами флоу пока нельзя. Сравнение нового флоу со старым пейволом — это сравнение когорт, а не один тест: они находятся в разных типах плейсментов.

Создание плейсментов с помощью агентного навыка

С более чем несколькими плейсментами для переноса навык migrate-placements создаёт их прямо из вашего AI-инструмента для работы с кодом. Он считывает все плейсменты в вашем приложении через Adapty CLI, группирует их по пейволу, который каждый из них обслуживает, спрашивает для каждого пейвола, откуда берётся флоу, затем создаёт один плейсмент флоу на каждый плейсмент пейвола в области действия и возвращает маппинг старых ID к новым и вызов getFlow, который нужно добавить в приложение.

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

Обновите 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.