Сегменты

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

Типичные сегменты: «платящие клиенты» (совершил successful_payment хотя бы раз), «пользователи Premium», «русскоязычные», «нажимали кнопку, но не оплатили».

Что хранит сегмент

Условия, а не список людей. Состав сегмента пересчитывается для периода той страницы, где вы его применяете. Сегмент «оплатил не меньше 3 раз» за последние 7 дней и за последние 30 дней — это разные люди.
Один бот. Названия событий и свойств у каждого бота свои, поэтому сегмент применяется только к тому боту, для которого его собрали.
Общий для проекта. Сегмент видят и могут применять все участники проекта.

Как создать сегмент

Откройте страницу Пользователи и выберите бота.
Соберите условия в конструкторе фильтров. Таблица под ним — живой предпросмотр: вы сразу видите, кто попадает в сегмент за выбранный период.
Нажмите «Сохранить как сегмент» и дайте ему название.

Чтобы изменить сегмент, примените его, поправьте условия и нажмите «Обновить «название»». Если кто-то из коллег изменил сегмент, пока вы его редактировали, сохранение будет отклонено, и чужая правка молча не перезапишется. Ваши условия останутся в конструкторе: сохраните их как новый сегмент или примените сегмент заново, чтобы увидеть его текущую версию.

Названия сегментов уникальны в пределах проекта, а не бота: у двух ботов одного проекта не может быть двух сегментов «VIP». Если название занято, Metriox подскажет, у какого бота.

Раздел «Сегменты»

Все сегменты проекта собраны в разделе Сегменты в меню слева.

Поиск и фильтр по боту. Найдите сегмент по части названия или покажите сегменты одного бота. Поиск и фильтр сохраняются в адресе страницы, так что отфильтрованным списком можно поделиться.
Открыть на странице «Пользователи». Нажмите на название сегмента: его условия загрузятся в конструктор фильтров, а таблица покажет, кто под них подходит.
Новая рассылка по сегменту. Значок рассылки в строке сегмента откроет черновик рассылки на боте сегмента с копией его условий.
Переименовать и удалить сегмент могут участники с ролью Writer и выше. Удаление нужно подтвердить.
Вверху раздела видно, сколько сегментов в проекте. Когда занято 80% лимита тарифа или больше, рядом появляются лимит и предупреждение. Когда лимит исчерпан, создать новый сегмент нельзя, пока не удалите ненужные.

Кнопка «Создать сегмент» открывает страницу «Пользователи»: сегмент собирают там, где сразу видно, кто в него попадёт.

Какие условия можно сохранить

Сегмент хранит то, что конструктор фильтров умеет показать, — иначе условия потерялись бы при следующем открытии:

список условий, объединённых одним AND или одним OR; каждое условие можно отрицать;
условие «совершил действие N раз» считает одно событие по названию;
до 40 элементов фильтра и не больше 4 условий по свойствам профиля.

Вложенные группы вида «(A или B) и C» сохранить нельзя.

Люди или события

Рядом с каждым сегментом стоит значок. Он показывает, одинаково ли сегмент работает на разных экранах.

Значок	Условия	Как работает
Люди	Только условия о человеке: свойство профиля (`$tg.is_premium`, `$tg.language_code`) или «совершил действие N раз»	Отбирает одних и тех же людей в отчётах, на странице «Пользователи» и в рассылках
События	Есть хотя бы одно условие по событию или его свойству	В рассылке отбирает людей, у которых были такие события. В отчёте сужает сами события: отчёт «События по названию» с условием «нажал кнопку X» покажет только эти нажатия, а не всё, что делали эти люди

Если нужен сегмент людей, опишите действие как «совершил действие не меньше 1 раза» — тогда сегмент будет со значком «Люди».

Сегмент в отчётах

На странице отчёта рядом с выбором бота и периода есть поле «Сегмент».

Сегмент в отчёте живой: если его изменить, отчёт при следующем открытии покажет новый состав.
Выбранный сегмент попадает в ссылку. Ссылка с сегментом открывает отчёт сразу на боте этого сегмента.
Если сегмент из ссылки удалили, отчёт сообщит об этом и предложит показать данные по всем пользователям. График без сегмента под ссылкой с сегментом не показывается.

Не каждый отчёт может принять сегмент:

Отчёты	Сегмент
Большинство отчётов по событиям и пользователям	Любой
Удержание	Только со значком «Люди»: условие по событию изменило бы само определение «вернулся»
Отчёты по свойствам профиля (языки, Premium, диплинки), «Новые пользователи», приток и отток аудитории, подписчики канала, тепловая карта, отток за 30 дней, воронка	Не применяется — эти отчёты всегда считаются по всем данным бота, и поле «Сегмент» в них неактивно

Сегмент в рассылке

В редакторе аудитории нажмите «Вставить сегмент» — условия сегмента скопируются в черновик рассылки.

Это копия, а не ссылка. Если позже изменить или удалить сегмент, рассылка не изменится. Так подготовленную рассылку невозможно случайно перенацелить, отредактировав сегмент.
Редактор показывает, из какого сегмента скопированы условия и совпадают ли они с ним до сих пор. Если не совпадают, условия можно вставить заново.
Если в черновике уже есть условия, вставка сегмента их заменит — Metriox попросит подтвердить.
Начать рассылку можно и из раздела Сегменты: значок рассылки в строке сегмента откроет черновик с копией его условий.

Получателей может быть меньше

На странице «Пользователи» в сегмент попадают все, кто подходит под условия. Рассылка же доходит только до тех, кто открывал личный чат с ботом, — см. кто попадает в аудиторию.

Права и ограничения

Действие	Минимальная роль
Применять сегменты в отчётах, на странице «Пользователи» и в рассылках	Reader
Сохранять, обновлять, переименовывать и удалять сегменты	Writer

Удаление сегмента записывается в журнал аудита проекта как segment.delete.
Сколько сегментов можно хранить в проекте, зависит от тарифа: по умолчанию до 10 000. Когда лимит достигнут, Metriox покажет, сколько сегментов уже есть и сколько разрешено: удалите ненужные в разделе Сегменты и сохраните снова.
Если лимит тарифа уменьшится, существующие сегменты не удаляются: нельзя будет только сохранить новые.
Если перенести бота в другой проект, его сегменты переедут вместе с ним. Название, которое в новом проекте уже занято, получит суффикс: «VIP (2)».