Repository navigation
Instrumenter les événements analytics de la découverte #33
Description
Contexte
Epic : #8
Maquette : sans objet — instrumentation analytics des écrans E-01 à E-04, aucune planche à attendre ; à coder après #26, #27 et #28
Analytics · D-002
Comportement attendu
- Tous les événements de la section Découverte de la page Analytics émis avec leurs propriétés, typés dans
shared; les tickets E-01 à E-04 en émettent une partie, ce ticket vérifie la couverture et complète. - Réduction de la zone à l'arrondissement ou au quartier ; jamais de coordonnées précises.
- Funnel PostHog « Découverte » créé (ouverture → zone → fiche). Déplacé vers Vérifier les événements de la découverte dans PostHog staging #262.
- Événements ajoutés par D-023, typés dans
shared:paywall_shown(reason:premium_route,create_limit,premium_card;source:route,profile,profile_edit,settings,create),certified_info_opened(creator_id,own),profile_updated(fields[]:photo,bio,neighborhood,anecdotes,featured) ; KPI freemium de la page Analytics dans PostHog (déplacé vers Vérifier les événements de la découverte dans PostHog staging #262). Émission : voir les critères déplacés ci-dessous. - Facultatif (D-025) : événements de toast et de suppression de compte. La page Analytics ne les nomme pas encore : ils s'y ajoutent en DESIGN avant d'être émis.
- Événements ajoutés par D-029 :
go_arrived(route_id,step_index,suggested),go_stopped(route_id,steps_done_ratio),closed_by(user,auto) dansgo_completed,source(go_end,past) dansroute_rated. Typés ici, émis par Construire le parcours en cours et le lien Google Maps (E-07) #42, Noter un parcours en fin de sortie (E-15) et afficher les avis #64 et Clore automatiquement les sorties à 4:00 et envoyer la notification du matin #140. - Événement ajouté par D-033 :
go_step_skipped(route_id,step_index,reason:signaled,late,user). Typé ici, émis par Construire le parcours en cours et le lien Google Maps (E-07) #42.
Critères d'acceptation
- Liste de contrôle des événements dans la PR : écran qui émet, test des propriétés, relevé du journal local sur iOS et Android
- Test unitaire :
trackrefuse un événement ou une propriété hors schéma - Événements de D-023, D-029 et D-033 typés avec leurs propriétés dans
packages/shared/src/analytics.tset testés contre le catalogue
Déplacés le 2026-09-29 vers les tickets qui construisent leurs écrans, ou vers la recette PostHog :
- Observation de chaque événement dans PostHog en staging, funnel « Découverte » et KPI freemium : déplacé vers Vérifier les événements de la découverte dans PostHog staging #262
paywall_shownémis avec ses propriétés : déplacé vers Brancher RevenueCat et construire l'écran Premium (E-17) #67 (critère déjà présent)certified_info_openedémis avec ses propriétés : déplacé vers Implémenter la connexion (E-10), le profil (E-09) et la suppression de compte #38 (E-09,own: true) et Afficher le profil public de créateur (E-16) #65 (E-16)profile_updatedémis avec ses propriétés : déplacé vers Implémenter la connexion (E-10), le profil (E-09) et la suppression de compte #38go_arrived,go_stoppedetgo_completed.closed_by(user) émis avec leurs propriétés : déplacé vers Construire le parcours en cours et le lien Google Maps (E-07) #42 ;go_completed.closed_by(auto) : déplacé vers Clore automatiquement les sorties à 4:00 et envoyer la notification du matin #140route_rated.sourceémis : déplacé vers Noter un parcours en fin de sortie (E-15) et afficher les avis #64go_step_skippedémis avec sa raison : déplacé vers Construire le parcours en cours et le lien Google Maps (E-07) #42
Activity
PaulThiberville commentedon Sep 25, 2026
🔨 Démarrage — plan :
Branche
issue/33-discovery-analytics, empilée surissue/62-see-all-section(PR #157).packages/shared: le catalogue des événements devient un schéma Zod strict (un objet par événement), dont les types dérivent ; ajout des événements de D-023 (paywall_showncorrigé,certified_info_opened,profile_updated), D-029 (go_arrived,go_stopped,go_completed.closed_by,route_rated.source) et D-033 (go_step_skipped) ; retrait de ce que la page Analytics ne nomme pas.apps/mobile:trackvalide chaque événement contre ce schéma et refuse un événement ou une propriété hors schéma (rien n'est envoyé) ;citylimité à un identifiant de ville, aucune coordonnée ne peut passer ; journal local des événements en développement pour la recette.map_search_zone,result_card_viewedetroute_openedconstruites par des fonctions testées ; liste de contrôle dans la PR (émis / typés seulement, écran par écran).Les événements dont l'écran n'existe pas encore (profil, Go, notation, paywall E-17, recherche E-02, filtres E-03, fiche E-05) sont typés sans être émis ; les critères « observé dans PostHog en staging » et « funnel PostHog » demandent un accès à PostHog que je n'ai pas.
IlanAMG commentedon Sep 25, 2026
D-045 (décision d'Ilan, https://github.com/Inprogress-Agency/widoo-app/wiki/Design-Changelog) : ajouter purchase_failed (reason, hors annulation par l'utilisateur), purchase_pending et purchase_restored (found), avec plan et trial. Détail : https://github.com/Inprogress-Agency/widoo-app/wiki/Analytics
IlanAMG commentedon Sep 26, 2026
D-056 (https://github.com/Inprogress-Agency/widoo-app/wiki/Design-Changelog) : nouvel événement
route_reported(voir https://github.com/Inprogress-Agency/widoo-app/wiki/Analytics).PaulThiberville commentedon Sep 29, 2026
📋 MANAGER — @PaulThiberville, critères de ce ticket répartis avant la fusion de la PR #159, pour que #33 se ferme sur ce que la PR livre.
Critères qui restent (corps du ticket), tenus par la PR #159 d'après sa description. Les cases restent à cocher à la revue :
trackrefuse un événement ou une propriété hors schéma (packages/shared/src/analytics.test.ts,apps/mobile/src/analytics/analytics.test.ts).packages/shared/src/analytics.tset testés contre le catalogue.Critères déplacés :
paywall_shown: Brancher RevenueCat et construire l'écran Premium (E-17) #67 (critère déjà présent).certified_info_opened: Implémenter la connexion (E-10), le profil (E-09) et la suppression de compte #38 (E-09) et Afficher le profil public de créateur (E-16) #65 (E-16).profile_updated: Implémenter la connexion (E-10), le profil (E-09) et la suppression de compte #38.go_arrived,go_stopped,go_step_skippedetgo_completed.closed_by: user: Construire le parcours en cours et le lien Google Maps (E-07) #42.go_completed.closed_by: auto(côté serveur, clôture de 4:00) : Clore automatiquement les sorties à 4:00 et envoyer la notification du matin #140.route_rated.source: Noter un parcours en fin de sortie (E-15) et afficher les avis #64.Le réalignement du catalogue sur D-067 (sections, tri, liste « Voir tout ») reste à #220, qui attend la confirmation d'Ilan. Il ne bloque pas cette fusion.