Пользователи
Страница Пользователи показывает список уникальных пользователей, взаимодействовавших с вашим ботом в выбранном временном диапазоне.
Что показывает страница
Каждая строка таблицы содержит:
| Поле | Описание |
|---|---|
| Platform User ID | Telegram ID пользователя |
| Events in Range | Количество событий пользователя за выбранный период |
| First Seen | Дата первого взаимодействия |
| Last Seen | Дата последнего взаимодействия |
| Дополнительные | Свойства из профиля пользователя (настраиваются) |
Настройка столбцов
Нажмите кнопку Columns в верхней части страницы, чтобы добавить или убрать столбцы с пользовательскими свойствами.
По умолчанию отображается столбец $tg.username. Вы можете:
- Добавить любое свойство из профиля пользователя (например,
$tg.first_name,$tg.lang) - Ввести произвольный ключ свойства вручную
- Удалить ненужные столбцы
Выбор столбцов сохраняется в браузере и восстанавливается при следующем открытии.
Свойства профиля пользователя ($tg.*)
При подключении через токен Telegram-бота Metriox автоматически сохраняет свойства пользователя из Telegram:
| Свойство | Тип | Описание |
|---|---|---|
$tg.first_name | string | Имя пользователя |
$tg.last_name | string | Фамилия (если заполнена) |
$tg.username | string | Username в Telegram (если задан) |
$tg.lang | string | Языковой код (например, "ru", "en") |
$tg.is_bot | boolean | Является ли аккаунт ботом |
$tg.is_premium | boolean | Premium статус (если установлен Telegram) |
Параметр /start
Если пользователь открыл бота через диплинк /start <параметр>, Metriox сохраняет:
| Свойство | Тип | Описание |
|---|---|---|
$tg.start_raw | string | Параметр /start в исходном виде |
$tg.start.<key> | string | Разобранные пары ключ=значение из параметра |
Пример: если пользователь перешёл по ссылке https://t.me/YourBot?start=ref_123%26campaign_promo, то:
$tg.start_raw = "ref_123&campaign_promo"
$tg.start.ref = "123"
$tg.start.campaign = "promo"
Профиль пользователя обновляется при каждом взаимодействии. В таблице отображается последний известный снимок.
Фильтрация пользователей
К странице Пользователи применяются те же фильтры, что и к виджетам. Используйте предикаты на события, чтобы найти пользователей, совершивших определённые действия.
Карточка пользователя
Нажмите на строку пользователя, чтобы открыть его карточку с:
- Всеми свойствами профиля
- Историей событий за выбранный период
Что дальше?
- Фильтры — сегментируйте пользователей по событиям и свойствам
- Метрики — подробнее о метриках Events, Users, Events per User
- Автоматическое подключение — как включить авто-захват профилей