Documentation
Premiers pas
comcom analytics est un tableau de bord d’analyse gratuit qui agrège automatiquement les messages, réactions, activité vocale et mouvements de membres de votre serveur Discord, et rend visibles la croissance et l’engagement de votre communauté. L’installation se fait en trois étapes.
- Rendez-vous sur analytics.comcom.app et connectez-vous avec Discord.
- Ajoutez le bot à un serveur où vous disposez de la permission « Gérer le serveur ».
- La collecte démarre automatiquement dès l’installation et les données apparaissent dans le tableau de bord.
Personnalisation
Exclure les données des bots
Vous pouvez exclure les messages des autres bots comme du bruit. En retirant les messages de bots de l’agrégation dans les paramètres, vous ne voyez que l’activité des membres humains.
Filtrer les salons
Vous pouvez choisir les salons textuels/vocaux à analyser. Excluez les salons d’administration ou de logs pour obtenir des chiffres plus fidèles à la réalité de votre communauté.
Gérer les observateurs (viewers)
Vous pouvez désigner les membres avec qui partager le tableau de bord. Il est aussi possible d’accorder un accès en lecture seule à des membres de l’équipe non administrateurs.
Découvrir le tableau de bord
La navigation de gauche vous permet d’examiner les différents aspects de votre communauté. Pour une présentation détaillée de chaque page avec captures d’écran, consultez /product.
| Page | Contenu |
|---|---|
| Résumé | Tendances globales, résumé hebdomadaire par IA et composition des membres au même endroit. |
| Salons | Classement et évolution par salon textuel/vocal. |
| Rôles | Nombre de membres et activité par rôle. |
| Membres | Historique d’activité individuel et cartes de membre. |
| Comparaison | Situez votre serveur en nombre de membres et en activité parmi les serveurs de la même catégorie, via des indicateurs relatifs anonymes (nécessite de définir un tag de catégorie). |
| Arrivées | Évolution des arrivées et départs, et classement des entrées par lien d’invitation. |
| Statistiques | Séries temporelles des messages, réactions et activité vocale, plus un nuage de points par salon. |
| Journaux d’activité | Recherchez et consultez les journaux individuels de réactions et d’activité vocale. |
Commandes Discord
Toutes les fonctionnalités sont accessibles via la commande /comcom (sous-commandes) dans Discord. Certaines sous-commandes peuvent varier selon l’environnement.
| Commande | Contenu |
|---|---|
| /comcom member <user> | Carte d’analyse du membre. Bascule entre le HUD animé LV/EXP ⇄ tableau de bord détaillé. |
| /comcom channels | Tableau de bord d’aperçu du serveur ⇄ classement des salons (par messages / par vocal). |
| /comcom leaderboard | Classement EXP du serveur + votre position. |
| /comcom heatmap | Carte thermique d’activité (jour de la semaine × heure, messages + vocal). |
| /comcom room | GIF de « chambre » en pixel art + navigation par boutons. |
| /comcom poll | Créez un sondage communautaire (question / options / durée / choix multiples). |
| /comcom help | Affiche la liste de toutes les commandes. |
| /comcom slot | Tire au sort un membre, avec une animation GIF (sans lot). |
Fonctionnement des EXP / niveaux / rangs
L’EXP est une valeur cumulative calculée à partir de l’activité enregistrée : elle ne fait qu’augmenter (jamais diminuer).
dailyEXP = min(messages,100)·1 + max(0,messages-100)·0.25 // soft cap
+ min(voiceMinutes,240)·0.5 // 4h/day cap
+ reactionsGiven·0.5 + reactionsReceived·1 + mentionsReceived·1
EXP = Σ dailyEXP (all recorded days, only grows)
Level = floor( sqrt(EXP / 50) )Titres selon le niveau : Newcomer (0–4) → Regular (5–11) → Active (12–21) → Veteran (22–34) → Elite (35–49) → Legend (50+). L’EXP, le niveau et le rang sur toute la période sont mis à jour chaque nuit par un traitement par lots.
Bonnes pratiques
Conseils d’utilisation
- L’activité vocale s’accumule à partir de l’installation. Le rang sur toute la période apparaît après la mise à jour nocturne.
- Examiner ensemble messages, vocal et réactions révèle des membres qui contribuent même s’ils écrivent peu.
- La carte thermique permet d’identifier les heures les plus actives et d’optimiser le moment des événements et annonces.
Confidentialité
La carte de membre ne peut être exécutée que par le membre lui-même pour se consulter, ou par un administrateur disposant de la permission « Gérer le serveur ». Les actions des boutons sont réservées à la personne qui a exécuté la commande. Aucune donnée personnelle (PII), comme les adresses e-mail, n’est exposée, ni dans le tableau de bord ni via l’API/MCP.
Lecture des données
Les chiffres reposent sur les données réelles collectées depuis l’installation. L’EXP sur toute la période, le rang et le vocal sur toute la période sont mis à jour par un calcul nocturne (precompute) ; juste après l’installation, certaines valeurs peuvent donc apparaître comme « en attente ».
FAQ
Est-ce gratuit ?
Oui. Le tableau de bord de base et les commandes sont entièrement gratuits. Le plan payant (Pro), tarifé selon la taille du serveur, ajoute des fonctionnalités comme l’accès API/MCP.
Peut-on récupérer les données passées ?
Non. La collecte commence à l’installation du bot. Impossible de récupérer les données antérieures.
Les commandes ne s’affichent pas.
La propagation des commandes globales peut prendre quelques minutes. Rechargez Discord avec Ctrl/Cmd+R pour vider le cache.
Que deviennent nos données si nous retirons le bot ?
Retirer le bot interrompt l’accès au tableau de bord. Si vous le réinstallez, la collecte reprend à partir de ce moment — la période sans bot reste sans données.
Peut-on comparer plusieurs serveurs, ou se comparer à d’autres ?
Oui. Les serveurs que vous gérez peuvent être affichés ensemble depuis le coin supérieur droit des pages comme Résumé (administrateurs uniquement, tous les serveurs au plan Pro). La comparaison avec d’autres serveurs est disponible sur la page « Comparaison » sous forme d’indicateurs relatifs anonymes, une fois un tag de catégorie défini. Les noms de serveurs et les informations des membres ne sont jamais divulgués aux autres gestionnaires.
Dépannage
Les données sont vides ou rares juste après l’installation
La collecte commençant à l’installation du bot, il est normal d’avoir peu de données au début. Les chiffres se stabilisent après quelques jours à une semaine d’activité normale.
Les chiffres du vocal semblent en retard sur les autres indicateurs
Une partie de l’agrégation vocale est traitée par un lot nocturne : un décalage pouvant atteindre quelques jours par rapport aux messages et réactions est possible. Le retard se résorbe automatiquement.
La carte de membre ne se lance pas, ou les boutons ne répondent pas
La carte de membre ne peut être exécutée que par le membre lui-même pour voir sa propre carte, ou par un administrateur disposant de la permission « Gérer le serveur ». Les boutons ne répondent qu’à la personne qui a lancé la commande ; si d’autres membres cliquent, rien ne se passe.
Une erreur de permissions insuffisantes s’affiche
L’installation du bot et la modification des paramètres exigent la permission « Gérer le serveur » côté Discord. Si l’erreur persiste malgré des permissions correctes, rechargez le tableau de bord pour actualiser les informations de permissions en cache.