Поля для фильтров
Эта страница — справочник по всем полям, которые можно использовать в фильтрах любого отчёта (тренды, воронки, ретеншен). Поля сгруппированы так же, как они показаны в интерфейсе при выборе фильтра.
События
Эти поля относятся к самому событию — когда оно произошло и с каким содержимым.
ID события
Конкретное событие или несколько событий, к которым применяется фильтр/отчёт
Ресурс
Бот или канал, к которому относится событие — пригодится, если отчёт строится сразу по нескольким ресурсам
Тип данных
Откуда пришло событие: из обычного чата с ботом, из канала/группы, из Mini App и т.д.
ID пользователя
Telegram ID пользователя, совершившего событие
Категория событий
Категория, к которой отнесено событие (например, «Сообщения», «Платежи», «Клики по кнопкам») — помогает группировать похожие события
Значение
Текстовое значение, прикреплённое к событию (если оно есть)
Значение (число)
Числовое значение события — например, сумма покупки или количество чего-либо
Единица измерения
В чём измеряется числовое значение — например, usd, rub, «штук»
Mini App
Конкретное мини-приложение, если у бота их несколько
Сессии
ID сессии (бот)
Идентификатор сессии общения с ботом, в рамках которой произошло событие
ID сессии (Mini App)
Идентификатор сессии работы в мини-приложении
Длительность сессии
Сколько секунд длилась сессия
Начало сессии
Дата и время начала сессии
UTM-метки и источник трафика
UTM-метки показывают, откуда пришёл пользователь (реклама, канал, сайт и т.д.). Подробнее о том, что такое источник и как он определяется — в статье «Что такое источник?».
UTM (Первый запуск)
Источник/канал/кампания, с которыми пользователь запустил бота первый раз в принципе
UTM (Последний запуск)
Источник/канал/кампания последнего запуска бота этим пользователем
UTM (Последний значимый запуск)
Источник, учитывающий только настоящие запуски и возвраты (без повторных запусков уже активным пользователем) — подробнее в статье «Модели атрибуции»
UTM (Именно этот запуск)
Метки, которые пользователь принёс именно в этом запуске/событии — и только если они реально были переданы. В отличие от «Последнего запуска» (который остаётся прежним, пока не придёт новая метка), это поле пустое, если в конкретном запуске меток не было. Используйте его, когда в условии автоматизации нужно проверить «была ли метка именно сейчас», а не «когда-либо была» — иначе повторный /start без параметров ложно унаследует метку от предыдущего запуска
Сквозные UTM-данные
UTM-метки, переданные из внешнего источника (например, с сайта) и связанные с пользователем независимо от того, как он запустил бота
Пользователь — профиль Telegram
Эти поля берутся из профиля пользователя в Telegram на момент события.
Пол
Мужской / женский / не указан
Язык
Код языка интерфейса Telegram у пользователя
Telegram Premium
Есть ли у пользователя подписка Telegram Premium
Верифицирован
Аккаунт отмечен Telegram как верифицированный
Помечен как scam / fake
Аккаунт помечен Telegram как подозрительный
Версия Telegram клиента
Версия приложения Telegram, которым пользуется человек
Устройство / модель устройства
Тип и модель устройства, с которого пришло событие
Высота экрана (Mini App)
Высота видимой области экрана в мини-приложении — полезно для отладки интерфейса
Подарков Stars (шт.)
Сколько подарков Telegram Stars получил пользователь
Год / месяц / день рождения
Дата рождения пользователя, если она известна
Пользователь — геолокация
Определяется по IP-адресу пользователя.
Страна
Страна пользователя (название или код)
Регион
Регион/область
Город
Город
Почтовый индекс
Почтовый индекс региона
Часовой пояс
Часовой пояс пользователя
IP-адрес
IP-адрес, с которого пришло событие
Пользователь — профиль в graspil (CRM)
Эти поля относятся не к конкретному событию, а к пользователю в целом — как он сохранён в карточке пользователя.
User_ID
Внутренний ID пользователя в graspil
Полное имя / Имя / Фамилия / Username
Данные профиля Telegram
Дата добавления
Когда пользователь впервые появился в системе
Был активен
Дата последней активности пользователя
ТГ бот
Является ли «пользователь» Telegram-ботом, а не человеком
Статус
Текущий статус пользователя (активен, заблокировал бота и т.д.)
Когорта
Специальный фильтр — входит или не входит пользователь в ранее сохранённую аудиторию (когорту)
Дополнительные поля пользователя
Ваши собственные поля, заведённые в разделе «Доп. поля пользователей» — например, тариф, статус клиента, любое значение, которое вы сами сохранили о пользователе
Прочее
Сырые данные сообщения
Поле для продвинутых случаев — позволяет указать путь внутри исходных данных события (например, текст конкретного сообщения или данные нажатой кнопки). Обычно не требуется, если у вас уже настроены подходящие события
Последнее обновление