---
title: "Миграция на флоу"
description: "Перенесите отдельный онбординг и пейвол в единое флоу Adapty — что изменится и как запустить это, не нарушив работу пользователей на старых версиях приложения."
---

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

:::important
Флоу в настоящее время поддерживаются в iOS SDK v4 и выше. Поддержка других платформ и фреймворков появится в ближайшее время.
:::
## Флоу vs. онбординги и пейволы \{#flows-vs-onboardings-and-paywalls\}

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

Флоу заменяет оба — вводные экраны, квиз и экран покупки — собраны в одном редакторе и отдаются из одного плейсмента.

В таблице ниже сравниваются оба варианта:
| | Флоу | Пейвол в Paywall Builder | Онбординг |
|---|---|---|---|
| Несколько экранов | Да | Нет — один экран | Да |
| Отрисовка | Нативная | Нативная | WebView |
| Продукты и плейсмент | Один плейсмент; продукты добавляются непосредственно во флоу | Один плейсмент; продукты добавляются непосредственно в пейвол | Один плейсмент, но собственных продуктов нет — для продаж нужно создать отдельный пейвол и подключить его через отдельный плейсмент |
## Нужна ли вам миграция? \{#should-you-migrate\}

Существующие онбординги и пейволы продолжают работать, и Adapty их поддерживает. Однако новые функции теперь появляются во флоу, а не в отдельных конструкторах онбордингов и пейволов.

**Если вы строите продукт на перспективу, флоу — лучший фундамент** — переходите на них, когда это вписывается в ваш план релизов.
## Как выполнить миграцию \{#how-to-migrate\}

Миграция состоит из четырёх шагов. Основная часть работы — это разовое обновление SDK: создание и предпросмотр флоу не требуют написания кода.
1. **[Создайте флоу](#build-your-flow)**: Создайте флоу в no-code редакторе — разработчик не нужен.
2. **[Проверьте на устройстве](#preview-on-device)**: Посмотрите флоу на реальном устройстве через мобильное приложение Adapty — сборка приложения не нужна.
3. **[Создайте новый плейсмент для флоу](#create-a-new-placement-for-your-flow)**: Создайте новый плейсмент для флоу с уникальным ID и определите, как он будет сосуществовать с вашими существующими плейсментами.
4. **[Обновите SDK](#update-the-sdk)**: Перейдите на iOS SDK v4, получите флоу из плейсмента и проверьте покупку в песочнице. Это основная задача разработчика.
### Создайте флоу \{#build-your-flow\}

На странице **Flows** нажмите **Create flow**, чтобы приступить к созданию онбординга и пейвола в виде единого флоу. Подробнее о билдере:

- **[Документация по флоу](adapty-flow-builder)**: Знакомит с билдером и его возможностями.
- **[Типовые рецепты флоу](flow-builder-recipes)**: Пошаговые гайды для самых распространённых экранов.
- **Ask AI**: Если застряли — используйте чат на любой странице документации.
:::note
Создание флоу из готового шаблона или с помощью ИИ пока недоступно — обе функции скоро появятся. Сейчас каждый новый флоу начинается с нескольких часто используемых экранов, которые вы можете редактировать и оформлять под свои нужды.
:::
### Предпросмотр на устройстве \{#preview-on-device\}

Вы можете просматривать флоу на реальном устройстве, не меняя приложение. Скачайте [приложение Adapty](https://apps.apple.com/us/app/adapty/id6739359219) из App Store. Затем в конструкторе флоу нажмите **Test on device**, выберите локаль и отсканируйте QR-код на устройстве. Так вы увидите реальные экраны, ветвление, тексты и дизайн.

:::note
В режиме предпросмотра Adapty не может получить доступ к вашим продуктам в сторах, поэтому отображаемые цены ненастоящие. Реальные покупки проверяются позже — в сборке v4 с аккаунтом песочницы. Подробнее см. в разделе [Обновление SDK](#update-the-sdk).
:::

### Создайте новый плейсмент для вашего флоу \{#create-a-new-placement-for-your-flow\}

Плейсмент обслуживает только один тип контента — флоу, пейвол или онбординг. Преобразовать существующий плейсмент онбординга или пейвола в плейсмент флоу нельзя (см. [типы плейсментов](create-placement)). Для флоу нужен отдельный новый плейсмент.

**Присвойте новому плейсменту флоу полностью уникальный идентификатор.** Он не может совпадать с идентификатором существующего плейсмента пейвола или онбординга.

:::warning
Не отключайте старые плейсменты во время перехода
Пользователи на старых версиях приложения имеют ID плейсментов онбординга и пейвола, скомпилированные в приложении. Они продолжают вызывать методы онбординга и пейвола и видят ваши существующие онбординг и пейвол до обновления. Выводите старые плейсменты из эксплуатации только после того, как уровень принятия SDK v4 станет достаточно высоким.
:::

Вам не обязательно переводить все плейсменты на флоу сразу. В iOS SDK v4 метод `getFlow` получает данные как из плейсментов с флоу, так и из плейсментов с пейволами — значит, приложение везде вызывает один и тот же метод. Оставьте пейволы Paywall Builder там, где они нужны, а флоу используйте в остальных плейсментах.
В переходный период каждый тип плейсмента отслеживает собственные метрики. Пока в работе находятся и старая, и новая версии приложения, данные распределяются между двумя наборами плейсментов. Старые плейсменты онбординга и пейвола охватывают более ранние версии; новый плейсмент флоу — SDK v4+. Сравнивайте их как отдельные когорты и ожидайте, что доля плейсмента флоу будет расти по мере обновления пользователей.
Вы можете проводить A/B-тесты с флоу: запустите [обычный A/B-тест](ab-tests) на нескольких вариантах флоу в плейсменте флоу. Кросс-плейсментные A/B-тесты пока доступны только для пейволов, поэтому запустить их на плейсментах флоу пока нельзя. Сравнение нового флоу со старым пейволом — это сравнение когорт, а не единый тест: они находятся на разных типах плейсментов.
### Обновите SDK \{#update-the-sdk\}

Когда плейсмент флоу готов, подключите его к приложению. Флоу работают только на Adapty SDK v4 и выше. Обновите SDK и получите флоу из нового плейсмента с помощью `getFlow(placementId:)`. Подробные шаги по обновлению — в [гайде по миграции на iOS SDK v4](migration-to-ios-sdk-v4).

После подключения флоу проверьте его как любой другой флоу покупки: запустите на устройстве или симуляторе и сделайте [покупку в песочнице](ios-test), чтобы убедиться, что продукты, покупка и уровень доступа работают корректно.
:::note
Флоу видят только пользователи, установившие приложение, собранное с SDK v4+. Те, кто использует старую версию приложения, по-прежнему видят привычный онбординг и пейвол — именно поэтому старые плейсменты остаются активными в переходный период. То же самое касается платформ, которые пока не поддерживают флоу.
:::