Что означает каждая метрика, как читать дашборд и как принимать лучшие решения по данным вашего Telegram-канала. Написано для новичков — с конкретными числами и реальными бенчмарками.
Что такое TG Analytics, почему локальный подход важен и что вы узнаете в этом руководстве.
Всё, что вы отслеживаете, хранится в локальной базе SQLite на вашем компьютере. Без аккаунтов, без серверов, без телеметрии. Весь исходный код — на GitHub под MIT License.
TG Analytics — это бесплатное десктопное приложение, которое превращает ваши Telegram-каналы в понятные и полезные данные. Работает с вашими каналами (где вы админ) и любыми публичными — идеально и для ведения своего канала, и для анализа конкурентов.
Потому что аналитические платформы вроде TGStat и Telemetr требуют передать свои данные на их серверы — и обычно платить за продвинутые функции. TG Analytics держит всё на вашем компьютере и даёт полный набор инструментов бесплатно.
Вам не нужно знать, как работает Telegram API. Достаточно один раз получить свои ключи на my.telegram.org — всё остальное приложение сделает само.
Готовые бинарники под все основные платформы. Без установки, без зависимостей.
chmod +x TGAnalytics-Linux)Сохраните в удобное место — Рабочий стол, Документы, отдельную папку «Инструменты». Двойной клик для запуска. Первый запуск может занять 5–10 секунд — бинарник распаковывается.
Так как EXE не подписан платным сертификатом, Windows может показать предупреждение. Нажмите Подробнее → Выполнить в любом случае. Можно также собрать приложение из исходников, если предпочитаете.
Откройте Терминал и выполните xattr -cr "/Applications/TG Analytics.app" после переноса приложения в Applications. Это снимает карантинный флаг для неподписанных приложений.
Любому Telegram-клиенту нужны api_id и api_hash из официального портала для разработчиков. Бесплатно, 3 минуты.
Это «логин разработчика» для Telegram. У каждого стороннего клиента своя пара. Вы создадите свою — бесплатно, безопасно и привязана только к вашему аккаунту.
Перейдите на https://my.telegram.org в браузере.
Введите номер в международном формате с + — например +79123456789. Telegram пришлёт код подтверждения в приложение.
После входа нажмите API development tools в панели управления.
Заполните форму — данные хранятся у Telegram для их записей и не влияют на работу. Платформа: Desktop. Нажмите Create application.
Увидите два значения — скопируйте оба:
1234567abcdef1234567890abcdef1234567890Тот, у кого есть ваш API ID, API Hash и номер телефона, потенциально может получить доступ к вашему Telegram-аккаунту. Никогда не передавайте их в чатах, скриншотах или на публичных форумах.
Два способа входа — выбирайте тот, что удобнее.
Откройте экран Вход и введите:
+Telegram пришлёт код в приложение (или по SMS). Появится диалог — введите код. Если включена двухфакторная аутентификация, следом придёт запрос пароля.
Телефон для QR-входа не нужен.
Откроется окно с QR. На телефоне:
Окно закроется автоматически при успехе.
Ваше имя появится в сайдбаре. Сессия хранится локально — при следующем запуске вы уже в системе.
В ~/.tg_analytics/sessions/. На Windows — C:\Users\ВашеИмя\.tg_analytics\sessions\. Чтобы полностью выйти, используйте кнопку «Выйти» в приложении.
Два типа каналов: свои (с правами админа) и любые публичные по @username.
Откройте раздел Каналы. Ваши админ-каналы появятся автоматически справа — приложение подтягивает их из диалогов Telegram.
Программа заберёт все каналы, где вы админ или владелец. Первый запуск занимает 10–30 секунд.
Канал переедет в левую колонку («Отслеживаемые»), и программа сразу начнёт импортировать последние 100 постов и текущее число подписчиков.
Убийственная фича — отслеживание любого открытого канала по @username, ссылке t.me/... или числовому ID.
Откроется модальное окно с полем ввода.
Работают варианты:
durov@durovt.me/durovhttps://t.me/durovПрограмма найдёт канал и покажет превью — название, @username, число подписчиков. Затем начнёт отслеживать автоматически.
Только публичные каналы доступны для внешнего отслеживания. Если видите «канал приватный» — либо нужно быть админом, либо канал доступен только по инвайту.
TG Analytics работает с broadcast-каналами, где публикация односторонняя. Супергруппы и чаты не отслеживаются — там другая динамика и метрики.
Что значит каждое число, как оно считается и какое значение считается «хорошим».
Текущее число подписчиков канала — то же, что Telegram показывает публично. TG Analytics сохраняет снимок числа на каждом цикле сбора, чтобы видеть, как оно меняется со временем.
Насколько изменилось число подписчиков за выбранный период. Плюс — рост, минус — спад. Показывает чистый эффект: новые подписки минус отписки.
Среднее число просмотров по всем постам, опубликованным в выбранном периоде. Это ваша база — каждый новый пост оценивается относительно неё.
Самая важная метрика для сравнения каналов разного размера. Это процент подписчиков, увидевших средний пост. Канал с 100k подписчиков и 15% ER вовлечён; 500k подписчиков с 2% ER — пустая оболочка.
Общее число эмодзи-реакций на пост. Сильный сигнал истинной вовлечённости — реакция требует активного тапа, а не пассивного чтения.
Сколько раз пост был переслан в другой чат или канал. Самый чёткий индикатор «вирусности» — кто-то счёл пост достаточно интересным, чтобы поделиться с собственной аудиторией.
ER, разбитый по типам постов: текст, фото, видео, документ, опрос. Видно, какой формат лучше всего работает для вашей аудитории.
Не гоняйтесь за абсолютными числами. Канал на 3k подписчиков с 25% ER и растущей аудиторией здоровее, чем канал на 100k с 2% ER. TG Analytics создан, чтобы показывать тренды, а не vanity-метрики.
Как читать график роста, почему он может показывать только свежие данные и на что смотреть.
Каждый раз при сборе данных TG Analytics сохраняет «снимок» текущего числа подписчиков. График — это таймлайн этих снимков. Гранулярность адаптируется автоматически:
Потому что Telegram не отдаёт историю подписчиков через API. TG Analytics фиксирует её только с того момента, как вы начали отслеживать канал. Со временем график заполняется сам. Посты, просмотры и реакции забираются из истории Telegram — они доступны сразу.
Переключайтесь между вкладками 7Д / 30Д / 90Д / Всё время, чтобы видеть канал на разном масштабе:
Вместо абсолютного числа следите за изменением за 7 дней. Именно его произвели ваш недавний контент и активность — итоговое число по большей части история.
Сетка 7×24 со средними просмотрами по дню недели и часу, на основе вашего собственного канала.
Каждая ячейка — комбинация «день недели × час дня». Интенсивность цвета — средние просмотры постов, опубликованных в это окно. Тёмно-синий = много просмотров, светло-синий = мало, белый = в это окно ещё не публиковали.
Программа автоматически выделяет лучшее окно контурной рамкой и показывает метку «Лучшее: Вт, 17:00» в заголовке карточки. Это ваше рассчитанное пиковое окно вовлечённости.
С менее чем 10 постами карта будет почти пустой — сигнала не хватает. Она становится по-настоящему полезной после 30–50 постов, разбросанных по разным часам.
Учитесь на своих победителях — какие посты отзываются лучше всего и какой формат работает.
Топ-10 постов за выбранный период, отсортированные по просмотрам. Каждая строка показывает:
Кольцевая диаграмма, показывающая, сколько постов каждого типа вы публиковали, с метриками по каждому:
Цвета: синий — текст, фиолетовый — фото, розовый — видео, оранжевый — документ, зелёный — опрос.
До 6 каналов бок-о-бок — для своего портфеля или против конкурентов.
Выберите 2–6 каналов из строки переключателей. Первые два выбираются автоматически.
Те же вкладки 7Д / 30Д / 90Д / Всё, что и на дашборде.
Строки: подписчики, Δ за период, средние просмотры, ER, число постов. Столбцы — по одному на канал. У каждого столбца цветная полоска, совпадающая с линией на графике.
Одна линия на канал на общем таймлайне — мгновенно видно, какой растёт быстрее или какой на плато.
Два бар-чарта ниже: один по средним просмотрам, второй — по ER. ER — самое честное сравнение, когда каналы сильно различаются по размеру.
Канал на 1k и канал на 1M нельзя сравнивать по абсолютным цифрам. Но если у 1k-канала ER 40%, а у 1M — 8%, то у маленького на порядок выше вовлечённость на подписчика. Именно такие инсайты TGStat продаёт за деньги.
Три формата — для клиентов, дальнейшего анализа или бэкапа.
Отполированный A4-отчёт, который удобно отправлять клиентам, менеджерам или стейкхолдерам. Включает:
Графики рендерятся нативно внутри PDF (через matplotlib) — не картинкой, поэтому текст и цифры остаются резкими при любом зуме.
Из-за ограничений шрифтов в PDF эмодзи в текстах постов удаляются. Полный оригинальный текст сохраняется в JSON и CSV-экспортах.
Полный структурированный экспорт, включающий как агрегированный дашборд, так и сырые данные:
growth_series — все снимки подписчиковsnapshots — сырые пары «timestamp + subscribers»posts — все посты с полным текстом, просмотрами, реакциями, репостами, media_typeheatmap — матрица 7×24top_posts, content_mixИдеально для дальнейшего анализа в Python, Excel или любом BI-инструменте.
Плоская таблица постов для анализа в таблицах:
channel, date, msg_id, views, reactions, forwards, media_type, text; (Excel-дружественный в большинстве локалей)Откройте дашборд, нажмите Экспорт на панели инструментов. Выберите формат, укажите место сохранения — готово. Папка по умолчанию ~/.tg_analytics/exports/, но её можно изменить в настройках.
Как часто забираются данные и как настроить это под себя.
Фоновый поток просыпается по расписанию и обновляет каждый отслеживаемый канал — по одному, с 3-секундной паузой между каналами, чтобы не ловить FloodWait Telegram.
Сайдбар → Настройки → раздел «Сбор данных».
Выберите из выпадающего списка. Изменение применяется сразу — без перезапуска.
Прямо под выпадающим списком «Статус автосбора» показывает: последний запуск, ETA следующего, текущий интервал.
Нажмите Собрать сейчас в настройках для немедленного обновления всех каналов. В верхней панели показывается спиннер с прогрессом. Полезно перед генерацией отчёта.
Очень короткие интервалы (ниже 15 минут) по многим каналам могут вызвать FloodWait. Если видите частые флуд-ошибки в логах — увеличьте интервал.
Язык, внешний вид, хранение, папка экспорта, логи — всё настраивается.
5 языков в интерфейсе: английский, русский, испанский, португальский (BR), немецкий. Смена в Настройки → Язык — интерфейс обновляется мгновенно без перезапуска.
Три режима:
Можно быстро переключать темы кликом по кнопке темы в правом верхнем углу приложения.
Сколько хранить старые снимки и посты в локальной базе:
Ежедневная очистка идёт в фоне и удаляет записи старше вашего окна.
Куда сохраняются PDF / JSON / CSV. По умолчанию ~/.tg_analytics/exports/. Можно сменить на любую папку через Настройки → Выбрать папку.
Логи приложения хранятся в ~/.tg_analytics/logs/:
app.log — общий лог активности с ротацией (5 МБ × 5 файлов)crash.log — только необработанные исключения с полным tracebackКнопка «Открыть папку» в настройках открывает папку с логами в файловом менеджере. Полезно для отчётов о проблемах.
Кнопка «Удалить всё» безвозвратно удаляет все отслеживаемые каналы и их историю. Используйте, если хотите начать с нуля. Она не затрагивает ваши данные в Telegram — только локальную базу аналитики.
Быстрые ответы на частые вопросы.
Нажмите Подробнее в диалоге, затем Выполнить в любом случае. Так происходит потому, что исполняемый файл не подписан цифровой подписью. Если не доверяете — соберите из исходников: клонируйте репозиторий и выполните python build.py.
Откройте Терминал и выполните: xattr -cr "/Applications/TG Analytics.app". Это снимает карантинный атрибут, который macOS добавляет к неподписанным приложениям. После этого — правый клик → Открыть при первом запуске.
Нет. Telegram не даёт историю подписчиков через API. Программа записывает снимки с момента начала отслеживания — график начинается с одной точки и растёт с новыми сборами. С интервалом 30 минут полная 24-часовая кривая появится за день.
Telegram ограничивает скорость для вашего аккаунта. Увеличьте интервал автосбора (Настройки → 30 минут и более) и сократите число отслеживаемых каналов. Программа сама обрабатывает FloodWait паузами — но если видите его часто, поменяйте интервал.
Только публичные каналы можно отслеживать извне. Приватные (по инвайту) недоступны без членства. Если вы участник — канал автоматически появится в списке админских, проверьте вкладку «Каналы».
Telegram может отозвать сессию, если вы вошли со многих устройств или сами сбросили сессии в Telegram. Просто нажмите Выйти и войдите снова через QR или телефон. Отслеживаемые каналы и данные аналитики сохранятся — они живут в локальной базе, а не в сессии.
Скорее всего, проблема со шрифтами. Проверьте ~/.tg_analytics/logs/app.log, чтобы узнать точную ошибку, и откройте Issue на GitHub с фрагментом лога. Как обходной путь — используйте JSON / CSV-экспорт, им шрифты не нужны.
Откройте Issue на GitHub Issues или напишите напрямую в Telegram: @igor_shelloff. Приложите: что делали, что произошло и (если возможно) фрагмент лога.
TG Analytics был и всегда будет бесплатным. Если сэкономил вам время — вот как можно помочь.
Звёзды помогают другим найти проект.
Открыть репозиторийНашли баг или есть идея фичи?
Открыть issueПоддержите дальнейшую разработку инструмента.
ДонатВопросы или фидбэк? Пишите напрямую.
@igor_shelloffЕсли TG Analytics говорит, что работает, но вам ещё нужно публиковать и выходить на связь на масштабе — попробуйте Telegram AutoPoster Pro от того же автора. Планировщик, рассылки в личку, мультиаккаунт, истории, автостоп-защита, отчёты в Telegram.
Узнать про Telegram AutoPoster Pro