Миграция на флоу
В Adapty флоу объединяет онбординг и пейвол в единую сущность за одним плейсментом. Флоу заменяет отдельные онбординг и пейвол, которые вы сегодня создаёте и показываете по отдельности. Этот гайд объясняет, что меняется при переходе на флоу и как внедрить изменения, не нарушая работу для пользователей на старых версиях приложения.
Флоу в настоящее время поддерживаются в iOS SDK v4 и выше. Поддержка других платформ и фреймворков появится в ближайшее время.
Флоу vs. онбординги и пейволы
С отдельными онбордингами и пейволами вы поддерживаете два билдера и два плейсмента. Переход пользователя от онбординга к пейволу приходится обрабатывать в собственном коде.
Флоу заменяет оба — вводные экраны, квиз и экран покупки — собраны в одном редакторе и отдаются из одного плейсмента.
В таблице ниже сравниваются оба варианта:
| Флоу | Пейвол в Paywall Builder | Онбординг | |
|---|---|---|---|
| Несколько экранов | Да | Нет — один экран | Да |
| Отрисовка | Нативная | Нативная | WebView |
| Продукты и плейсмент | Один плейсмент; продукты добавляются непосредственно во флоу | Один плейсмент; продукты добавляются непосредственно в пейвол | Один плейсмент, но собственных продуктов нет — для продаж нужно создать отдельный пейвол и подключить его через отдельный плейсмент |
Нужна ли вам миграция?
Существующие онбординги и пейволы продолжают работать, и Adapty их поддерживает. Однако новые функции теперь появляются во флоу, а не в отдельных конструкторах онбордингов и пейволов.
Если вы строите продукт на перспективу, флоу — лучший фундамент — переходите на них, когда это вписывается в ваш план релизов.
Как выполнить миграцию
Миграция состоит из четырёх шагов. Основная часть работы — это разовое обновление SDK: создание и предпросмотр флоу не требуют написания кода.
- Создайте флоу: Создайте флоу в no-code редакторе — разработчик не нужен.
- Проверьте на устройстве: Посмотрите флоу на реальном устройстве через мобильное приложение Adapty — сборка приложения не нужна.
- Создайте новый плейсмент для флоу: Создайте новый плейсмент для флоу с уникальным ID и определите, как он будет сосуществовать с вашими существующими плейсментами.
- Обновите SDK: Перейдите на iOS SDK v4, получите флоу из плейсмента и проверьте покупку в песочнице. Это основная задача разработчика.
Создайте флоу
На странице Flows нажмите Create flow, чтобы приступить к созданию онбординга и пейвола в виде единого флоу. Подробнее о билдере:
- Документация по флоу: Знакомит с билдером и его возможностями.
- Типовые рецепты флоу: Пошаговые гайды для самых распространённых экранов.
- Ask AI: Если застряли — используйте чат на любой странице документации.
Создание флоу из готового шаблона или с помощью ИИ пока недоступно — обе функции скоро появятся. Сейчас каждый новый флоу начинается с нескольких часто используемых экранов, которые вы можете редактировать и оформлять под свои нужды.
Предпросмотр на устройстве
Вы можете просматривать флоу на реальном устройстве, не меняя приложение. Скачайте приложение Adapty из App Store. Затем в конструкторе флоу нажмите Test on device, выберите локаль и отсканируйте QR-код на устройстве. Так вы увидите реальные экраны, ветвление, тексты и дизайн.
В режиме предпросмотра Adapty не может получить доступ к вашим продуктам в сторах, поэтому отображаемые цены ненастоящие. Реальные покупки проверяются позже — в сборке v4 с аккаунтом песочницы. Подробнее см. в разделе Обновление SDK.
Создайте новый плейсмент для вашего флоу
Плейсмент обслуживает только один тип контента — флоу, пейвол или онбординг. Преобразовать существующий плейсмент онбординга или пейвола в плейсмент флоу нельзя (см. типы плейсментов). Для флоу нужен отдельный новый плейсмент.
Присвойте новому плейсменту флоу полностью уникальный идентификатор. Он не может совпадать с идентификатором существующего плейсмента пейвола или онбординга.
Не отключайте старые плейсменты во время перехода Пользователи на старых версиях приложения имеют ID плейсментов онбординга и пейвола, скомпилированные в приложении. Они продолжают вызывать методы онбординга и пейвола и видят ваши существующие онбординг и пейвол до обновления. Выводите старые плейсменты из эксплуатации только после того, как уровень принятия SDK v4 станет достаточно высоким.
Вам не обязательно переводить все плейсменты на флоу сразу. В iOS SDK v4 метод getFlow получает данные как из плейсментов с флоу, так и из плейсментов с пейволами — значит, приложение везде вызывает один и тот же метод. Оставьте пейволы Paywall Builder там, где они нужны, а флоу используйте в остальных плейсментах.
В переходный период каждый тип плейсмента отслеживает собственные метрики. Пока в работе находятся и старая, и новая версии приложения, данные распределяются между двумя наборами плейсментов. Старые плейсменты онбординга и пейвола охватывают более ранние версии; новый плейсмент флоу — SDK v4+. Сравнивайте их как отдельные когорты и ожидайте, что доля плейсмента флоу будет расти по мере обновления пользователей.
Вы можете проводить A/B-тесты с флоу: запустите обычный A/B-тест на нескольких вариантах флоу в плейсменте флоу. Кросс-плейсментные A/B-тесты пока доступны только для пейволов, поэтому запустить их на плейсментах флоу пока нельзя. Сравнение нового флоу со старым пейволом — это сравнение когорт, а не единый тест: они находятся на разных типах плейсментов.
Обновите SDK
Когда плейсмент флоу готов, подключите его к приложению. Флоу работают только на Adapty SDK v4 и выше. Обновите SDK и получите флоу из нового плейсмента с помощью getFlow(placementId:). Подробные шаги по обновлению — в гайде по миграции на iOS SDK v4.
После подключения флоу проверьте его как любой другой флоу покупки: запустите на устройстве или симуляторе и сделайте покупку в песочнице, чтобы убедиться, что продукты, покупка и уровень доступа работают корректно.
Флоу видят только пользователи, установившие приложение, собранное с SDK v4+. Те, кто использует старую версию приложения, по-прежнему видят привычный онбординг и пейвол — именно поэтому старые плейсменты остаются активными в переходный период. То же самое касается платформ, которые пока не поддерживают флоу.
