Was jede Metrik bedeutet, wie man das Dashboard liest und wie man bessere Entscheidungen aus Ihren Telegram-Daten trifft. Für Anfänger geschrieben – mit konkreten Zahlen und realen Benchmarks.
Was TG Analytics ist, warum Local-First wichtig ist und was Sie in dieser Anleitung lernen werden.
Alles, was Sie verfolgen, wird in einer lokalen SQLite-Datenbank auf Ihrem Computer gespeichert. Keine Konten, keine Server, keine Telemetrie. Der vollständige Quellcode ist auf GitHub unter der MIT-Lizenz verfügbar.
TG Analytics ist eine kostenlose Desktop-Anwendung, die Ihre Telegram-Kanäle in klare, umsetzbare Daten verwandelt. Es funktioniert mit Ihren eigenen Kanälen (in denen Sie Admin sind) und jedem öffentlichen Kanal – perfekt für die Führung Ihres Kanals und die Analyse von Wettbewerbern.
Weil Analyseplattformen wie TGStat und Telemetr von Ihnen verlangen, Ihre Daten an ihre Server zu übergeben – und in der Regel für erweiterte Funktionen zu bezahlen. TG Analytics behält alles auf Ihrer Maschine und bietet das volle Toolkit kostenlos.
Sie müssen nicht wissen, wie die Telegram-API funktioniert. Holen Sie sich einmal Ihre Anmeldeinformationen von my.telegram.org – und alles andere wird von der App erledigt.
Vorkompilierte Binärdateien für alle wichtigen Plattformen. Keine Installation, keine Abhängigkeiten.
Alle offiziellen Builds werden auf GitHub gehostet:
Neuestes Release öffnenchmod +x TGAnalytics-Linux)Speichern Sie sie an einem beliebigen Ort – Desktop, Dokumente, ein spezieller "Tools"-Ordner. Doppelklicken Sie zum Starten. Der erste Start kann 5–10 Sekunden dauern, während die Binärdatei entpackt wird.
Da die ausführbare Datei nicht mit einem kostenpflichtigen Code-Signaturzertifikat signiert ist, zeigt Windows möglicherweise eine Warnung an. Klicken Sie auf Weitere Informationen → Trotzdem ausführen. Sie können die App auch aus dem Quellcode erstellen, wenn Sie dies bevorzugen.
Öffnen Sie das Terminal und führen Sie xattr -cr "/Applications/TG Analytics.app" aus, nachdem Sie die App in den Programme-Ordner verschoben haben. Dies entfernt das Quarantäne-Flag für unsignierte Apps.
Jeder Telegram-Client benötigt api_id und api_hash vom offiziellen Entwicklerportal. Kostenlos, dauert 3 Minuten.
Sie fungieren als "Entwickler-Login" für Telegram. Jeder Drittanbieter-Client hat sein eigenes Paar. Sie werden Ihr eigenes erstellen – es ist kostenlos, sicher und nur mit Ihrem Konto verknüpft.
Öffnen Sie https://my.telegram.org in Ihrem Browser.
Geben Sie Ihre Nummer im internationalen Format mit + ein – zum Beispiel +491701234567. Telegram sendet einen Bestätigungscode an Ihre App.
Klicken Sie nach der Anmeldung im Dashboard auf API development tools.
Füllen Sie das Formular aus – die Daten werden von Telegram für ihre Unterlagen gespeichert und sind für die Funktionalität irrelevant. Plattform: Desktop. Klicken Sie auf Create application.
Sie sehen zwei Werte – kopieren Sie beide:
1234567abcdef1234567890abcdef1234567890Jeder, der Ihre API ID, Ihren API Hash und Ihre Telefonnummer kennt, kann möglicherweise auf Ihr Telegram-Konto zugreifen. Geben Sie diese niemals in Chats, Screenshots oder öffentlichen Foren weiter.
Zwei Anmeldemethoden – wählen Sie die für Sie bequemere.
Öffnen Sie den Login-Bildschirm und geben Sie ein:
+Telegram sendet einen Code an Ihre App (oder per SMS). Ein Dialog erscheint – geben Sie den Code ein. Wenn die Zwei-Faktor-Authentifizierung aktiviert ist, folgt eine Passwortabfrage.
Für den QR-Login ist keine Telefonnummer erforderlich.
Ein QR-Fenster öffnet sich. Auf Ihrem Telefon:
Das Fenster schließt sich nach einem erfolgreichen Scan automatisch.
Ihr Name erscheint in der Seitenleiste. Die Sitzung wird lokal gespeichert – beim nächsten Öffnen der App sind Sie bereits angemeldet.
In ~/.tg_analytics/sessions/. Unter Windows ist dies C:\Users\IhrName\.tg_analytics\sessions\. Um sich vollständig abzumelden, verwenden Sie den "Sign out"-Button in der App.
Zwei Arten von Kanälen: Ihre eigenen (Admin-Rechte) und jeden öffentlichen Kanal per @username.
Öffnen Sie den Bereich Channels. Ihre Admin-Kanäle erscheinen automatisch auf der rechten Seite – die App zieht sie aus Ihren Telegram-Dialogen.
Die App ruft jeden Kanal ab, in dem Sie Admin oder Eigentümer sind. Dies kann beim ersten Lauf 10–30 Sekunden dauern.
Der Kanal wandert in die linke Spalte ("Tracked") und die App beginnt sofort mit dem Import der letzten 100 Beiträge und der aktuellen Abonnentenzahl.
Das Killer-Feature – verfolgen Sie jeden offenen Kanal per @username, t.me/...-Link oder numerischer ID.
Öffnet ein Modal mit einem Eingabefeld.
Beispiele, die funktionieren:
durov@durovt.me/durovhttps://t.me/durovDie App löst den Kanal auf und zeigt eine Vorschau – Titel, @username und Abonnentenzahl. Dann beginnt sie automatisch mit der Verfolgung.
Nur öffentliche Kanäle sind für die externe Verfolgung verfügbar. Wenn Sie "channel is private" sehen – müssen Sie Admin sein, oder der Kanal ist nur auf Einladung zugänglich.
TG Analytics konzentriert sich auf Broadcast-Kanäle, bei denen das Posten einweg ist. Supergruppen und Chats werden nicht verfolgt – sie haben eine andere Dynamik und Metriken.
Was jede Zahl bedeutet, wie sie berechnet wird und wie ein "guter" Wert aussieht.
Die aktuelle Anzahl der Personen, die den Kanal abonniert haben – identisch mit dem, was Telegram öffentlich anzeigt. TG Analytics speichert diese Zahl bei jedem Sammlungszyklus, sodass Sie sehen können, wie sie sich im Laufe der Zeit ändert.
Um wie viel sich die Abonnentenzahl im ausgewählten Zeitraum verändert hat. Positiv = Wachstum, negativ = Rückgang. Zeigt den Nettoeffekt neuer Abonnements abzüglich Abmeldungen.
Die durchschnittliche Anzahl der Aufrufe über alle im ausgewählten Zeitraum veröffentlichten Beiträge. Dies ist Ihre Basislinie – jeder neue Beitrag wird daran gemessen.
Die wichtigste Metrik zum Vergleichen von Kanälen unterschiedlicher Größe. Es ist der Prozentsatz der Abonnenten, die Ihren durchschnittlichen Beitrag gesehen haben. Ein Kanal mit 100k Abonnenten und 15 % ER ist engagiert; 500k Abonnenten mit 2 % ER sind eine hohle Hülle.
Gesamtzahl der Emoji-Reaktionen auf einen Beitrag. Ein starkes Signal für echte Interaktion – Reaktionen erfordern einen aktiven Tap, nicht nur passives Lesen.
Wie oft ein Beitrag in einen anderen Chat oder Kanal weitergeleitet wurde. Der klarste Indikator für einen "viralen" Beitrag – jemand mochte ihn so sehr, dass er ihn mit seinem eigenen Publikum geteilt hat.
ER aufgeschlüsselt nach Beitragstyp: Text, Foto, Video, Dokument, Umfrage. Dies zeigt Ihnen genau, welches Format für Ihr spezifisches Publikum am besten funktioniert.
Jagen Sie keinen absoluten Zahlen hinterher. Ein 3k-Kanal mit 25 % ER und wachsenden Abonnenten ist gesünder als ein 100k-Kanal mit 2 % ER. TG Analytics soll Ihnen die Trends zeigen, nicht die Vanity-Metriken.
Wie man das Wachstumsdiagramm liest, warum es möglicherweise nur aktuelle Daten zeigt und worauf man achten sollte.
Jedes Mal, wenn TG Analytics Daten sammelt, speichert es einen "Snapshot" der aktuellen Abonnentenzahl. Das Diagramm ist eine Zeitachse dieser Snapshots. Die Granularität passt sich automatisch an:
Weil Telegram den Abonnentenverlauf nicht über die API offenlegt. TG Analytics kann ihn erst aufzeichnen, wenn Sie mit der Verfolgung des Kanals beginnen. Über Tage und Wochen füllt sich das Diagramm auf natürliche Weise. Beiträge, Aufrufe und Reaktionen werden aus der eigenen Historie von Telegram abgerufen – diese sind sofort verfügbar.
Wechseln Sie zwischen den Tabs 7D / 30D / 90D / All time, um denselben Kanal auf verschiedenen Zoomstufen zu sehen:
Achten Sie statt auf die Gesamtzahl auf die Veränderung über 7 Tage. Das ist es, was Ihre aktuellen Inhalte und Ihr Outreach tatsächlich bewirkt haben – die Gesamtzahl ist größtenteils Historie.
Ein 7×24-Raster, das durchschnittliche Aufrufe nach Wochentag und Stunde anzeigt, basierend auf Ihrem eigenen Kanal.
Jede Zelle repräsentiert eine Kombination aus Wochentag und Tagesstunde. Die Farbintensität sind die durchschnittlichen Aufrufe von Beiträgen, die in diesem Zeitfenster veröffentlicht wurden. Dunkelblau = hohe Aufrufe, hellblau = niedrige Aufrufe, weiß = noch keine Beiträge in diesem Slot veröffentlicht.
Die App hebt automatisch den besten Slot mit einem umrandeten Rahmen hervor und zeigt in der Kartenüberschrift "Best: Di, 17:00" an. Dies ist Ihr berechnetes Spitzen-Engagement-Fenster.
Mit weniger als 10 Beiträgen ist die Heatmap größtenteils leer – es gibt nicht genug Signal. Sie wird nach 30–50 Beiträgen, die über verschiedene Tageszeiten verteilt sind, wirklich nützlich.
Lernen Sie von Ihren Gewinnern – welche Beiträge am besten ankamen und welches Format am besten funktioniert.
Die Top-10-Beiträge des ausgewählten Zeitraums, sortiert nach Aufrufen. Jede Zeile zeigt:
Ein Donut-Diagramm, das zeigt, wie viele Beiträge jedes Typs Sie veröffentlicht haben, mit Statistiken pro Typ:
Farben: Blau für Text, Lila für Foto, Pink für Video, Orange für Dokument, Grün für Umfrage.
Bis zu 6 Kanäle nebeneinander – für Ihr Portfolio oder gegen Wettbewerber.
Wählen Sie 2–6 Kanäle aus der Toggle-Reihe. Die ersten beiden sind automatisch vorausgewählt.
Dieselben Tabs 7D / 30D / 90D / All wie auf dem Dashboard.
Zeilen: Abonnenten, Δ im Zeitraum, durchschnittliche Aufrufe, ER, Beitragsanzahl. Spalten: eine pro Kanal. Jede Spalte hat einen farbigen Streifen, der dem mehrzeiligen Diagramm darunter entspricht.
Eine Linie pro Kanal auf einer gemeinsamen Zeitachse – erkennen Sie sofort, welcher schneller wächst oder welcher flach ist.
Zwei Balkendiagramme darunter: eines für durchschnittliche Aufrufe, eines für ER. ER ist der fairste Vergleich, wenn Kanäle sehr unterschiedliche Größen haben.
Ein 1k-Kanal und ein 1M-Kanal können nicht anhand absoluter Zahlen verglichen werden. Aber wenn der 1k-Kanal 40 % ER und der 1M-Kanal 8 % ER hat, ist der kleinere pro Abonnent viel engagierter. Das ist die Art von Einblick, für die TGStat Geld verlangt.
Drei Formate – für Kunden, weitere Analysen oder als Backup.
Ein ausgefeilter A4-Bericht, der für Kunden, Manager oder Stakeholder konzipiert ist. Enthält:
Diagramme werden nativ im PDF gerendert (über matplotlib) – nicht als Bilder – sodass Text und Zahlen bei jedem Zoom gestochen scharf bleiben.
Aufgrund von Schriftbeschränkungen im PDF werden Emojis aus Beitragstexten im PDF-Bericht entfernt. Der vollständige Originaltext bleibt in JSON- und CSV-Exporten erhalten.
Ein vollständiger strukturierter Export, der das aggregierte Dashboard plus Rohdaten enthält:
growth_series – jeder Abonnenten-Snapshotsnapshots – Roh-Timestamp + Abonnenten-Paareposts – jeder Beitrag mit vollständigem Text, Aufrufen, Reaktionen, Weiterleitungen, media_typeheatmap – die 7×24-Matrixtop_posts, content_mixPerfekt für weitere Analysen in Python, Excel oder jedem BI-Tool.
Flache Tabelle von Beiträgen für die Tabellenkalkulationsanalyse:
channel, date, msg_id, views, reactions, forwards, media_type, text;-Trennzeichen (Excel-freundlich in den meisten Ländereinstellungen)Öffnen Sie das Dashboard und klicken Sie in der Symbolleiste auf Export. Wählen Sie ein Format, wählen Sie einen Speicherort – fertig. Der Standardordner ist ~/.tg_analytics/exports/, aber Sie können ihn in den Einstellungen ändern.
Wie oft Daten abgerufen werden und wie Sie es für Ihre Bedürfnisse konfigurieren.
Ein Hintergrund-Thread wacht nach Zeitplan auf und aktualisiert jeden verfolgten Kanal – einen nach dem anderen, mit einer 3-sekündigen Pause zwischen den Kanälen, um den Flood-Schutz von Telegram nicht auszulösen.
Seitenleiste → Einstellungen → Sammlungsbereich.
Wählen Sie aus dem Dropdown. Die Änderung gilt sofort – kein Neustart erforderlich.
Direkt unter dem Dropdown zeigt "Auto-collection status": letzte Laufzeit, nächste geplante Ausführung und aktuelles Intervall.
Klicken Sie in den Einstellungen auf Collect now für eine sofortige Aktualisierung aller Kanäle. Die obere Leiste zeigt während des Laufs einen Spinner mit Fortschritt. Nützlich vor dem Erstellen eines Berichts.
Sehr kurze Intervalle (unter 15 Minuten) bei vielen Kanälen können FloodWait auslösen. Wenn Sie in den Protokollen häufig Flood-Fehler sehen, erhöhen Sie das Intervall.
Sprache, Erscheinungsbild, Aufbewahrung, Exportordner, Protokolle – alles konfigurierbar.
5 Sprachen in der Oberfläche unterstützt: Englisch, Russisch, Spanisch, Portugiesisch (BR), Deutsch. Ändern Sie dies unter Einstellungen → Sprache – die Benutzeroberfläche aktualisiert sich sofort ohne Neustart.
Drei Modi:
Sie können auch schnell durch die Themes wechseln, indem Sie in der oberen rechten Ecke der App auf die Theme-Umschalttaste klicken.
Wie lange alte Snapshots und Beiträge in der lokalen Datenbank aufbewahrt werden sollen:
Eine tägliche Bereinigung läuft im Hintergrund und löscht Datensätze, die älter als das Aufbewahrungsfenster sind.
Wo PDF / JSON / CSV-Dateien gespeichert werden. Standard ist ~/.tg_analytics/exports/. Ändern Sie ihn in einen beliebigen Ordner über Einstellungen → Ordner wählen.
Anwendungsprotokolle werden in ~/.tg_analytics/logs/ gespeichert:
app.log – allgemeines Aktivitätsprotokoll mit Rotation (5 MB × 5 Dateien)crash.log – nur unbehandelte Ausnahmen mit vollständigem TracebackKlicken Sie in den Einstellungen auf "Ordner öffnen", um das Protokollverzeichnis in Ihrem Dateimanager zu öffnen. Nützlich für die Meldung von Problemen.
Die Schaltfläche "Alles löschen" entfernt dauerhaft alle verfolgten Kanäle und deren Historie. Verwenden Sie sie, wenn Sie einen Neuanfang wünschen. Sie wirkt sich nicht auf Ihre Telegram-Daten aus – nur auf die lokale Analysedatenbank.
Schnelle Antworten auf häufige Probleme.
Klicken Sie im Dialog auf Weitere Informationen, dann auf Trotzdem ausführen. Dies geschieht, weil die ausführbare Datei nicht codesigniert ist. Wenn Sie ihr nicht vertrauen, erstellen Sie sie aus dem Quellcode: Klonen Sie das Repo und führen Sie python build.py aus.
Öffnen Sie das Terminal und führen Sie aus: xattr -cr "/Applications/TG Analytics.app". Dies entfernt das Quarantäne-Attribut, das macOS zu unsignierten Apps hinzufügt. Danach beim ersten Start mit Rechtsklick → Öffnen.
Nein. Telegram stellt den Abonnentenverlauf nicht über seine API bereit. Die App zeichnet Snapshots ab dem Zeitpunkt auf, an dem Sie mit der Verfolgung beginnen – daher beginnt das Diagramm mit einem Punkt und wächst mit neuen Sammlungen. Mit 30-Minuten-Intervallen haben Sie innerhalb eines Tages eine vollständige 24-Stunden-Kurve.
Telegram drosselt Ihr Konto. Erhöhen Sie das Auto-Sammlungsintervall (Einstellungen → alle 30 Minuten oder mehr) und reduzieren Sie die Anzahl der verfolgten Kanäle. Die App behandelt FloodWait automatisch durch Pausieren – aber wenn Sie es oft sehen, ändern Sie das Intervall.
Nur öffentliche Kanäle können extern verfolgt werden. Private Kanäle (nur auf Einladung) sind ohne Mitgliedschaft nicht zugänglich. Wenn Sie Mitglied sind, erscheint der Kanal automatisch in Ihrer Admin-Liste – überprüfen Sie den Channels-Tab.
Telegram kann eine Sitzung widerrufen, wenn Sie sich von zu vielen Geräten aus anmelden oder Sitzungen in Telegram manuell zurücksetzen. Klicken Sie einfach auf Sign out und melden Sie sich erneut per QR oder Telefon an. Ihre verfolgten Kanäle und Analysedaten bleiben erhalten – sie leben in der lokalen Datenbank, nicht in der Sitzung.
Höchstwahrscheinlich ein fehlendes Schriftart-Problem. Überprüfen Sie ~/.tg_analytics/logs/app.log auf den genauen Fehler und öffnen Sie ein Issue auf GitHub mit dem Protokollauszug. Als Workaround verwenden Sie den JSON / CSV-Export, der keine Schriften benötigt.
Öffnen Sie ein Issue auf GitHub Issues oder schreiben Sie direkt auf Telegram: @igor_shelloff. Bitte geben Sie an: was Sie getan haben, was passiert ist und (falls möglich) einen Auszug aus dem Protokoll.
TG Analytics ist und bleibt kostenlos. Wenn es Ihnen Zeit spart, können Sie so helfen.
Sterne helfen anderen, das Projekt zu entdecken.
Repo öffnenEinen Fehler gefunden oder eine Feature-Idee?
Issue öffnenUnterstützen Sie die weitere Entwicklung des Tools.
SpendenFragen oder Feedback? Schreiben Sie direkt.
@igor_shelloffWenn TG Analytics Ihnen sagt, was funktioniert, Sie aber auch veröffentlichen und mit großer Reichweite kommunizieren müssen – probieren Sie Telegram AutoPoster Pro vom selben Entwickler. Geplantes Posten, DM-Kampagnen, Multi-Account, Stories, Auto-Stopp-Schutz, Berichte in Telegram.
Telegram AutoPoster Pro entdecken