Co oznacza każda metryka, jak czytać panel i jak podejmować lepsze decyzje na podstawie danych z Telegrama. Napisane dla początkujących — z konkretnymi liczbami i rzeczywistymi benchmarkami.
Czym jest TG Analytics, dlaczego lokalność ma znaczenie i czego nauczysz się z tego poradnika.
Wszystko, co śledzisz, jest przechowywane w lokalnej bazie danych SQLite na Twoim komputerze. Bez kont, bez serwerów, bez telemetrii. Pełny kod źródłowy na GitHubie na licencji MIT.
TG Analytics to darmowa aplikacja desktopowa, która zamienia Twoje kanały Telegram w jasne, użyteczne dane. Współpracuje z Twoimi własnymi kanałami (w których jesteś administratorem) oraz z dowolnym kanałem publicznym — idealna zarówno do prowadzenia własnego kanału, jak i do badania konkurencji.
Ponieważ platformy analityczne takie jak TGStat i Telemetr wymagają przekazania danych na ich serwery — i zazwyczaj pobierają opłaty za zaawansowane funkcje. TG Analytics przechowuje wszystko na Twoim komputerze i daje Ci pełny zestaw narzędzi za darmo.
Nie musisz wiedzieć, jak działa API Telegram. Wystarczy raz pobrać dane uwierzytelniające z my.telegram.org — resztą zajmie się aplikacja.
Gotowe pliki binarne dla wszystkich głównych platform. Bez instalacji, bez zależności.
Wszystkie oficjalne kompilacje są hostowane na GitHubie:
Otwórz najnowsze wydaniechmod +x TGAnalytics-Linux)Zapisz ją w dowolnym wygodnym miejscu — na Pulpicie, w Dokumentach, w dedykowanym folderze „Narzędzia”. Kliknij dwukrotnie, aby uruchomić. Pierwsze uruchomienie może zająć 5–10 sekund, podczas gdy plik binarny się rozpakowuje.
Ponieważ plik wykonywalny nie jest podpisany płatnym certyfikatem podpisywania kodu, system Windows może wyświetlić ostrzeżenie. Kliknij Więcej informacji → Uruchom mimo to. Możesz także zbudować aplikację ze źródła, jeśli wolisz.
Otwórz Terminal i uruchom xattr -cr "/Applications/TG Analytics.app" po przeniesieniu aplikacji do Applications. To usuwa flagę kwarantanny dla niepodpisanych aplikacji.
Każdy klient Telegram potrzebuje api_id i api_hash z oficjalnego portalu deweloperskiego. Darmowe, zajmuje 3 minuty.
Działają jak „login dewelopera” dla Telegrama. Każdy klient firm trzecich ma własną parę. Utworzysz własną — jest darmowa, bezpieczna i przypisana tylko do Twojego konta.
Otwórz https://my.telegram.org w przeglądarce.
Wpisz numer w formacie międzynarodowym z + — na przykład +48221234567. Telegram wyśle kod potwierdzający do aplikacji.
Po zalogowaniu kliknij API development tools w panelu.
Wypełnij formularz — dane są przechowywane przez Telegram dla ich celów i nie mają znaczenia dla funkcjonalności. Platforma: Desktop. Kliknij Create application.
Zobaczysz dwie wartości — skopiuj obie:
1234567abcdef1234567890abcdef1234567890Każdy, kto zna Twoje API ID, API Hash i numer telefonu, może potencjalnie uzyskać dostęp do Twojego konta Telegram. Nigdy nie udostępniaj ich w czatach, zrzutach ekranu ani na forach publicznych.
Dwie metody logowania — wybierz tę, która jest dla Ciebie wygodniejsza.
Otwórz ekran Logowanie i wpisz:
+Telegram wyśle kod do aplikacji (lub SMS-em). Pojawia się okno dialogowe — wpisz kod. Jeśli włączona jest weryfikacja dwuetapowa, pojawi się monit o hasło.
Numer telefonu nie jest wymagany do logowania QR.
Otwiera się okno QR. W telefonie:
Okno zamyka się automatycznie po sukcesie.
Twoje imię pojawia się na pasku bocznym. Sesja jest przechowywana lokalnie — przy następnym otwarciu aplikacji jesteś już zalogowany.
W ~/.tg_analytics/sessions/. W systemie Windows to C:\Users\TwojaNazwa\.tg_analytics\sessions\. Aby całkowicie się wylogować, użyj przycisku „Wyloguj” w aplikacji.
Dwa typy kanałów: Twoje własne (prawa administratora) i dowolny kanał publiczny przez @username.
Otwórz sekcję Kanały. Twoje kanały administracyjne pojawiają się automatycznie po prawej stronie — aplikacja pobiera je z Twoich dialogów Telegram.
Aplikacja pobiera każdy kanał, w którym jesteś administratorem lub właścicielem. Może to zająć 10–30 sekund przy pierwszym uruchomieniu.
Kanał przenosi się do lewej kolumny („Śledzone”), a aplikacja natychmiast rozpoczyna import ostatnich 100 postów i bieżącej liczby subskrybentów.
Funkcja zabójca — śledź dowolny otwarty kanał przez @username, link t.me/... lub identyfikator numeryczny.
Otwiera się okno z polem wprowadzania.
Przykłady tego, co działa:
durov@durovt.me/durovhttps://t.me/durovAplikacja rozpoznaje kanał i pokazuje podgląd — tytuł, @username i liczbę subskrybentów. Następnie automatycznie rozpoczyna śledzenie.
Tylko kanały publiczne są dostępne do zewnętrznego śledzenia. Jeśli widzisz „kanał jest prywatny” — musisz być administratorem lub kanał jest dostępny tylko na zaproszenie.
TG Analytics koncentruje się na kanałach nadawczych, w których publikowanie jest jednokierunkowe. Supergrupy i czaty nie są śledzone — mają inną dynamikę i metryki.
Co oznacza każda liczba, jak jest obliczana i jak wygląda „dobra” wartość.
Bieżąca liczba osób zasubskrybowanych do kanału — taka sama, jaką Telegram pokazuje publicznie. TG Analytics zapisuje tę liczbę w każdym cyklu zbierania, więc możesz zobaczyć, jak zmienia się w czasie.
O ile zmieniła się liczba subskrybentów w wybranym okresie. Wartość dodatnia = wzrost, ujemna = spadek. Pokazuje efekt netto nowych subskrypcji minus rezygnacji.
Średnia liczba wyświetleń wszystkich postów opublikowanych w wybranym okresie. To jest Twój punkt odniesienia — każdy nowy post będzie oceniany względem niego.
Najważniejsza metryka do porównywania kanałów o różnych rozmiarach. To procent subskrybentów, którzy zobaczyli Twój średni post. Kanał ze 100 tys. subskrybentów i 15% ER jest zaangażowany; 500 tys. subskrybentów i 2% ER to pusta skorupa.
Łączna liczba reakcji emoji na post. Silny sygnał prawdziwego zaangażowania — reakcje wymagają aktywnego kliknięcia, a nie tylko biernego czytania.
Ile razy post został przekazany do innego czatu lub kanału. Najwyraźniejszy wskaźnik posta „idącego wiralowo” — ktoś polubił go na tyle, by podzielić się nim z własną publicznością.
ER w podziale na typ posta: tekst, zdjęcie, wideo, dokument, ankieta. Pokazuje dokładnie, który format sprawdza się w przypadku Twojej konkretnej publiczności.
Nie gonić za liczbami bezwzględnymi. Kanał z 3 tys. subskrybentów i 25% ER oraz rosnącą publicznością jest zdrowszy niż kanał ze 100 tys. i 2% ER. TG Analytics jest zbudowany, aby pokazywać trendy, a nie metryki próżności.
Jak czytać wykres wzrostu, dlaczego może pokazywać tylko ostatnie dane i na co zwracać uwagę.
Za każdym razem, gdy TG Analytics zbiera dane, zapisuje „migawkę” bieżącej liczby subskrybentów. Wykres to oś czasu tych migawek. Szczegółowość dostosowuje się automatycznie:
Ponieważ Telegram nie udostępnia historii subskrybentów przez API. TG Analytics może rejestrować ją tylko od momentu rozpoczęcia śledzenia kanału. Z biegiem dni i tygodni wykres naturalnie się wypełnia. Posty, wyświetlenia i reakcje są pobierane z historii Telegrama — te są dostępne natychmiast.
Przełączaj się między zakładkami 7D / 30D / 90D / Cały czas, aby zobaczyć ten sam kanał w różnych powiększeniach:
Zamiast patrzeć na sumę, obserwuj zmianę w ciągu 7 dni. To jest to, co faktycznie wygenerowała Twoja ostatnia treść i działania outreachowe — suma to głównie historia.
Siatka 7×24 pokazująca średnie wyświetlenia według dnia tygodnia i godziny, oparta na Twoim własnym kanale.
Każda komórka reprezentuje jeden dzień tygodnia × godzinę dnia. Intensywność koloru to średnia liczba wyświetleń postów opublikowanych w tym oknie. Ciemnoniebieski = wysokie wyświetlenia, jasnoniebieski = niskie wyświetlenia, biały = brak postów w tym przedziale.
Aplikacja automatycznie podświetla najlepszy przedział obramowaniem i pokazuje etykietę „Najlepszy: Wt, 17:00” w nagłówku karty. To jest Twoje obliczone okno szczytowego zaangażowania.
Przy mniej niż 10 postach mapa cieplna będzie w większości pusta — nie ma wystarczającego sygnału. Staje się naprawdę przydatna po 30–50 postach rozłożonych na różne pory dnia.
Ucz się od swoich zwycięzców — które posty rezonowały najbardziej i który format sprawdza się najlepiej.
10 najlepszych postów z wybranego okresu, uszeregowanych według wyświetleń. Każdy wiersz pokazuje:
Wykres pierścieniowy pokazujący, ile postów każdego typu opublikowałeś, ze statystykami dla każdego typu:
Kolory: niebieski dla tekstu, fioletowy dla zdjęcia, różowy dla wideo, pomarańczowy dla dokumentu, zielony dla ankiety.
Do 6 kanałów obok siebie — dla Twojego portfolio lub w porównaniu z konkurencją.
Wybierz 2–6 kanałów z rzędu przełączników. Pierwsze dwa są wybierane automatycznie.
Te same zakładki 7D / 30D / 90D / Wszystko, co na panelu.
Wiersze: subskrybenci, Δ w okresie, średnia liczba wyświetleń, ER, liczba postów. Kolumny: jedna na kanał. Każda kolumna ma kolorowy pasek pasujący do wykresu wieloliniowego poniżej.
Jedna linia na kanał na wspólnej osi czasu — natychmiast zauważ, który rośnie szybciej lub który jest płaski.
Dwa wykresy słupkowe poniżej: jeden dla średniej liczby wyświetleń, jeden dla ER. ER to najsprawiedliwsze porównanie, gdy kanały mają bardzo różne rozmiary.
Kanału z 1 tys. i kanału z 1 mln nie można porównywać za pomocą liczb bezwzględnych. Ale jeśli kanał z 1 tys. ma 40% ER, a ten z 1 mln ma 8% ER, mniejszy jest znacznie bardziej zaangażowany na subskrybenta. To właśnie tego typu wnioski TGStat pobiera opłaty.
Trzy formaty — dla klientów, dalszej analizy lub kopii zapasowej.
Dopracowany raport A4 zaprojektowany do wysyłania klientom, menedżerom lub interesariuszom. Zawiera:
Wykresy są renderowane natywnie wewnątrz PDF (za pomocą matplotlib) — a nie jako obrazy — więc tekst i liczby pozostają ostre przy każdym powiększeniu.
Ze względu na ograniczenia czcionek w PDF, emoji z tekstów postów są usuwane w raporcie PDF. Pełny oryginalny tekst jest zachowany w eksportach JSON i CSV.
Kompletny eksport strukturalny zawierający zagregowany panel oraz surowe dane:
growth_series — każda migawka subskrybentówsnapshots — surowe pary znacznik czasu + subskrybenciposts — każdy post z pełnym tekstem, wyświetleniami, reakcjami, przekazaniami, media_typeheatmap — macierz 7×24top_posts, content_mixIdealny do dalszej analizy w Pythonie, Excelu lub dowolnym narzędziu BI.
Płaska tabela postów do analizy w arkuszu kalkulacyjnym:
channel, date, msg_id, views, reactions, forwards, media_type, text; (przyjazny dla Excela w większości lokalizacji)Otwórz panel, kliknij Eksportuj na pasku narzędzi. Wybierz format, wybierz lokalizację zapisu — gotowe. Domyślny folder to ~/.tg_analytics/exports/, ale możesz go zmienić w Ustawieniach.
Jak często dane są pobierane i jak skonfigurować to dla swoich potrzeb.
Wątek w tle budzi się zgodnie z harmonogramem i aktualizuje każdy śledzony kanał — jeden po drugim, z 3-sekundową pauzą między kanałami, aby uniknąć wywołania ochrony przed floodem Telegrama.
Pasek boczny → Ustawienia → sekcja Zbieranie.
Wybierz z listy rozwijanej. Zmiana jest stosowana natychmiast — bez restartu.
Tuż poniżej listy rozwijanej „Status automatycznego zbierania” pokazuje: czas ostatniego uruchomienia, ETA następnego i bieżący interwał.
Kliknij Zbierz teraz w Ustawieniach, aby natychmiast odświeżyć wszystkie kanały. Górny pasek pokazuje spinner z postępem podczas uruchamiania. Przydatne przed wygenerowaniem raportu.
Bardzo krótkie interwały (poniżej 15 minut) na wielu kanałach mogą wywołać FloodWait. Jeśli widzisz częste błędy flood w dziennikach, zwiększ interwał.
Język, wygląd, przechowywanie, folder eksportu, dzienniki — wszystko konfigurowalne.
5 języków obsługiwanych w interfejsie: angielski, rosyjski, hiszpański, portugalski (BR), niemiecki. Zmień w Ustawienia → Język — interfejs aktualizuje się natychmiast, bez restartu.
Trzy tryby:
Możesz także szybko przełączać motywy, klikając przycisk zmiany motywu w prawym górnym rogu aplikacji.
Jak długo przechowywać stare migawki i posty w lokalnej bazie danych:
Codzienne czyszczenie działa w tle i usuwa rekordy starsze niż okno przechowywania.
Gdzie zapisywane są pliki PDF / JSON / CSV. Domyślnie ~/.tg_analytics/exports/. Zmień na dowolny folder w Ustawienia → Wybierz folder.
Dzienniki aplikacji są przechowywane w ~/.tg_analytics/logs/:
app.log — ogólny dziennik aktywności z rotacją (5 MB × 5 plików)crash.log — tylko nieobsłużone wyjątki z pełnym tracebackiemKliknij „Otwórz folder” w Ustawieniach, aby otworzyć katalog dzienników w menedżerze plików. Przydatne do zgłaszania problemów.
Przycisk „Usuń wszystko” trwale usuwa wszystkie śledzone kanały i ich historię. Użyj go, jeśli chcesz zacząć od nowa. Nie wpływa to na Twoje dane Telegrama — tylko na lokalną bazę danych analityki.
Szybkie odpowiedzi na typowe problemy.
Kliknij Więcej informacji w oknie dialogowym, a następnie Uruchom mimo to. Dzieje się tak, ponieważ plik wykonywalny nie jest podpisany kodem. Jeśli mu nie ufasz, zbuduj ze źródła: sklonuj repozytorium i uruchom python build.py.
Otwórz Terminal i uruchom: xattr -cr "/Applications/TG Analytics.app". To usuwa atrybut kwarantanny, który macOS dodaje do niepodpisanych aplikacji. Następnie kliknij prawym przyciskiem → Otwórz przy pierwszym uruchomieniu.
Nie. Telegram nie udostępnia historii subskrybentów przez swoje API. Aplikacja rejestruje migawki od momentu rozpoczęcia śledzenia — więc wykres zaczyna się od jednego punktu i rośnie wraz z nowymi zbiorami. Przy interwałach 30-minutowych będziesz mieć pełną krzywą 24-godzinną w ciągu dnia.
Telegram ogranicza szybkość Twojego konta. Zwiększ interwał automatycznego zbierania (Ustawienia → co 30 min lub więcej) i zmniejsz liczbę śledzonych kanałów. Aplikacja automatycznie obsługuje FloodWait, wstrzymując się — ale jeśli widzisz to często, zmień interwał.
Tylko kanały publiczne mogą być śledzone zewnętrznie. Kanały prywatne (tylko na zaproszenie) nie są dostępne bez członkostwa. Jeśli jesteś członkiem, kanał pojawia się automatycznie na Twojej liście administracyjnej — sprawdź kartę Kanały.
Telegram może unieważnić sesję, jeśli logujesz się zbyt wielu urządzeń lub ręcznie zresetujesz sesje w Telegramie. Po prostu kliknij Wyloguj i zaloguj się ponownie przez QR lub telefon. Twoje śledzone kanały i dane analityczne są zachowane — znajdują się w lokalnej bazie danych, a nie w sesji.
Najprawdopodobniej problem z brakującą czcionką. Sprawdź ~/.tg_analytics/logs/app.log pod kątem dokładnego błędu i otwórz zgłoszenie na GitHubie z fragmentem dziennika. Jako obejście użyj eksportu JSON / CSV, które nie wymagają czcionek.
Otwórz zgłoszenie na GitHub Issues lub napisz bezpośrednio na Telegramie: @igor_shelloff. Dołącz: co zrobiłeś, co się stało i (jeśli to możliwe) fragment dziennika.
TG Analytics jest i zawsze będzie darmowy. Jeśli oszczędza Ci czas, oto jak możesz pomóc.
Gwiazdki pomagają innym odkryć projekt.
Otwórz repozytoriumZnalazłeś błąd lub masz pomysł na funkcję?
Otwórz zgłoszenieWesprzyj dalszy rozwój narzędzia.
WesprzyjPytania lub opinie? Napisz bezpośrednio.
@igor_shelloffJeśli TG Analytics mówi Ci, co działa, ale potrzebujesz także publikować i docierać na dużą skalę — wypróbuj Telegram AutoPoster Pro od tego samego twórcy. Planowane publikowanie, kampanie DM, wiele kont, historie, ochrona przed auto-stopem, raporty w Telegramie.
Poznaj Telegram AutoPoster Pro