📊 Вкладка «Аналитика»

Вкладка «Аналитика» показывает, как растёт аудитория вашего бота и насколько активно люди им пользуются. Здесь собраны наглядные карточки с графиками и круговые диаграммы: по ним видно, сколько у бота пользователей, как меняется их число со временем, сколько идёт сообщений и из каких источников приходят новые люди.

Всего пользователей

Карточка «Всего пользователей» показывает общее число людей, которые написали боту, и график прироста аудитории под этим числом. По графику видно, как менялось количество пользователей со временем. Если за последнюю неделю появились новые люди, рядом отображается подпись вида «+N за неделю» — это сколько пользователей прибавилось.

Активность сообщений

Карточка «Активность сообщений» отражает поток сообщений между ботом и пользователями. У неё есть переключатель режима: можно смотреть все сообщения вместе либо разделить их на входящие (что пишут боту) и исходящие (что отправляет бот). Рядом с числом так же показывается прибавка за неделю и среднее число сообщений на одного пользователя.

Короткие шаги графика («1ч», «3ч», «24ч») считаются по текущей истории диалогов. Более длинные («30д», «12н», «12м») берутся из отдельных дневных счётчиков: они увеличиваются при каждом новом сообщении и не уменьшаются, если сообщение потом удалили из диалога. Поэтому очистка старых сообщений в чате не обнуляет прошлые точки длинного графика.

Активные пользователи

Карточка «Активные пользователи» показывает, сколько разных людей что-то сделали за каждый отрезок времени — написали сообщение (в том числе команду вроде /start) или нажали кнопку. Ответы самого бота не считаются. Один человек за отрезок учитывается один раз, сколько бы действий он ни совершил — в этом главное отличие от «Активности сообщений».

У карточки есть переключатель: «Все активные» или «Новички и вернувшиеся». Новичок — тот, кто впервые появился у бота в том же отрезке; остальные — вернувшиеся. Большое число на карточке — сколько уникальных людей было активно за весь выбранный период (не сумма по отрезкам: человек, заходивший три дня подряд, считается одним).

Периоды те же, что у соседних графиков («1ч», «3ч», «24ч», «7д», «30д», «12н», «12м»). Короткие окна читаются из истории сообщений, длинные — из дневных отметок активности: они переживают и очистку старых сообщений, и удаление людей из базы. Накопительный режим для этой карточки не предлагается — складывать уникальных людей нарастающим итогом давало бы неверную картину.

График обновляется в реальном времени по тем же живым событиям, что и остальные карточки вкладки.

Детализация и вид графика

У каждого графика есть набор переключателей, которые меняют то, как выглядят данные.

• Детализация по времени — выбор шага на графике: «1ч», «3ч», «24ч», «30д», «12н», «12м». Чем меньше шаг, тем подробнее видна картина за недавнее время; чем больше — тем длиннее охватываемый период.
• Режим отображения — «За период» показывает значения по каждому отрезку времени отдельно, а «Накопительно» складывает их нарастающим итогом, чтобы видеть общий рост.
• Тип графика — «Столбчатый» рисует данные столбиками, «Линейный» — линией. Выбирайте тот вид, который вам удобнее читать.

Диаграммы распределения

Ниже карточек расположены круговые диаграммы, которые показывают, из чего складывается ваша аудитория.

• Источники трафика — откуда приходят пользователи: по каким ссылкам и каналам они попадают к боту.
• Premium — соотношение пользователей с подпиской Telegram Premium и обычных пользователей (доли «Premium» и «Обычные»).
• Языки — на каких языках общаются пользователи бота.

Топ кнопок

Карточка «Топ кнопок» показывает, какие inline-кнопки пользователи нажимают чаще всего — десять самых популярных. Данные выводятся горизонтальными полосами: чем длиннее полоса, тем больше нажатий у этой кнопки. Так удобно понять, какие действия в боте востребованы, а какие остаются без внимания.

У карточки есть переключатель периодов теми же шагами, что и у графиков выше («1ч», «3ч», «24ч», «30д», «12н», «12м»), — он задаёт, за какой промежуток времени считать нажатия. Карточка обновляется автоматически в реальном времени: как только пользователи нажимают кнопки, топ пересчитывается.

График по таблице

Карточка «График по таблице» строит график на основе ваших пользовательских таблиц проекта — тех, что вы создаёте во вкладке «Таблицы». В отличие от остальных карточек аналитики, здесь данные берутся не из статистики бота, а из ваших собственных таблиц, поэтому вы сами решаете, что и как показать.

Чтобы собрать график, выберите таблицу, затем колонку-категорию (ось X) — по её значениям строки группируются — и колонку-значение (ось Y) — числа из неё агрегируются внутри каждой группы. Дальше выберите вид агрегации: «Количество» (число строк в группе), «Сумма», «Среднее», «Минимум» или «Максимум». Для числовой колонки доступны все виды; если колонка значения нечисловая, остаётся только подсчёт количества.

Тип графика переключается между столбцами, линией и круговой диаграммой — выбирайте тот вид, который удобнее читать. Показываются наиболее крупные категории, а данные обновляются автоматически.

Под заголовком карточки есть раскрывающаяся подсказка «Что это за график?» — в ней кратко описано, на основе чего строится график, как работают оси, агрегации и типы.

Выбор бота, проекта и обновление

В шапке вкладки можно выбрать, по какому боту (токену) и какому проекту показывать статистику — это удобно, когда в проекте несколько ботов или у вас несколько проектов. Кнопка «Обновить» перезагружает данные, чтобы увидеть свежие цифры.

Связанные страницы

• Пользователи — список людей, которые стоят за цифрами аналитики
• Таблицы — пользовательские таблицы, на основе которых строится график по таблице
• Системные таблицы — исходные данные о пользователях и сообщениях
• Обзор интерфейса — все вкладки конструктора