Плейсменты

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

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

• Плейсмент флоу показывает флоу: один экран или последовательность экранов, созданных в Flow & Paywall Builder. Флоу может быть онбордингом, пейволом или онбордингом, завершающимся пейволом. Если вы хотите создать экран самостоятельно, используйте плейсмент пейвола.
• Плейсмент пейвола передаёт пейвол — конфигурацию продукта, созданную в дашборде, — на экран, который вы строите самостоятельно.

Третий тип, плейсменты онбординга, служит для показа онбордингов, созданных в устаревшем Onboarding Builder. Adapty прекращает поддержку этого конструктора 1 октября 2026 года, поэтому создавайте новые онбординги в виде флоу.

Правила и подводные камни

• Тип плейсмента фиксируется при создании, потому что у каждого типа свой набор метрик.
• ID плейсментов уникальны в рамках всего приложения, поэтому один и тот же ID не может одновременно обслуживать флоу в одном месте и пейвол в другом.
• Кастомный пейвол и флоу не могут участвовать в одном A/B-тесте, потому что каждому нужен собственный тип плейсмента. Чтобы сравнить их, разворачивайте флоу постепенно на отдельном плейсменте и сравнивайте показатели.
• Чтобы перевести плейсмент пейвола во флоу, создайте новый плейсмент флоу с новым ID, затем выпустите релиз приложения, который его вызывает. См. Миграция на флоу.
• Единственное, что вы хардкодите в приложении — это ID плейсмента. Всем остальным вы управляете из дашборда без выпуска новой версии: какой флоу или пейвол показывать, сегментация аудитории и A/B-тесты.
• ID плейсмента должен точно совпадать с ID в дашборде. Копируйте его без лишних пробелов. Если ID не совпадает, запрос SDK завершится с ошибкой, и SDK будет использовать локальный резервный файл, если он настроен.
• Только для старого Paywall Builder — отключение Show on device не удаляет пейвол из его плейсмента. Плейсмент по-прежнему резолвится к нему без конфигурации билдера, поэтому приложению нечего отобразить. Чтобы прекратить показ пейвола, удалите его из аудитории плейсмента.

Список плейсментов

Чтобы просмотреть все плейсменты, перейдите в Placements в главном меню Adapty. Они разделены по типам: Paywalls, Onboardings и Flows.

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

Вы можете редактировать детали плейсмента, связывать их с нужным флоу, пейволом, онбордингом или A/B-тестом для определённой аудитории, а также удалять ненужные плейсменты. Цифры в таблице отражают аналитику по плейсментам с момента их активации.

Отсюда вы можете:

• Создать новый плейсмент
• Отредактировать существующий плейсмент
• Удалить существующий плейсмент
• Скачать локальные резервные флоу, пейволы или онбординги. Эти файлы используются, когда пользователь открывает приложение без подключения к бэкенду Adapty (нет интернета или бэкенд недоступен) и на устройстве нет кэша. Одна загрузка Fallbacks охватывает и флоу, и пейволы — версия SDK, выбранная в диалоге загрузки, определяет, включает ли пакет флоу (SDK 4.0+) или только пейволы.