Отчёты
Раздел Отчёты — это библиотека готовых разборов вашего бота. В отличие от дашборда, где виджеты собираются вручную, здесь каждый отчёт уже настроен: выбираете отчёт, бота и период — и получаете ответ.
Чем отчёты отличаются от виджетов
| Отчёты | Виджеты дашборда | |
|---|---|---|
| Настройка | Готовые, менять ничего не нужно | Собираете сами |
| Где живут | Отдельный раздел, каждый по своему адресу | На вашем дашборде |
| Можно поделиться | Да — ссылка открывает отчёт и выбранный сегмент вместе с его ботом. Период по ссылке не передаётся | Нет, хранятся локально в браузере |
| Объяснение | У каждого отчёта есть блок «Об этом отчёте» | Нет |
Отчёты не заменяют дашборд, а дополняют его: отчёт отвечает на типовой вопрос, дашборд — на ваш собственный.
Блок «Об этом отчёте»
У каждого отчёта есть раскрывающийся блок с четырьмя разделами. Первый раз он открыт, потом сворачивается.
- Что показывает — одно предложение без терминов.
- Как считается — какие события берутся, какая метрика, какое окно, где есть приближение.
- Зачем нужен — какое решение помогает принять.
- Когда может ввести в заблуждение — самое важное: когда отчёт пуст или обманчив.
Если отчёт пустой и это неожиданно — сначала прочитайте «Когда может ввести в заблуждение». Чаще всего дело не в отсутствии данных, а в том, что нужное поле пишет только один тип подключения.
Сегмент в отчёте
Рядом с выбором бота и периода есть поле «Сегмент». Выберите сохранённый сегмент — и отчёт покажет данные только по нему, например «удержание платящих клиентов».
- Сегмент в отчёте живой: если сегмент изменить, отчёт при следующем открытии покажет новый состав.
- Сегмент попадает в ссылку, поэтому отчёт по сегменту можно отправить коллеге.
- Удержание принимает только сегменты со значком «Люди» — из условий о человеке.
- Отчёты по свойствам профиля, «Новые пользователи», приток и отток аудитории, подписчики канала, тепловая карта, отток и воронка всегда считаются по всем данным бота: поле «Сегмент» в них неактивно.
Если в сегменте есть условие по событию, в отчёте оно сужает сами события, а не только людей. Отчёт «События по названию» с условием «нажал кнопку X» покажет только эти нажатия. Отчёт предупреждает об этом над графиком.
Категории
Рост
- Активные пользователи — уникальные люди по времени.
- Уникальные пользователи: 1 / 7 / 30 дней — тройка DAU / WAU / MAU: активные за сутки, неделю и месяц. Это три отдельных числа, а не тренд. Окна скользящие и заканчиваются на конце выбранного периода, тогда как карточки на странице Vitals считают последние завершённые календарные сутки, неделю и месяц по UTC, поэтому цифры на двух страницах намеренно различаются.
- Новые пользователи — люди, чьё первое в истории событие попало в период, по интервалам. Это та же метрика, что и в карточках «Новые пользователи» на странице Vitals: человек попадает в график ровно один раз, в тот интервал, где он появился впервые.
- Команды /start — те, кто отправил
/start. Это мера намерения подключиться, а не прихода: человек, который заблокировал бота и запустил заново, будет посчитан снова. Раньше этот отчёт назывался «Новые пользователи», что было неверно. - Приток и отток аудитории — кто запускает и блокирует бота, двумя линиями на одном графике.
- Подписчики канала — вступления и выходы в канале, где бот администратор.
Вовлечённость
Всего событий, события по названию и по типу, трафик по подключению, тепловая карта активности, личные чаты и группы, нажатия кнопок, реакции, команды, типы сообщений, типы вложений, география.
Привлечение
- Источники трафика, Кампании и Реферальные коды — ключи
source,campaignиrefиз диплинков видаt.me/yourbot?start=source-tgads_campaign-june. Это ближайший аналог 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-воркер
видел этот текст всегда, но не разбирал его. Теперь команду, упоминание бота и параметры выделяет
общий разборщик на стороне записи, одинаково для обоих подключений.
Отчёт «Команды» показывает данные с момента этого обновления. Сообщения, записанные раньше, остались без разобранной команды — это вопрос пересчёта истории, а не доступности данных.
Атрибуция: первое и последнее касание
Человек может прийти по одной ссылке, а вернуться по другой. В отчётах «Источники трафика», «Кампании» и «Реферальные коды» есть переключатель «Атрибуция», и он решает, какой ссылке засчитать человека:
| Режим | Кому засчитывается человек |
|---|---|
| Первое касание (по умолчанию) | первой ссылке, по которой он пришёл |
| Последнее касание | самой свежей ссылке до конца периода |
| Переходы за период | каждой ссылке, которую он открыл в этот период; сумма строк может превышать аудиторию |
В первых двух режимах каждый человек попадает ровно в одну строку, поэтому строки в сумме дают общий итог. Метка читается из той самой ссылки: если в первой ссылке человека не было кампании, в «Кампаниях» при первом касании его нет, и доли считаются от людей с меткой, а не от всей аудитории. Ссылки, открытые после конца периода, не учитываются.
Период отбирает людей, активных за выбранные даты, а ссылку для них ищет по всей сохранённой
истории. Если ваш тариф хранит события достаточно долго, человек, пришедший в марте по кампании
spring и написавший вчера, в отчёте за вчера засчитывается кампании spring.
События хранятся столько дней, сколько предусматривает тариф. Если настоящая первая ссылка человека старше этого срока, первым касанием считается самая ранняя из сохранённых ссылок, то есть более поздняя. Если сохранённых ссылок нет вовсе, человека в таблице нет. Поэтому у давних клиентов первое касание надёжно только в пределах срока хранения, а цифры меняются при его смене.
Выбранный режим попадает в ссылку на отчёт. Бот и период в ссылку не попадают: коллега откроет отчёт на своём последнем боте и за последние 7 дней.
«Переходы по ссылкам» считает последний диплинк
Отчёт «Переходы по ссылкам» читает карточку пользователя, где хранится последний параметр целиком, без разбора на ключи. Если человек перезапустил бота по другой ссылке, он перейдёт в другую строку. Переключателя атрибуции в этом отчёте нет.
Период в нём отбирает пользователей, активных за выбранные даты, и берёт их карточку по состоянию на сейчас. Это не момент привлечения: человек, привлечённый в марте и написавший вчера, попадёт в отчёт за вчера.
Раньше период фильтровал момент последнего обновления карточки, а не активность. Карточка пишется не при каждом визите, поэтому пользователь с давно записанной карточкой не попадал в отчёт вообще — и совет «расширьте период, если кампания выглядит меньше ожидаемой» больше не нужен. Числа за старые периоды после обновления выросли; данные не менялись, изменился отбор.
Доли считает сервер, а не браузер
В отчётах-рейтингах колонка «Доля» появляется только тогда, когда сервер прислал общий итог. Это сделано намеренно: сумма строк на экране не равна общему количеству — уникальные пользователи не складываются (один человек попадает в несколько строк), список обрезается сверху, а строки без значения могут быть исключены. Поэтому доля никогда не вычисляется из того, что видно на экране.
Валюты никогда не складываются: курсов в Metriox нет, поэтому бот с несколькими валютами получает несколько корректных строк вместо одного бессмысленного итога. Суммы — в наименьших единицах Telegram (центы, копейки или целые Stars). Учитываются только платежи, записанные через Bot API SDK.
Чего в отчётах нет
Сессии (количество, длительность, отказы), устройства, версия Telegram, произвольный SQL. Этих данных Metriox либо не собирает, либо Telegram их не отдаёт — поэтому такие отчёты не показываются пустыми, а просто отсутствуют.