DevLog Jour 3 : Comment la gamification change la retention utilisateur

Dans le DevLog Jour 2, j'ai explique comment fonctionne l'IA de CoachGPT. Aujourd'hui, je parle d'un probleme que l'IA seule ne resout pas : comment garder les gens motives sur le long terme ?

L'IA genere des programmes parfaits. Mais si l'utilisateur arrete d'ouvrir l'app au bout de 2 semaines, le programme ne sert a rien.

Le probleme de la retention dans les apps fitness

Les statistiques sont brutales :

• 95% des utilisateurs d'apps fitness abandonnent dans les 90 premiers jours
• La retention 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 activite ou les resultats mettent des semaines (voire des mois) a apparaitre. L'ecart entre l'effort fourni et le resultat visible est enorme. Et sans gratification intermediaire, les gens decrochent.

La gamification : combler le "gap de gratification"

La gamification ne rend pas la musculation "fun" au sens d'un jeu video. Elle cree des micro-recompenses qui maintiennent l'engagement pendant que les vrais resultats (physiques) se construisent en arriere-plan.

Voici les mecanismes qu'on a implantes dans CoachGPT, et la psychologie derriere chacun.

Systeme de badges (40+ definitions)

Le concept

Les badges recompensent des comportements specifiques : premiere seance, 10 seances consecutives, premier PR, 100 kg au squat, etc.

La psychologie : l'effet de completion

Les humains ont un besoin inne de completer les choses. Montrer un badge verrouille avec les conditions pour le debloquer cree un objectif concret et atteignable. C'est le meme mecanisme qui rend les succes Xbox/PlayStation addictifs.

Les categories de badges dans CoachGPT

• Regularite : 7 jours de streak, 30 jours, 100 jours
• Force : PRs sur les mouvements composes (100 kg squat, 60 kg developpe, etc.)
• Volume : total de kg souleves (10 tonnes, 100 tonnes, 1 000 tonnes)
• Nutrition : jours de macros respectes, nombre de recettes creees
• Social : premier partage, premier ami, premier workout communautaire
• Exploration : premier usage de chaque feature (coach, nutrition, library, etc.)

L'implementation technique

Chaque badge a un BadgeDefinition en base de donnees avec des conditions programmatiques. Un service de gamification verifie les conditions apres chaque action pertinente :

Action de l'utilisateur (seance terminee)
    ↓
GamificationService.checkBadges(userId, action)
    ↓
Verification de toutes les conditions applicables
    ↓
Attribution des badges debloques
    ↓
Notification frontend (toast + animation)

Le systeme est extensible : ajouter un nouveau badge ne necessite qu'une nouvelle ligne dans la table BadgeDefinition. Pas de code a modifier.

Systeme de tokens : la monnaie virale

Le concept

Les tokens sont une monnaie virtuelle que les utilisateurs gagnent en partageant du contenu sur les reseaux sociaux, et qu'ils depensent pour obtenir des avantages (jours de premium, badges exclusifs).

La psychologie : reciprocite et social proof

Quand un utilisateur partage un workout sur TikTok pour gagner 50 tokens, il cree du contenu marketing gratuit ET de la social proof pour CoachGPT. Les tokens transforment le marketing en jeu : l'utilisateur est recompense, et l'app gagne en visibilite.

Les mecanismes anti-abus

Le systeme de tokens est concu pour etre resistant aux abus :

Le Trust Score est calcule en fonction de l'anciennete du compte, du taux d'acceptation des soumissions precedentes, et du comportement general. Un compte neuf avec des partages douteux aura un score bas et des recompenses reduites.

Les prix des tokens

Et les gains :

Un utilisateur actif peut accumuler assez de tokens pour du premium gratuit en quelques semaines de partage regulier.

Systeme de referral : Give 1 Get 1

Le concept

Le parrainage est le levier de croissance le plus puissant dans les apps consumer. Notre systeme est simple : parrainez quelqu'un, vous gagnez tous les deux.

Les recompenses

• Parrain : 100 tokens + 7 jours de premium
• Filleul : 50 tokens + 7 jours de premium

Le defi technique

Le code de parrainage doit survivre a un parcours utilisateur complexe :

1. L'utilisateur clique sur un lien avec le code
2. Il arrive sur la page d'inscription
3. Il choisit Google OAuth (redirect Supabase)
4. Il revient sur l'app apres le callback OAuth
5. Le code de parrainage doit encore etre la

Solution : le code est persiste dans localStorage avant le redirect OAuth, et applique dans l'AppShell apres le retour. Ca couvre tous les flux d'inscription (email, Google, Apple, phone).

Feed d'activite : la pression sociale positive

Le feed social montre les seances, PRs et badges des amis. L'effet psychologique est double :

1. Social proof : "Mes amis s'entrainent, je devrais m'y mettre aussi"
2. Competition saine : voir un ami battre son PR vous pousse a faire pareil

Le feed est volontairement positif : pas de classements publics humiliants, pas de comparaisons de physique. Seulement des celebrations de progres.

Streak et regularite : le mecanisme le plus puissant

Le concept

Un "streak" est une suite de jours consecutifs d'activite. Perdre un streak de 30 jours est psychologiquement douloureux — ce qui pousse a maintenir l'habitude.

L'equilibre fragile

Les streaks sont un couteau a double tranchant :

• Trop strict (doit s'entrainer tous les jours) : irrealiste, mene au burnout
• Trop laxiste (compte n'importe quelle activite) : perd son sens

Notre approche : le streak compte les semaines d'activite (au moins 3 seances dans la semaine), pas les jours consecutifs. Ca permet la flexibilite tout en recompensant la regularite.

Resultats observes

Depuis l'implementation de la gamification, nos metriques internes montrent :

• Sessions par semaine : +35% pour les utilisateurs qui interagissent avec les badges
• Retention J30 : significativement amelioree chez les utilisateurs qui ont gagne au moins 1 badge
• Partages sociaux : les tokens generent 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 systeme de programmes multi-semaines et comment l'IA gere la periodisation automatique. C'est le feature qui transforme CoachGPT d'une app de "workouts ponctuels" en un vrai coach a long terme.

Si vous voulez tester la gamification en action — badges, tokens, streaks — inscrivez-vous sur CoachGPT. Les premiers resultats arrivent des la premiere seance.

— Arsene

---

Cet article fait partie du DevLog CoachGPT. Retrouvez tous les episodes sur coachgpt.fit/blog.