Catch up on highlights from Firebase at Google I/O 2023. Learn more

Premiers pas avec Google Analytics

Ce guide de démarrage rapide vous montre comment ajouter Google Analytics à votre application et commencer à enregistrer des événements.

Google Analytics collecte des données d'utilisation et de comportement pour votre application. Le SDK enregistre deux principaux types d'informations :

  • Événements : Ce qui se passe dans votre application, comme les actions de l'utilisateur, les événements système ou les erreurs.
  • Propriétés utilisateur : attributs que vous définissez pour décrire des segments de votre base d'utilisateurs, tels que la préférence linguistique ou l'emplacement géographique.

Analytics enregistre automatiquement certains événements et propriétés utilisateur ; vous n'avez pas besoin d'ajouter de code pour les activer.

Avant que tu commences

  1. Installez firebase_core et ajoutez le code d'initialisation à votre application si vous ne l'avez pas déjà fait.
  2. Ajoutez votre application à votre projet Firebase dans la console Firebase .

Ajouter le SDK Analytics à votre application

  1. Depuis la racine de votre projet Flutter, exécutez la commande suivante pour installer le plugin :

    flutter pub add firebase_analytics
    
  2. Une fois terminé, reconstruisez votre application Flutter :

    flutter run
    
  3. Une fois installé, vous pouvez accéder au plugin firebase_analytics en l'important dans votre code Dart :

    import 'package:firebase_analytics/firebase_analytics.dart';
    
  4. Créez une nouvelle instance Firebase Analytics en appelant le getter instance sur FirebaseAnalytics :

    FirebaseAnalytics analytics = FirebaseAnalytics.instance;
    

Commencer à consigner les événements

Après avoir créé une instance FirebaseAnalytics , vous pouvez commencer à consigner les événements avec les méthodes log de la bibliothèque.

Certains événements sont recommandés pour toutes les applications ; d'autres sont recommandés pour des types d'entreprises ou des secteurs verticaux spécifiques. Vous devez envoyer des événements suggérés avec leurs paramètres prescrits, afin de garantir un maximum de détails disponibles dans vos rapports et de bénéficier des futures fonctionnalités et intégrations dès qu'elles seront disponibles. Cette section illustre la journalisation d'un événement prédéfini. Pour plus d'informations sur la journalisation des événements, consultez Journaliser les événements .

Le code suivant enregistre un événement de paiement :

await FirebaseAnalytics.instance
  .logBeginCheckout(
    value: 10.0,
    currency: 'USD',
    items: [
      AnalyticsEventItem(
        itemName: 'Socks',
        itemId: 'xjw73ndnw',
        price: '10.0'
      ),
    ],
    coupon: '10PERCENTOFF'
  );

Prochaines étapes