Ce que signifie chaque métrique, comment lire le tableau de bord et comment prendre de meilleures décisions à partir de vos données Telegram. Écrit pour les débutants — avec des chiffres concrets et des repères du monde réel.
Ce qu'est TG Analytics, pourquoi le local-first est important et ce que vous allez apprendre dans ce guide.
Tout ce que vous suivez est stocké dans une base de données SQLite locale sur votre ordinateur. Pas de comptes, pas de serveurs, pas de télémétrie. Code source complet sur GitHub sous la Licence MIT.
TG Analytics est une application desktop gratuite qui transforme vos canaux Telegram en données claires et exploitables. Elle fonctionne avec vos propres canaux (où vous êtes admin) et n'importe quel canal public — parfait pour gérer votre canal et étudier les concurrents.
Parce que les plateformes analytiques comme TGStat et Telemetr vous obligent à confier vos données à leurs serveurs — et généralement à payer pour des fonctionnalités avancées. TG Analytics garde tout sur votre machine et vous donne la boîte à outils complète gratuitement.
Vous n'avez pas besoin de savoir comment fonctionne l'API Telegram. Obtenez simplement vos identifiants sur my.telegram.org une fois — et tout le reste est géré par l'application.
Binaires précompilés pour toutes les plateformes majeures. Aucune installation, aucune dépendance.
Toutes les versions officielles sont hébergées sur GitHub :
Ouvrir la dernière versionchmod +x TGAnalytics-Linux)Enregistrez-la n'importe où — Bureau, Documents, un dossier "Outils" dédié. Double-cliquez pour lancer. Le premier lancement peut prendre 5 à 10 secondes pendant que le binaire se décompresse.
Parce que l'exécutable n'est pas signé avec un certificat de signature de code payant, Windows peut afficher un avertissement. Cliquez sur Plus d'infos → Exécuter quand même. Vous pouvez également compiler l'application à partir du code source si vous préférez.
Ouvrez le Terminal et exécutez xattr -cr "/Applications/TG Analytics.app" après avoir déplacé l'application dans Applications. Cela supprime le drapeau de quarantaine pour les applications non signées.
Chaque client Telegram a besoin de api_id et api_hash depuis le portail développeur officiel. Gratuit, prend 3 minutes.
Ils fonctionnent comme un "login développeur" pour Telegram. Chaque client tiers a sa propre paire. Vous allez créer la vôtre — c'est gratuit, sûr et attaché uniquement à votre compte.
Ouvrez https://my.telegram.org dans votre navigateur.
Entrez votre numéro au format international avec le + — par exemple +33612345678. Telegram envoie un code de confirmation dans votre application.
Après la connexion, cliquez sur API development tools dans le tableau de bord.
Remplissez le formulaire — les données sont stockées par Telegram pour leurs dossiers et n'ont pas d'importance pour la fonctionnalité. Plateforme : Desktop. Cliquez sur Create application.
Vous verrez deux valeurs — copiez les deux :
1234567abcdef1234567890abcdef1234567890Toute personne possédant votre API ID, votre API Hash et votre numéro de téléphone peut potentiellement accéder à votre compte Telegram. Ne les partagez jamais dans des chats, des captures d'écran ou des forums publics.
Deux méthodes de connexion — choisissez celle qui est la plus confortable pour vous.
Ouvrez l'écran Connexion et entrez :
+Telegram envoie un code dans votre application (ou par SMS). Une boîte de dialogue apparaît — entrez le code. Si l'authentification à deux facteurs est activée, une invite de mot de passe suit.
Le numéro de téléphone n'est pas requis pour la connexion par QR.
Une fenêtre QR s'ouvre. Sur votre téléphone :
La fenêtre se ferme automatiquement en cas de succès.
Votre nom apparaît dans la barre latérale. La session est stockée localement — la prochaine fois que l'application s'ouvre, vous êtes déjà connecté.
Dans ~/.tg_analytics/sessions/. Sous Windows, c'est C:\Users\VotreNom\.tg_analytics\sessions\. Pour vous déconnecter complètement, utilisez le bouton "Se déconnecter" dans l'application.
Deux types de canaux : les vôtres (droits d'admin) et n'importe quel canal public par @nom d'utilisateur.
Ouvrez la section Canaux. Vos canaux d'administration apparaissent automatiquement sur le côté droit — l'application les récupère depuis vos dialogues Telegram.
L'application récupère chaque canal où vous êtes admin ou propriétaire. Cela peut prendre 10 à 30 secondes lors de la première exécution.
Le canal se déplace dans la colonne de gauche ("Suivi") et l'application commence immédiatement à importer les 100 derniers posts et le nombre d'abonnés actuel.
La fonctionnalité phare — suivez n'importe quel canal ouvert par @nom d'utilisateur, lien t.me/... ou ID numérique.
Ouvre un modal avec un champ de saisie.
Exemples de ce qui fonctionne :
durov@durovt.me/durovhttps://t.me/durovL'application résout le canal et affiche un aperçu — titre, @nom d'utilisateur et nombre d'abonnés. Ensuite, elle commence à suivre automatiquement.
Seuls les canaux publics sont disponibles pour le suivi externe. Si vous voyez "le canal est privé" — vous devez être admin, ou le canal est sur invitation uniquement.
TG Analytics se concentre sur les canaux de diffusion où la publication est unidirectionnelle. Les supergroupes et les chats ne sont pas suivis — ils ont des dynamiques et des métriques différentes.
Ce que signifie chaque chiffre, comment il est calculé, et à quoi ressemble une "bonne" valeur.
Le nombre actuel de personnes abonnées au canal — identique à ce que Telegram affiche publiquement. TG Analytics prend un instantané de ce nombre à chaque cycle de collecte, afin que vous puissiez voir comment il change au fil du temps.
De combien le nombre d'abonnés a changé sur la période sélectionnée. Positif = croissance, négatif = déclin. Montre l'effet net des nouveaux abonnements moins les désabonnements.
Le nombre moyen de vues sur tous les posts publiés pendant la période sélectionnée. C'est votre référence — chaque nouveau post sera jugé par rapport à elle.
La métrique la plus importante pour comparer des canaux de tailles différentes. C'est le pourcentage d'abonnés qui ont vu votre post moyen. Un canal de 100k abonnés avec 15% d'ER est engagé ; 500k abonnés avec 2% d'ER est une coquille vide.
Nombre total de réactions emoji sur un post. Un signal fort d'engagement réel — les réactions nécessitent un tap actif, pas seulement une lecture passive.
Combien de fois un post a été transféré vers un autre chat ou canal. L'indicateur le plus clair d'un post qui "devient viral" — quelqu'un l'a assez aimé pour le partager avec sa propre audience.
L'ER ventilé par type de post : texte, photo, vidéo, document, sondage. Cela vous montre exactement quel format performe le mieux pour votre audience spécifique.
Ne courez pas après les chiffres absolus. Un canal de 3k avec 25% d'ER et des abonnés en croissance est plus sain qu'un canal de 100k avec 2% d'ER. TG Analytics est conçu pour vous montrer les tendances, pas les métriques de vanité.
Comment lire le graphique de croissance, pourquoi il pourrait n'afficher que des données récentes, et ce qu'il faut rechercher.
Chaque fois que TG Analytics collecte des données, il enregistre un "instantané" du nombre d'abonnés actuel. Le graphique est une chronologie de ces instantanés. La granularité s'adapte automatiquement :
Parce que Telegram n'expose pas l'historique des abonnés via l'API. TG Analytics ne peut l'enregistrer qu'à partir du moment où vous commencez à suivre le canal. Au fil des jours et des semaines, le graphique se remplit naturellement. Les posts, vues et réactions sont récupérés depuis l'historique de Telegram — ceux-là sont disponibles immédiatement.
Basculez entre les onglets 7J / 30J / 90J / Tout temps pour voir le même canal à différents niveaux de zoom :
Au lieu du total, surveillez le changement sur 7 jours. C'est ce que votre contenu récent et votre prospection ont réellement produit — le total est en grande partie de l'histoire.
Une grille 7×24 montrant les vues moyennes par jour de la semaine et par heure, basée sur votre propre canal.
Chaque cellule représente une combinaison jour-de-la-semaine × heure-de-la-journée. L'intensité de la couleur est la moyenne des vues des posts publiés dans cette fenêtre. Bleu foncé = vues élevées, bleu clair = vues faibles, blanc = aucun post publié dans ce créneau pour l'instant.
L'application met automatiquement en évidence le meilleur créneau avec une bordure et affiche le libellé "Meilleur : Mar, 17:00" dans l'en-tête de la carte. C'est votre fenêtre de pic d'engagement calculée.
Avec moins de 10 posts, la carte thermique sera majoritairement vide — il n'y a pas assez de signal. Elle devient vraiment utile après 30 à 50 posts répartis sur différentes heures de la journée.
Apprenez de vos succès — quels posts ont le plus résonné, et quel format fonctionne le mieux.
Les 10 meilleurs posts de la période sélectionnée, classés par vues. Chaque ligne affiche :
Un graphique en anneau montrant combien de posts de chaque type vous avez publiés, avec des statistiques par type :
Couleurs : bleu pour le texte, violet pour la photo, rose pour la vidéo, orange pour le document, vert pour le sondage.
Jusqu'à 6 canaux côte à côte — pour votre portefeuille ou contre les concurrents.
Sélectionnez 2 à 6 canaux dans la rangée de bascule. Les deux premiers sont pré-sélectionnés automatiquement.
Mêmes onglets 7J / 30J / 90J / Tout que sur le tableau de bord.
Lignes : abonnés, Δ sur la période, vues moyennes, ER, nombre de posts. Colonnes : un par canal. Chaque colonne a une bande colorée correspondant au graphique multi-lignes ci-dessous.
Une ligne par canal sur une chronologie partagée — repérez instantanément lequel croît le plus vite, ou lequel est plat.
Deux graphiques en barres en dessous : un pour les vues moyennes, un pour l'ER. L'ER est la comparaison la plus juste lorsque les canaux ont des tailles très différentes.
Un canal de 1k et un canal de 1M ne peuvent pas être comparés par des chiffres absolus. Mais si le canal de 1k a 40% d'ER et le 1M a 8% d'ER, le plus petit est bien plus engagé par abonné. C'est le genre d'insight que TGStat facture.
Trois formats — pour les clients, une analyse plus poussée ou une sauvegarde.
Un rapport A4 soigné conçu pour être envoyé aux clients, managers ou parties prenantes. Inclut :
Les graphiques sont rendus nativement à l'intérieur du PDF (via matplotlib) — pas sous forme d'images — donc le texte et les chiffres restent nets à n'importe quel zoom.
En raison des limitations de police dans le PDF, les emojis des textes des posts sont supprimés dans le rapport PDF. Le texte original complet est préservé dans les exports JSON et CSV.
Un export structuré complet incluant le tableau de bord agrégé plus les données brutes :
growth_series — chaque instantané d'abonnéssnapshots — paires brutes timestamp + abonnésposts — chaque post avec texte complet, vues, réactions, partages, media_typeheatmap — la matrice 7×24top_posts, content_mixParfait pour une analyse plus poussée dans Python, Excel ou tout outil BI.
Tableau plat des posts pour l'analyse par tableur :
channel, date, msg_id, views, reactions, forwards, media_type, text; (compatible Excel dans la plupart des locales)Ouvrez le tableau de bord, cliquez sur Exporter dans la barre d'outils. Choisissez un format, choisissez un emplacement d'enregistrement — c'est fait. Le dossier par défaut est ~/.tg_analytics/exports/ mais vous pouvez le modifier dans les Paramètres.
À quelle fréquence les données sont récupérées, et comment le configurer selon vos besoins.
Un thread d'arrière-plan se réveille selon le calendrier et met à jour chaque canal suivi — un par un, avec une pause de 3 secondes entre les canaux pour éviter de déclencher la protection anti-flood de Telegram.
Barre latérale → Paramètres → section Collecte.
Choisissez dans le menu déroulant. Le changement s'applique immédiatement — pas besoin de redémarrer.
Juste en dessous du menu déroulant, "Statut de la collecte automatique" affiche : l'heure de la dernière exécution, l'ETA de la prochaine exécution et l'intervalle actuel.
Cliquez sur Collecter maintenant dans les Paramètres pour un rafraîchissement immédiat de tous les canaux. La barre supérieure affiche un spinner avec la progression pendant l'exécution. Utile avant de générer un rapport.
Des intervalles très courts (moins de 15 minutes) sur de nombreux canaux peuvent déclencher FloodWait. Si vous voyez fréquemment des erreurs de flood dans les journaux, augmentez l'intervalle.
Langue, apparence, rétention, dossier d'export, journaux — tout est configurable.
5 langues prises en charge dans l'interface : anglais, russe, espagnol, portugais (BR), allemand. Changez dans Paramètres → Langue — l'interface se met à jour instantanément sans redémarrage.
Trois modes :
Vous pouvez également parcourir les thèmes rapidement en cliquant sur le bouton de bascule de thème dans le coin supérieur droit de l'application.
Combien de temps conserver les anciens instantanés et posts dans la base de données locale :
Un nettoyage quotidien s'exécute en arrière-plan et supprime les enregistrements plus anciens que la fenêtre de rétention.
Où les fichiers PDF / JSON / CSV sont enregistrés. Par défaut, ~/.tg_analytics/exports/. Changez-le vers n'importe quel dossier via Paramètres → Choisir un dossier.
Les journaux de l'application sont stockés dans ~/.tg_analytics/logs/ :
app.log — journal d'activité général avec rotation (5 Mo × 5 fichiers)crash.log — uniquement les exceptions non gérées avec traceback completCliquez sur "Ouvrir le dossier" dans les Paramètres pour ouvrir le répertoire des journaux dans votre gestionnaire de fichiers. Utile pour signaler des problèmes.
Le bouton "Tout supprimer" supprime définitivement tous les canaux suivis et leur historique. Utilisez-le si vous voulez repartir de zéro. Cela n'affecte pas vos données Telegram — uniquement la base de données analytique locale.
Réponses rapides aux problèmes courants.
Cliquez sur Plus d'infos dans la boîte de dialogue, puis Exécuter quand même. Cela se produit parce que l'exécutable n'est pas signé. Si vous ne lui faites pas confiance, compilez à partir du code source : clonez le dépôt et exécutez python build.py.
Ouvrez le Terminal et exécutez : xattr -cr "/Applications/TG Analytics.app". Cela supprime l'attribut de quarantaine que macOS ajoute aux applications non signées. Après cela, faites un clic droit → Ouvrir lors du premier lancement.
Non. Telegram ne fournit pas l'historique des abonnés via son API. L'application enregistre des instantanés à partir du moment où vous commencez à suivre — donc le graphique commence avec un point et grandit à mesure que de nouvelles collectes ont lieu. Avec des intervalles de 30 minutes, vous aurez une courbe complète sur 24h en une journée.
Telegram limite le débit de votre compte. Augmentez l'intervalle de collecte automatique (Paramètres → toutes les 30 min ou plus) et réduisez le nombre de canaux suivis. L'application gère automatiquement FloodWait en se mettant en pause — mais si vous le voyez souvent, changez l'intervalle.
Seuls les canaux publics peuvent être suivis en externe. Les canaux privés (sur invitation uniquement) ne sont pas accessibles sans être membre. Si vous êtes membre, le canal apparaît automatiquement dans votre liste d'administration — vérifiez l'onglet Canaux.
Telegram peut révoquer une session si vous vous connectez depuis trop d'appareils ou réinitialisez manuellement les sessions dans Telegram. Cliquez simplement sur Se déconnecter et reconnectez-vous avec QR ou téléphone. Vos canaux suivis et vos données analytiques sont préservés — ils vivent dans la base de données locale, pas dans la session.
Probablement un problème de police manquante. Vérifiez ~/.tg_analytics/logs/app.log pour l'erreur exacte, et ouvrez un problème sur GitHub avec l'extrait du journal. Comme solution de contournement, utilisez l'export JSON / CSV qui ne nécessite pas de polices.
Ouvrez un problème sur GitHub Issues ou envoyez un message directement sur Telegram : @igor_shelloff. Incluez : ce que vous avez fait, ce qui s'est passé, et (si possible) un extrait du journal.
TG Analytics est et sera toujours gratuit. Si cela vous fait gagner du temps, voici comment vous pouvez aider.
Les stars aident les autres à découvrir le projet.
Ouvrir le dépôtVous avez trouvé un bug ou avez une idée de fonctionnalité ?
Ouvrir un problèmeSoutenez le développement continu de l'outil.
Faire un donQuestions ou commentaires ? Envoyez un message directement.
@igor_shelloffSi TG Analytics vous dit ce qui fonctionne, mais que vous avez aussi besoin de publier et de prospecter à grande échelle — essayez Telegram AutoPoster Pro du même développeur. Publication planifiée, campagnes DM, multi-comptes, stories, protection auto-stop, rapports dans Telegram.
Explorer Telegram AutoPoster Pro