Implémentation (pour les devs)

Annexe technique. Le reste de la section Tracking est lisible sans ça.

Où vivent les events

Chaque plateforme a un service central avec un enum typé des events — on ne passe jamais une chaîne libre :

• iOS : kaiho-ios/Kaiho/Core/Data/Services/AnalyticsService.swift (enum AnalyticsEvent), appelé via analytics.track(event:properties:), injecté par Factory.
• Android : kaiho-android/app/src/main/java/com/kaiho/app/data/service/AnalyticsService.kt (enum AnalyticsEvent).

Ajouter un event = l’ajouter à l’enum des deux côtés (sauf event volontairement propre à une plateforme, comme l’ATT iOS), puis l’appeler depuis le ViewModel concerné. Et mettre à jour le catalogue dans la foulée.

Règles

• Tracker dans les ViewModels, jamais dans les vues « bêtes » (dumb views). Tous les events actuels partent d’un ViewModel.
• Jamais de tracking dans onAppear / LaunchedEffect — on tracke au moment de l’action utilisateur, pas au rendu d’un écran (sinon on compte des affichages parasites).
• Pas de PII dans les events. L’email est explicitement retiré des propriétés avant envoi, y compris dans identify().

Configuration PostHog

Identique iOS / Android :

• captureApplicationLifecycleEvents = true → l’ouverture d’app est capturée automatiquement (event lifecycle Application Opened). Le code actuel n’émet pas d’event maison app_opened — un ancien app_opened subsiste seulement dans les données des vieilles versions (voir le catalogue).
• captureScreenViews = false → pas de vue d’écran automatique ; on tracke manuellement ce qui compte.
• personProfiles = identifiedOnly → seuls les utilisateurs identifiés deviennent des « persons ». Les events anonymes avant identify() ne créent pas de profil.
• preloadFeatureFlags = false, sendFeatureFlagEvent = false.
• debug activé uniquement en build DEBUG.

Identité

• identify() est appelé à l’inscription (nouvel utilisateur) et à la connexion (revenant, via SessionBootstrapper).
• À l’inscription, RevenueCat logIn() relie l’ID anonyme RevenueCat à l’ID réel, et pose l’attribut $posthogUserId (cohérence cross-plateforme).
• L’attribution TikTok a son propre identify(), séparé de PostHog.

Confidentialité & opt-out

• Un réglage de profil bascule optOut() / optIn() : il coupe à la fois l’analytics et l’attribution publicitaire.
• Le mode démo désactive tout le tracking (service no-op).
• L’état d’opt-out est persistant et ré-appliqué à chaque lancement.

Comportements particuliers à connaître

• Compteur de vues paywall : chaque paywall_viewed incrémente un compteur local utilisé pour l’éligibilité à la promo « comeback » (voir Monétisation).
• Dédup des succès : achievement_unlocked ne part qu’une fois par appareil (set persistant), pour ne pas re-fire après une mise à jour.
• key_completed ne part qu’à la transition incomplet → complet (pas à chaque recréation du ViewModel).