Plan de Tracking Analytics

1.1 Objectif du Document

Ce document définit le plan de tracking analytics de REWAPP, détaillant l'ensemble des événements à suivre, les propriétés associées, les outils utilisés et les modalités d'implémentation pour chaque plateforme de l'écosystème.

1.2 Périmètre

Le plan de tracking couvre les quatre composantes de l'écosystème REWAPP :

1.3 Principes Directeurs

• Conformité RGPD Consentement explicite avant tout tracking, anonymisation des données personnelles
• Privacy by Design Minimisation des données collectées, pseudonymisation des identifiants
• Qualité des données Nomenclature standardisée, validation des événements, documentation exhaustive
• Scalabilité Architecture permettant l'ajout de nouveaux événements sans refonte majeure

2.1 Objectifs du Tracking

2.2 Modèle de Données

REWAPP adopte un modèle de tracking basé sur trois dimensions :

2.3 Hiérarchie des Événements

3.1 Convention de Nommage

Règles :

• Tout en snake_case (minuscules, underscores)
• Verbe au passé (completed, created, viewed)
• Maximum 50 caractères
• Pas d'espaces ni caractères spéciaux

Exemples :

• user_registered → Utilisateur inscrit
• card_linked → Carte bancaire liée
• transaction_detected → Transaction détectée
• qr_code_generated → QR code généré
• points_credited → Points crédités

3.2 Catégories d'Événements

4.1 Application Mobile (iOS/Android)

4.1.1 Événements d'Authentification

4.1.2 Événements Carte Bancaire

4.1.3 Événements Transactions et Points

4.1.4 Événements QR Code

4.1.5 Événements Cashback Bancaire

4.1.6 Événements Fidélité

4.2 Site Vitrine (Next.js)

4.2.1 Événements Acquisition

4.2.2 Événements Partenaires

4.3 Dashboard Partenaire (PWA)

4.3.1 Événements Scan QR

4.3.2 Événements Configuration

4.4 Dashboard Admin

4.4.1 Événements Gestion Utilisateurs

5.1 Propriétés Identifiantes

5.2 Propriétés Comportementales

5.3 Propriétés de Segmentation

6.1 Propriétés Communes (Toutes plateformes)

6.2 Propriétés Contextuelles Mobile

6.3 Propriétés UTM (Acquisition)

7.1 Funnel d'Inscription

7.2 Funnel d'Activation (Liaison Carte)

7.3 Funnel de Conversion QR Code

8.1 Architecture Analytics

8.2 Segment (CDP)

Usage principal : Customer Data Platform, unification données

Configuration :

• Sources : Mobile iOS, Mobile Android, Web Site, Web Admin, Web Partner
• Destinations : GA4, Mixpanel, BigQuery, Brevo (email), FCM (push)
• Protocols : Schéma de validation des événements

8.3 Mixpanel

Usage principal : Analyse comportementale produit, funnels, cohortes

Fonctionnalités clés :

• Funnels : Tous les funnels définis en section 7
• Flows : Visualisation des parcours utilisateurs
• Retention : Courbes de rétention par cohorte
• Cohorts : Segmentation comportementale
• Impact : Analyse causale des fonctionnalités

9.1 SDK et Librairies

9.1.1 Application Mobile (Angular + Ionic)

9.2 Initialisation

9.2.1 Configuration Segment (Mobile)

import { createClient } from '@segment/analytics-react-native';

const segmentClient = createClient({
  writeKey: 'SEGMENT_WRITE_KEY',
  trackAppLifecycleEvents: true,
  trackDeepLinks: true,
  debug: __DEV__,
  flushAt: 20,
  flushInterval: 30,
});

9.2.2 Configuration Segment (Web)

import { AnalyticsBrowser } from '@segment/analytics-next';

const analytics = AnalyticsBrowser.load({
  writeKey: 'SEGMENT_WRITE_KEY',
});

9.3 Patterns d'Implémentation

9.3.1 Service de Tracking Centralisé

class AnalyticsService {
  track(eventName: string, properties: Record<string, any>) {
    const enrichedProperties = {
      ...properties,
      timestamp: new Date().toISOString(),
      app_version: getAppVersion(),
      platform: Platform.OS,
    };
    
    segmentClient.track(eventName, enrichedProperties);
  }
  
  identify(userId: string, traits: Record<string, any>) {
    segmentClient.identify(userId, traits);
  }
  
  screen(screenName: string, properties?: Record<string, any>) {
    segmentClient.screen(screenName, properties);
  }
}

9.3.2 Exemple : Tracking QR Code

const trackQRCode = {
  generated: (qrId: string, pointsAmount: number) => {
    const euroValue = pointsAmount * 0.105; // Ratio cashback
    
    analytics.track('qr_code_generated', {
      qr_id: qrId,
      points_amount: pointsAmount,
      euro_value: euroValue,
      validity_seconds: 60,
    });
  },
  
  scanned: (qrId: string, partnerId: string, pointsDebited: number) => {
    const euroValue = pointsDebited * 0.105;
    
    analytics.track('qr_code_scanned', {
      qr_id: qrId,
      partner_id: partnerId,
      points_debited: pointsDebited,
      euro_value: euroValue,
    });
  },
  
  expired: (qrId: string, pointsAmount: number, wasDisplayed: boolean) => {
    analytics.track('qr_code_expired', {
      qr_id: qrId,
      points_amount: pointsAmount,
      was_displayed: wasDisplayed,
    });
  },
};

9.4 Validation des Données

Schéma Segment Protocols

{
  "name": "qr_code_scanned",
  "rules": {
    "properties": {
      "qr_id": { "type": "string", "required": true },
      "partner_id": { "type": "string", "required": true },
      "points_debited": { "type": "integer", "required": true, "minimum": 10 },
      "euro_value": { "type": "number", "required": true }
    }
  }
}

9.5 Consentement et RGPD

10.1 Phases de Déploiement

10.2 Checklist de Validation

11.1 Rôles et Responsabilités

11.2 Alertes et Monitoring

12.1 Récapitulatif

Ce plan de tracking analytics définit une stratégie complète pour mesurer et optimiser l'ensemble de l'écosystème REWAPP :

12.2 Facteurs Clés de Succès

• Qualité des données Schéma validé, tests automatisés, monitoring continu
• Adoption équipes Formation, documentation accessible, dashboards self-service
• Évolutivité Architecture permettant l'ajout de nouveaux événements sans friction
• Privacy first Conformité RGPD intégrée dès la conception

12.3 Prochaines Étapes

1. 1

   Validation du plan

   Par les stakeholders (Product, Tech, Legal)

2. 2

   Setup des comptes

   Création des environnements analytics

3. 3

   Implémentation Phase 1

   Événements P0 critiques

4. 4

   Création dashboards

   Voir document 13.4 Tableaux de Bord

5. 5

   Formation équipes

   Product et Marketing