Отчёты
Раздел Отчёты — это библиотека готовых разборов вашего бота. В отличие от дашборда, где виджеты собираются вручную, здесь каждый отчёт уже настроен: выбираете отчёт, бота и период — и получаете ответ.
Чем отчёты отличаются от виджетов
| Отчёты | Виджеты дашборда | |
|---|---|---|
| Настройка | Готовые, менять ничего не нужно | Собираете сами |
| Где живут | Отдельный раздел, каждый по своему адресу | На вашем дашборде |
| Можно поделиться | Да — ссылка содержит бота и период | Нет, хранятся локально в браузере |
| Объяснение | У каждого отчёта есть блок «Об этом отчёте» | Нет |
Отчёты не заменяют дашборд, а дополняют его: отчёт отвечает на типовой вопрос, дашборд — на ваш собственный.
Блок «Об этом отчёте»
У каждого отчёта есть раскрывающийся блок с четырьмя разделами. Первый раз он открыт, потом сворачивается.
- Что показывает — одно предложение без терминов.
- Как считается — какие события берутся, какая метрика, какое окно, где есть приближение.
- Зачем нужен — какое решение помогает принять.
- Когда может ввести в заблуждение — самое важное: когда отчёт пуст или обманчив.
Если отчёт пустой и это неожиданно — сначала прочитайте «Когда может ввести в заблуждение». Чаще всего дело не в отсутствии данных, а в том, что нужное поле пишет только один тип подключения.
Категории
Рост
- Активные пользователи — уникальные люди по времени.
- Уникальные пользователи: 1 / 7 / 30 дней — тройка DAU / WAU / MAU: активные за сутки, неделю и месяц. Это три отдельных числа, а не тренд. Окна скользящие и заканчиваются на конце выбранного периода, тогда как карточки на странице Vitals считают последние завершённые календарные сутки, неделю и месяц по UTC, поэтому цифры на двух страницах намеренно различаются.
- Новые пользователи — люди, чьё первое в истории событие попало в период, по интервалам. Это та же метрика, что и в карточках «Новые пользователи» на странице Vitals: человек попадает в график ровно один раз, в тот интервал, где он появился впервые.
- Команды /start — те, кто отправил
/start. Это мера намерения подключиться, а не прихода: человек, который заблокировал бота и запустил заново, будет посчитан снова. Раньше этот отчёт назывался «Новые пользователи», что было неверно. - Приток и отток аудитории — кто запускает и блокирует бота, двумя линиями на одном графике.
- Подписчики канала — вступления и выходы в канале, где бот администратор.
Вовлечённость
Всего событий, события по названию и по типу, трафик по подключению, тепловая карта активности, личные чаты и группы, нажатия кнопок, реакции, команды, типы сообщений, типы вложений, география.
Привлечение
- Кампании и Источники-рефералы — разбор диплинков вида
t.me/yourbot?start=campaign%3Djune. Это ближайший аналог UTM-меток для Telegram-бота. - Языки и Telegram Premium — демография аудитории.
Конверсия, Удержание, Монетизация
Воронка онбординга, удержание по когортам, отток за 30 дней и выручка по валютам.
Ограничения, о которых стоит знать заранее
Не все данные видны при любом подключении
Telegram отдаёт разным типам подключения разные данные. Metriox не может это обойти — но честно помечает такие отчёты значком.
| Значок | Что означает |
|---|---|
| Только Bot API SDK | Выручка |
| Только MTProto | Типы вложений (детализация) |
| Только SDK / Mini App | География |
Если у бота одно подключение, отчёты «чужой» группы будут пустыми — это не ошибка настройки.
Раньше на один и тот же вопрос отвечали два отчёта: «Типы сообщений» (только Bot API SDK) и «Типы вложений» (только MTProto). Каждый был пуст для половины ботов, хотя данные были у обоих подключений — просто в разном виде: Bot API называет вид сообщения, MTProto называет вложение.
Теперь есть один отчёт «Типы контента» без значка: при записи события оба варианта приводятся к
общему словарю, поэтому фото — это photo независимо от того, как подключён бот. «Типы сообщений»
больше нет, а «Типы вложений» остался как детализация — там видны различия, которые общий словарь
объединяет (кастомный эмодзи вместо стикера, живая геолокация вместо статичной).
Отчёт показывает данные с момента этого обновления: у сообщений, записанных раньше, сохранилось только исходное поле конкретного подключения.
Раньше здесь значились и «Команды» — это была наша недоработка, а не ограничение Telegram. Команда
(/start, /help@MyBot ref123) — это просто структура внутри текста сообщения, и MTProto-воркер
видел этот текст всегда, но не разбирал его. Теперь команду, упоминание бота и параметры выделяет
общий разборщик на стороне записи, одинаково для обоих подключений.
Отчёт «Команды» показывает данные с момента этого обновления. Сообщения, записанные раньше, остались без разобранной команды — это вопрос пересчёта истории, а не доступности данных.
Привлечение считает последний диплинк
Отчёты «Кампании» и «Источники-рефералы» читают карточку пользователя, где хранится последняя версия данных. Если человек перезапустил бота по другой ссылке, он перейдёт в другую кампанию.
Период в этих отчётах отбирает пользователей, активных за выбранные даты, и берёт их карточку по состоянию на сейчас. Это не момент привлечения: человек, привлечённый в марте и написавший вчера, попадёт в отчёт за вчера.
Раньше период фильтровал момент последнего обновления карточки, а не активность. Карточка пишется не при каждом визите, поэтому пользователь с давно записанной карточкой не попадал в отчёт вообще — и совет «расширьте период, если кампания выглядит меньше ожидаемой» больше не нужен. Числа за старые периоды после обновления выросли; данные не менялись, изменился отбор.
Доли считает сервер, а не браузер
В отчётах-рейтингах колонка «Доля» появляется только тогда, когда сервер прислал общий итог. Это сделано намеренно: сумма строк на экране не равна общему количеству — уникальные пользователи не складываются (один человек попадает в несколько строк), список обрезается сверху, а строки без значения могут быть исключены. Поэтому доля никогда не вычисляется из того, что видно на экране.
Валюты никогда не складываются: курсов в Metriox нет, поэтому бот с несколькими валютами получает несколько корректных строк вместо одного бессмысленного итога. Суммы — в наименьших единицах Telegram (центы, копейки или целые Stars). Учитываются только платежи, записанные через Bot API SDK.
Чего в отчётах нет
Сессии (количество, длительность, отказы), устройства, версия Telegram, произвольный SQL. Этих данных Metriox либо не собирает, либо Telegram их не отдаёт — поэтому такие отчёты не показываются пустыми, а просто отсутствуют.