Ce înseamnă fiecare metrică, cum să citești panoul de control și cum să iei decizii mai bune din datele tale Telegram. Scris pentru începători — cu numere concrete și repere din lumea reală.
Ce este TG Analytics, de ce contează abordarea local-first și ce vei învăța în acest ghid.
Tot ce urmărești este stocat într-o bază de date SQLite locală pe computerul tău. Fără conturi, fără servere, fără telemetrie. Codul sursă complet pe GitHub sub Licența MIT.
TG Analytics este o aplicație desktop gratuită care transformă canalele tale Telegram în date clare și acționabile. Funcționează cu canalele tale (unde ești admin) și cu orice canal public — perfect atât pentru a-ți gestiona canalul, cât și pentru a studia concurența.
Pentru că platformele de analiză precum TGStat și Telemetr îți cer să predai datele pe serverele lor — și de obicei plătești pentru funcții avansate. TG Analytics păstrează totul pe mașina ta și îți oferă întregul set de instrumente gratuit.
Nu trebuie să știi cum funcționează API-ul Telegram. Obține acreditările de pe my.telegram.org o singură dată — restul este gestionat de aplicație.
Binare precompilate pentru toate platformele majore. Fără instalare, fără dependențe.
Toate versiunile oficiale sunt găzduite pe GitHub:
Deschide ultima versiunechmod +x TGAnalytics-Linux)Salvează-l oriunde convenabil — Desktop, Documents, un folder dedicat „Tools”. Fă dublu clic pentru a lansa. Prima lansare poate dura 5–10 secunde cât timp binarul se despachetează.
Deoarece executabilul nu este semnat cu un certificat de semnare a codului plătit, Windows poate afișa un avertisment. Fă clic pe More info → Run anyway. Poți de asemenea să construiești aplicația din sursă dacă preferi.
Deschide Terminal și rulează xattr -cr "/Applications/TG Analytics.app" după ce muți aplicația în Applications. Acest lucru elimină flag-ul de carantină pentru aplicațiile nesemnate.
Fiecare client Telegram are nevoie de api_id și api_hash de la portalul oficial pentru dezvoltatori. Gratuit, durează 3 minute.
Funcționează ca un „login de dezvoltator” pentru Telegram. Fiecare client terț are propria pereche. Vei crea propria ta pereche — este gratuită, sigură și atașată doar contului tău.
Deschide https://my.telegram.org în browser.
Introdu numărul în format internațional cu + — de exemplu +40712345678. Telegram trimite un cod de confirmare în aplicația ta.
După autentificare, fă clic pe API development tools în panoul de control.
Completează formularul — datele sunt stocate de Telegram pentru evidența lor și nu contează pentru funcționalitate. Platformă: Desktop. Fă clic pe Create application.
Vei vedea două valori — copiază-le pe amândouă:
1234567abcdef1234567890abcdef1234567890Oricine are API ID-ul, API Hash-ul și numărul tău de telefon poate accesa potențial contul tău Telegram. Nu le partaja niciodată în chat-uri, capturi de ecran sau forumuri publice.
Două metode de autentificare — alege-o pe cea mai confortabilă pentru tine.
Deschide ecranul Login și introdu:
+Telegram trimite un cod în aplicația ta (sau prin SMS). Apare un dialog — introdu codul. Dacă autentificarea cu doi factori este activată, urmează un prompt pentru parolă.
Numărul de telefon nu este necesar pentru autentificarea QR.
Se deschide o fereastră QR. Pe telefon:
Fereastra se închide automat la succes.
Numele tău apare în bara laterală. Sesiunea este stocată local — data viitoare când deschizi aplicația, ești deja autentificat.
În ~/.tg_analytics/sessions/. Pe Windows acesta este C:\Users\NumeleTau\.tg_analytics\sessions\. Pentru a te deconecta complet, folosește butonul "Sign out" din aplicație.
Două tipuri de canale: proprii (drepturi de admin) și orice canal public după @username.
Deschide secțiunea Channels. Canalele tale de admin apar automat în partea dreaptă — aplicația le extrage din dialogurile tale Telegram.
Aplicația preia fiecare canal în care ești admin sau owner. Acest lucru poate dura 10–30 de secunde la prima rulare.
Canalul se mută în coloana din stânga ("Tracked") și aplicația începe imediat să importe ultimele 100 de postări și numărul curent de abonați.
Funcția ucigătoare — urmărește orice canal deschis după @username, link t.me/... sau ID numeric.
Se deschide un modal cu un câmp de introducere.
Exemple de ce funcționează:
durov@durovt.me/durovhttps://t.me/durovAplicația rezolvă canalul și arată o previzualizare — titlu, @username și număr de abonați. Apoi începe urmărirea automată.
Doar canalele publice sunt disponibile pentru urmărire externă. Dacă vezi "channel is private" — trebuie să fii admin, sau canalul este doar pe invitație.
TG Analytics se concentrează pe canale de difuzare unde postarea este unidirecțională. Supergrupurile și chat-urile nu sunt urmărite — au dinamici și metrice diferite.
Ce înseamnă fiecare număr, cum este calculat și cum arată o valoare „bună”.
Numărul curent de persoane abonate la canal — la fel ca ceea ce arată Telegram public. TG Analytics salvează acest număr la fiecare ciclu de colectare, astfel încât să poți vedea cum se schimbă în timp.
Cât de mult s-a schimbat numărul de abonați în perioada selectată. Pozitiv = creștere, negativ = scădere. Arată efectul net al abonărilor noi minus dezabonările.
Numărul mediu de vizualizări pentru toate postările publicate în perioada selectată. Aceasta este linia ta de bază — fiecare postare nouă va fi judecată în raport cu ea.
Cea mai importantă metrică pentru compararea canalelor de dimensiuni diferite. Este procentul de abonați care au văzut postarea ta medie. Un canal cu 100k abonați și 15% ER este implicat; 500k abonați cu 2% ER este o coajă goală.
Numărul total de reacții emoji pe o postare. Un semnal puternic de implicare reală — reacțiile necesită o atingere activă, nu doar citire pasivă.
De câte ori a fost distribuită o postare către alt chat sau canal. Cel mai clar indicator al unei postări care „devine virală” — cuiva i-a plăcut suficient de mult încât să o partajeze cu propria audiență.
ER defalcat pe tip de postare: text, foto, video, document, sondaj. Acest lucru îți arată exact ce format performează cel mai bine pentru audiența ta specifică.
Nu urmări numerele absolute. Un canal de 3k cu 25% ER și abonați în creștere este mai sănătos decât un canal de 100k cu 2% ER. TG Analytics este construit să îți arate tendințele, nu metricele de vanitate.
Cum să citești graficul de creștere, de ce ar putea arăta doar date recente și la ce să fii atent.
De fiecare dată când TG Analytics colectează date, salvează un „instantaneu” al numărului curent de abonați. Graficul este o cronologie a acestor instantanee. Granularitatea se adaptează automat:
Pentru că Telegram nu expune istoricul abonaților prin API. TG Analytics îl poate înregistra doar din momentul în care începi urmărirea canalului. De-a lungul zilelor și săptămânilor, graficul se completează natural. Postările, vizualizările și reacțiile sunt preluate din istoricul propriu al Telegram — acelea sunt disponibile imediat.
Comută între filele 7Z / 30Z / 90Z / Tot timpul pentru a vedea același canal la diferite niveluri de zoom:
În loc de total, urmărește schimbarea pe 7 zile. Asta a produs de fapt conținutul și outreach-ul tău recent — totalul este în mare parte istorie.
O grilă 7×24 care arată vizualizările medii pe zi a săptămânii și oră, bazată pe canalul tău.
Fiecare celulă reprezintă o combinație zi-a-săptămânii × oră. Intensitatea culorii este media vizualizărilor postărilor publicate în acea fereastră. Albastru închis = vizualizări mari, albastru deschis = vizualizări mici, alb = nicio postare publicată în acel slot încă.
Aplicația evidențiază automat cel mai bun slot cu o bordură conturată și arată eticheta „Best: Mar, 17:00” în antetul cardului. Aceasta este fereastra ta calculată de implicare maximă.
Cu mai puțin de 10 postări, harta termică va fi în mare parte goală — nu există suficient semnal. Devine cu adevărat utilă după 30–50 de postări distribuite la diferite ore.
Învață de la câștigătorii tăi — care postări au rezonat cel mai mult și ce format funcționează cel mai bine.
Primele 10 postări ale perioadei selectate, clasate după vizualizări. Fiecare rând arată:
Un grafic inelar care arată câte postări de fiecare tip ai publicat, cu statistici per tip:
Culori: albastru pentru text, violet pentru foto, roz pentru video, portocaliu pentru document, verde pentru sondaj.
Până la 6 canale side-by-side — pentru portofoliul tău sau împotriva concurenței.
Selectează 2–6 canale din rândul de comutatoare. Primele două sunt pre-selectate automat.
Aceleași file 7Z / 30Z / 90Z / Tot ca pe panoul de control.
Rânduri: abonați, Δ pe perioadă, vizualizări medii, ER, număr de postări. Coloane: una per canal. Fiecare coloană are o dungă colorată care corespunde graficului multi-linie de mai jos.
O linie per canal pe o cronologie comună — identifică instantaneu care crește mai repede, sau care este plat.
Două grafice cu bare mai jos: unul pentru vizualizările medii, unul pentru ER. ER este comparația cea mai corectă când canalele au dimensiuni foarte diferite.
Un canal de 1k și un canal de 1M nu pot fi comparați prin numere absolute. Dar dacă canalul de 1k are 40% ER și cel de 1M are 8% ER, cel mic este mult mai implicat per abonat. Acesta este genul de perspectivă pentru care TGStat taxează.
Trei formate — pentru clienți, analize suplimentare sau backup.
Un raport A4 lustruit, conceput pentru a fi trimis clienților, managerilor sau părților interesate. Include:
Graficele sunt randate nativ în interiorul PDF-ului (via matplotlib) — nu ca imagini — astfel încât textul și numerele rămân clare la orice zoom.
Din cauza limitărilor de font în PDF, emoji din textele postărilor sunt eliminate în raportul PDF. Textul original complet este păstrat în exporturile JSON și CSV.
Un export structurat complet care include panoul agregat plus datele brute:
growth_series — fiecare instantaneu de abonațisnapshots — perechi brute timestamp + abonațiposts — fiecare postare cu text complet, vizualizări, reacții, distribuiri, media_typeheatmap — matricea 7×24top_posts, content_mixPerfect pentru analize suplimentare în Python, Excel sau orice instrument BI.
Tabel plat de postări pentru analiză în foi de calcul:
channel, date, msg_id, views, reactions, forwards, media_type, text; (compatibil Excel în majoritatea localurilor)Deschide panoul de control, fă clic pe Export în bara de instrumente. Alege un format, alege o locație de salvare — gata. Folderul implicit este ~/.tg_analytics/exports/ dar îl poți schimba în Setări.
Cât de des sunt preluate datele și cum să configurezi pentru nevoile tale.
Un fir de fundal se trezește conform programului și actualizează fiecare canal urmărit — unul câte unul, cu o pauză de 3 secunde între canale pentru a evita declanșarea protecției anti-flood a Telegram.
Bară laterală → Settings → secțiunea Collection.
Alege din dropdown. Schimbarea se aplică imediat — fără repornire.
Chiar sub dropdown, "Auto-collection status" arată: ora ultimei rulări, ETA următoarei rulări și intervalul curent.
Fă clic pe Collect now în Setări pentru o reîmprospătare imediată a tuturor canalelor. Bara de sus arată un spinner cu progres în timpul rulării. Util înainte de a genera un raport.
Intervalele foarte scurte (sub 15 minute) pe multe canale pot declanșa FloodWait. Dacă vezi erori frecvente de flood în jurnale, mărește intervalul.
Limbă, aspect, retenție, folder de export, jurnale — totul configurabil.
5 limbi acceptate în interfață: engleză, rusă, spaniolă, portugheză (BR), germană. Schimbă în Settings → Language — interfața se actualizează instantaneu fără repornire.
Trei moduri:
Poți de asemenea să ciclizați rapid prin teme făcând clic pe butonul de comutare a temei din colțul din dreapta sus al aplicației.
Cât timp să păstrezi instantaneele și postările vechi în baza de date locală:
O curățare zilnică rulează în fundal și șterge înregistrările mai vechi decât fereastra de retenție.
Unde sunt salvate fișierele PDF / JSON / CSV. Implicit este ~/.tg_analytics/exports/. Schimbă-l într-un folder dorit via Settings → Choose folder.
Jurnalele aplicației sunt stocate în ~/.tg_analytics/logs/:
app.log — jurnal general de activitate cu rotație (5 MB × 5 fișiere)crash.log — doar excepții netratate cu traceback completFă clic pe "Open folder" în Setări pentru a deschide directorul de jurnale în managerul tău de fișiere. Util pentru raportarea problemelor.
Butonul "Delete everything" elimină definitiv toate canalele urmărite și istoricul lor. Folosește-l dacă vrei un start curat. Nu afectează datele tale Telegram — doar baza de date locală de analiză.
Răspunsuri rapide la problemele comune.
Fă clic pe More info în dialog, apoi Run anyway. Acest lucru se întâmplă pentru că executabilul nu este semnat. Dacă nu ai încredere, construiește din sursă: clonează repo-ul și rulează python build.py.
Deschide Terminal și rulează: xattr -cr "/Applications/TG Analytics.app". Acest lucru elimină atributul de carantină pe care macOS îl adaugă aplicațiilor nesemnate. După aceea, fă clic dreapta → Open la prima lansare.
Nu. Telegram nu oferă istoricul abonaților prin API-ul său. Aplicația înregistrează instantanee din momentul în care începi urmărirea — așa că graficul începe cu un punct și crește pe măsură ce apar colectări noi. Cu intervale de 30 de minute, vei avea o curbă completă de 24h într-o zi.
Telegram limitează rata contului tău. Mărește intervalul de colectare automată (Settings → la fiecare 30 min sau mai mult) și reduce numărul de canale urmărite. Aplicația gestionează FloodWait automat făcând pauză — dar dacă îl vezi des, schimbă intervalul.
Doar canalele publice pot fi urmărite extern. Canalele private (doar pe invitație) nu sunt accesibile fără calitatea de membru. Dacă ești membru, canalul apare automat în lista ta de admin — verifică fila Channels.
Telegram poate revoca o sesiune dacă te autentifici de pe prea multe dispozitive sau resetezi manual sesiunile în Telegram. Trebuie doar să faci clic pe Sign out și să te autentifici din nou cu QR sau telefon. Canalele urmărite și datele de analiză sunt păstrate — trăiesc în baza de date locală, nu în sesiune.
Cel mai probabil o problemă de font lipsă. Verifică ~/.tg_analytics/logs/app.log pentru eroarea exactă și deschide un issue pe GitHub cu extrasul din jurnal. Ca soluție de rezervă, folosește exportul JSON / CSV care nu necesită fonturi.
Deschide un issue pe GitHub Issues sau trimite mesaj direct pe Telegram: @igor_shelloff. Include: ce ai făcut, ce s-a întâmplat și (dacă este posibil) un extras din jurnal.
TG Analytics este și va fi întotdeauna gratuit. Dacă îți economisește timp, iată cum poți ajuta.
Stelele ajută pe alții să descopere proiectul.
Deschide repoAi găsit o eroare sau ai o idee de funcție?
Deschide un issueSusține dezvoltarea ulterioară a instrumentului.
DoneazăÎntrebări sau feedback? Trimite mesaj direct.
@igor_shelloffDacă TG Analytics îți spune ce funcționează, dar ai nevoie și să publici și să faci outreach la scară largă — încearcă Telegram AutoPoster Pro de la același dezvoltator. Postare programată, campanii DM, multi-cont, story-uri, protecție auto-stop, rapoarte în Telegram.
Explorează Telegram AutoPoster Pro