Плейсменты

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

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

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

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

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

• Тип плейсмента фиксируется при создании, так как у каждого типа свой набор метрик.
• Идентификаторы плейсментов уникальны в рамках всего приложения, поэтому один и тот же 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+) или только пейволы.