> For the complete documentation index, see [llms.txt](https://docs.graspil.com/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.graspil.com/ru/app/reports/filter-fields.md). # Поля для фильтров Эта страница — справочник по всем полям, которые можно использовать в фильтрах любого отчёта (тренды, воронки, ретеншен). Поля сгруппированы так же, как они показаны в интерфейсе при выборе фильтра. {% hint style="info" %} Фильтр всегда задаётся как «поле» + «условие» (равно, больше, содержит и т.д.) + «значение». Например: «Значение (число)» **больше** `1000`. {% endhint %} ## События Эти поля относятся к самому событию — когда оно произошло и с каким содержимым. | Поле | Описание | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | **ID события** | Конкретное событие или несколько событий, к которым применяется фильтр/отчёт | | **Ресурс** | Бот или канал, к которому относится событие — пригодится, если отчёт строится сразу по нескольким ресурсам | | **Тип данных** | Откуда пришло событие: из обычного чата с ботом, из канала/группы, из Mini App и т.д. | | **ID пользователя** | Telegram ID пользователя, совершившего событие | | **Категория событий** | Категория, к которой отнесено событие (например, «Сообщения», «Платежи», «Клики по кнопкам») — помогает группировать похожие события | | **Значение** | Текстовое значение, прикреплённое к событию (если оно есть) | | **Значение (число)** | Числовое значение события — например, сумма покупки или количество чего-либо | | **Единица измерения** | В чём измеряется числовое значение — например, `usd`, `rub`, «штук» | | **Mini App** | Конкретное мини-приложение, если у бота их несколько | ## Сессии | Поле | Описание | | ------------------------ | ------------------------------------------------------------------------ | | **ID сессии (бот)** | Идентификатор сессии общения с ботом, в рамках которой произошло событие | | **ID сессии (Mini App)** | Идентификатор сессии работы в мини-приложении | | **Длительность сессии** | Сколько секунд длилась сессия | | **Начало сессии** | Дата и время начала сессии | ## UTM-метки и источник трафика UTM-метки показывают, откуда пришёл пользователь (реклама, канал, сайт и т.д.). Подробнее о том, что такое источник и как он определяется — в статье [«Что такое источник?»](/ru/app/start-utm/source.md). | Поле | Описание | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **UTM (Первый запуск)** | Источник/канал/кампания, с которыми пользователь запустил бота **первый раз** в принципе | | **UTM (Последний запуск)** | Источник/канал/кампания **последнего** запуска бота этим пользователем | | **UTM (Последний значимый запуск)** | Источник, учитывающий только настоящие запуски и возвраты (без повторных запусков уже активным пользователем) — подробнее в статье [«Модели атрибуции»](/ru/app/attribution-models.md) | | **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-ботом, а не человеком | | **Статус** | Текущий статус пользователя (активен, заблокировал бота и т.д.) | | **Когорта** | Специальный фильтр — входит или не входит пользователь в ранее сохранённую аудиторию (когорту) | | **Дополнительные поля пользователя** | Ваши собственные поля, заведённые в разделе [«Доп. поля пользователей»](/ru/app/custom-fields.md) — например, тариф, статус клиента, любое значение, которое вы сами сохранили о пользователе | ## Прочее | Поле | Описание | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Сырые данные сообщения** | Поле для продвинутых случаев — позволяет указать путь внутри исходных данных события (например, текст конкретного сообщения или данные нажатой кнопки). Обычно не требуется, если у вас уже настроены подходящие события |