Сегменты в Adapty Mail

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

Создание сегмента

В Adapty Mail перейдите в Segments и нажмите + Create. Откроется страница создания с заголовком New Segment.
Укажите Name (обязательно) и при желании добавьте Description.
В разделе Filters нажимайте Add filter для каждого правила, которое хотите добавить. Каждый фильтр становится сворачиваемой карточкой с названием Filter 1, Filter 2 и так далее.
Для каждого фильтра выберите поле, оператор и введите значение для сравнения.
Сохраните сегмент.

Important

Фильтры объединяются по логике AND — пользователь должен соответствовать каждому фильтру, чтобы попасть в сегмент. Логика OR и вложенные группы не поддерживаются. Каждое поле можно использовать в сегменте только один раз; чтобы сравнить одно поле с несколькими значениями, разбейте логику на отдельные сегменты.

New Segment form with Name, Description, and Filters fields

Импорт сегмента из Adapty

Вместо того чтобы создавать сегмент вручную с помощью фильтров, можно импортировать готовый сегмент аудитории из основного дашборда Adapty.

На странице Segments нажмите Import.
Просмотрите список. Importable segments — это сегменты, доступные для импорта: у них отображается чекбокс и условия фильтрации. Сегменты, которые нельзя импортировать, выделены серым, а рядом указана причина — например, неподдерживаемое поле (например, данные атрибуции Apple Ads), неподдерживаемый оператор или состояние подписки, для которого нет аналога в Adapty Mail.
Отметьте нужные сегменты и нажмите Import.

Диалог импорта сегментов с отмеченными для импорта сегментами и недоступными сегментами, выделенными серым с указанием причин отклонения

Important

Импорт создаёт независимую копию фильтров сегмента на момент импорта — она не синхронизируется с исходным сегментом Adapty, и повторный импорт того же сегмента каждый раз создаёт отдельную копию, поскольку Adapty Mail не отслеживает дубликаты.

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

Доступные поля фильтрации

Группа	Поле	Тип
Profile	Email	String
Profile	Gender	String
Profile	Age	Number
Profile	Country	String
Profile	Store country	String
Profile	Created at	Date
Device info	Device	String
Device info	Locale	String
Device info	OS	String
Device info	Platform	String
Device info	App version	Version
Purchase state	Total revenue (USD)	Number
Purchase state	Subscription state	String
Purchase state	Subscription purchased at	Date
Purchase state	Subscription expires at	Date
Purchase state	One-time purchase state	String
Purchase state	One-time purchased at	Date

Поля сведений об устройстве заполняются только в том случае, если ваша точка входа их отправляет. Что именно содержит этот payload — описано в разделе Отправка данных через API.

Значения состояния подписки: Never purchased, Subscribed, Auto-renew off, Billing issue, Grace period, Expired, Refunded.

Значения состояния разовой покупки: Never purchased, Purchased, Refunded.

Доступные операторы по типу поля:

String: equals, not equals, is set, is not set.
Number: equals, not equals, less than, greater than, less than or equal, greater than or equal, between, is set, is not set.
Date: equals, not equals, before, after, on or before, on or after, between, is set, is not set.
Version: те же сравнения, что и для Number, применяются в порядке версий — 1.10.0 старше 1.9.0.

Системный сегмент All Users

Adapty Mail включает встроенный сегмент All Users без каких-либо фильтров — в него попадают все пользователи проекта. Его нельзя редактировать или удалять. При использовании во флоу он служит финальной строкой-«заглушкой», перехватывающей всех остальных (подробнее о правиле приоритетов см. в разделе Флоу).

Жизненный цикл

Состояние сегмента определяется тем, как он используется:

Draft: Создан, не привязан ни к какому флоу или A/B-тесту.
Live: Привязан к активному флоу или A/B-тесту.
Inactive: Был привязан, но A/B-тест завершился или вы удалили сегмент из флоу.
Archived: Мягко удалён и скрыт из основного списка.

На странице сегментов в панели инструментов есть фильтр по состоянию, с помощью которого можно отобразить только нужные сегменты.

Редактирование и удаление сегмента

Имя и описание: Можно изменить в любой момент.
Фильтры: Доступны для редактирования только пока сегмент находится в статусе Draft. Как только флоу или A/B-тест задействует сегмент, фильтры становятся доступными только для чтения навсегда — статусы Live, Inactive и Archived блокируют их. Имя и описание можно менять по-прежнему. Чтобы изменить таргетинг, создайте новый сегмент и подключите его к флоу.
Удаление: Выполняет мягкое удаление сегмента. Активные сегменты (Live) удалить нельзя — сначала уберите их из флоу (или завершите A/B-тест).

Ограничения

Нет логики ИЛИ и вложенности: фильтры объединяются только по И.
Одно поле на сегмент: в сегменте не может быть двух фильтров по одному полю (например, двух проверок страны).
Нет предпросмотра размера: редактор не показывает, сколько пользователей сейчас соответствуют фильтрам.
Фильтры фиксируются после первого использования: изменить фильтры можно только у сегмента в статусе Draft. Любой сегмент, который уже использовался, доступен только для чтения — можно менять лишь название и описание.