DevLog Jour 3 : gamification, tokens et rétention
Comment CoachGPT utilise badges, tokens et défis pour améliorer la rétention fitness et garder les utilisateurs motivés sur le long terme.
10 mars 2026 · Arsène
DevLog Jour 3 : comment la gamification change la rétention utilisateur
Dans le DevLog Jour 2, j'ai expliqué comment fonctionne l'IA de CoachGPT. Aujourd'hui, je parle d'un problème que l'IA seule ne résout pas : comment garder les gens motivés sur le long terme ?
L'IA génère des programmes parfaits. Mais si l'utilisateur arrête d'ouvrir l'app au bout de deux semaines, le programme ne sert à rien.
Le problème de la rétention dans les apps fitness
Les statistiques sont brutales :
- 95 % des utilisateurs d'apps fitness abandonnent dans les 90 premiers jours
- La rétention J30 moyenne des apps fitness est de 12 à 15 %
- Le pic d'abandon se situe entre le jour 7 et le jour 14
Pourquoi ? Parce que la musculation est une activité où les résultats mettent des semaines, voire des mois, à apparaître. L'écart entre l'effort fourni et le résultat visible est énorme. Et sans gratification intermédiaire, les gens décrochent.
La gamification : combler le « gap de gratification »
La gamification ne rend pas la musculation « fun » au sens d'un jeu vidéo. Elle crée des micro-récompenses qui maintiennent l'engagement pendant que les vrais résultats physiques se construisent en arrière-plan.
Voici les mécanismes qu'on a implantés dans CoachGPT, et la psychologie derrière chacun.
Système de badges (40+ définitions)
Le concept
Les badges récompensent des comportements spécifiques : première séance, 10 séances consécutives, premier PR, 100 kg au squat, etc.
La psychologie : l'effet de complétion
Les humains ont un besoin inné de compléter les choses. Montrer un badge verrouillé avec les conditions pour le débloquer crée un objectif concret et atteignable. C'est le même mécanisme qui rend les succès Xbox/PlayStation addictifs.
Les catégories de badges dans CoachGPT
- Régularité : 7 jours de streak, 30 jours, 100 jours
- Force : PRs sur les mouvements composés (100 kg au squat, 60 kg au développé, etc.)
- Volume : total de kg soulevés (10 tonnes, 100 tonnes, 1 000 tonnes)
- Nutrition : jours de macros respectés, nombre de recettes créées
- Social : premier partage, premier ami, premier workout communautaire
- Exploration : premier usage de chaque feature (coach, nutrition, library, etc.)
L'implémentation technique
Chaque badge a un BadgeDefinition en base de données avec des conditions programmatiques. Un service de gamification vérifie les conditions après chaque action pertinente :
Action de l'utilisateur (séance terminée)
↓
GamificationService.checkBadges(userId, action)
↓
Vérification de toutes les conditions applicables
↓
Attribution des badges débloqués
↓
Notification frontend (toast + animation)
Le système est extensible : ajouter un nouveau badge ne nécessite qu'une nouvelle ligne dans la table BadgeDefinition. Pas de code à modifier.
Système de tokens : la monnaie virale
Le concept
Les tokens sont une monnaie virtuelle que les utilisateurs gagnent en partageant du contenu sur les réseaux sociaux, et qu'ils dépensent pour obtenir des avantages (jours de premium, badges exclusifs).
La psychologie : réciprocité et social proof
Quand un utilisateur partage un workout sur TikTok pour gagner 50 tokens, il crée du contenu marketing gratuit ET de la social proof pour CoachGPT. Les tokens transforment le marketing en jeu : l'utilisateur est récompensé, et l'app gagne en visibilité.
Les mécanismes anti-abus
Le système de tokens est conçu pour être résistant aux abus :
| Règle | Raison | |---|---| | Cooldown 24 h par plateforme | Empêche le spam de partages | | Caps par plateforme (TikTok : 14, autres : 20) | Limite le farming | | Max 5 soumissions en attente | Empêche le flood de modération | | Trust Score (0-100) | Les comptes fiables gagnent plus, les suspects moins | | Modération admin | Chaque soumission est vérifiée avant paiement |
Le Trust Score est calculé en fonction de l'ancienneté du compte, du taux d'acceptation des soumissions précédentes et du comportement général. Un compte neuf avec des partages douteux aura un score bas et des récompenses réduites.
Les prix des tokens
| Récompense | Coût | |---|---| | 7 jours de premium | 500 tokens | | 30 jours de premium | 1 500 tokens | | Badge exclusif | 200 tokens |
Et les gains :
| Action | Tokens gagnés | |---|---| | Partage TikTok | 50 | | Partage Instagram | 40 | | Partage X (Twitter) | 30 | | Partage LinkedIn | 25 | | Parrainage (inscription) | 100 | | Parrainage (premium) | 200 |
Un utilisateur actif peut accumuler assez de tokens pour du premium gratuit en quelques semaines de partage régulier.
Système de referral : Give 1 Get 1
Le concept
Le parrainage est le levier de croissance le plus puissant dans les apps consumer. Notre système est simple : parrainez quelqu'un, vous gagnez tous les deux.
Les récompenses
- Parrain : 100 tokens + 7 jours de premium
- Filleul : 50 tokens + 7 jours de premium
Le défi technique
Le code de parrainage doit survivre à un parcours utilisateur complexe :
- L'utilisateur clique sur un lien avec le code
- Il arrive sur la page d'inscription
- Il choisit Google OAuth (redirect Supabase)
- Il revient sur l'app après le callback OAuth
- Le code de parrainage doit encore être là
Solution : le code est persisté dans localStorage avant le redirect OAuth, et appliqué dans l'AppShell après le retour. Ça couvre tous les flux d'inscription (email, Google, Apple, phone).
Feed d'activité : la pression sociale positive
Le feed social montre les séances, PRs et badges des amis. L'effet psychologique est double :
- Social proof : « Mes amis s'entraînent, je devrais m'y mettre aussi »
- Compétition saine : voir un ami battre son PR vous pousse à faire pareil
Le feed est volontairement positif : pas de classements publics humiliants, pas de comparaisons de physique. Seulement des célébrations de progrès.
Streak et régularité : le mécanisme le plus puissant
Le concept
Un « streak » est une suite de jours consécutifs d'activité. Perdre un streak de 30 jours est psychologiquement douloureux — ce qui pousse à maintenir l'habitude.
L'équilibre fragile
Les streaks sont un couteau à double tranchant :
- Trop strict (doit s'entraîner tous les jours) : irréaliste, mène au burnout
- Trop laxiste (compte n'importe quelle activité) : perd son sens
Notre approche : le streak compte les semaines d'activité (au moins 3 séances dans la semaine), pas les jours consécutifs. Ça permet la flexibilité tout en récompensant la régularité.
Résultats observés
Depuis l'implémentation de la gamification, nos métriques internes montrent :
- Sessions par semaine : +35 % pour les utilisateurs qui interagissent avec les badges
- Rétention J30 : significativement améliorée chez les utilisateurs qui ont gagné au moins 1 badge
- Partages sociaux : les tokens génèrent un flux constant de contenu organique
La gamification ne remplace pas un bon produit. Mais elle transforme un bon produit en produit addictif.
La suite
Le DevLog Jour 4 portera sur le système de programmes multi-semaines et comment l'IA gère la périodisation automatique. C'est la feature qui transforme CoachGPT d'une app de « workouts ponctuels » en un vrai coach à long terme.
Si vous voulez tester la gamification en action — badges, tokens, streaks — inscrivez-vous sur CoachGPT. Les premiers résultats arrivent dès la première séance.
— Arsène
Cet article fait partie du DevLog CoachGPT. Retrouvez tous les épisodes sur coachgpt.fit/blog.