Premiers pas avec Google Analytics


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

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

  • Événements : tout ce qui se passe dans votre application, comme les actions des utilisateurs, 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, comme la langue préférée ou la situation géographique.

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

Avant de commencer

  1. Installez firebase_core et ajoutez le code d'initialisation à votre application, si ce n'est pas déjà fait.
  2. Ajoutez votre application à votre projet Firebase dans la console Firebase.

Ajouter le SDK Analytics à votre application

  1. À la racine de votre projet Flutter, exécutez la commande suivante pour installer le plug-in :

    flutter pub add firebase_analytics
    
  2. Une fois cette étape effectuée, recréez votre application Flutter :

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

    import 'package:firebase_analytics/firebase_analytics.dart';
    
  4. Créez une instance Firebase Analytics en accédant à la propriété instance sur FirebaseAnalytics :

    FirebaseAnalytics analytics = FirebaseAnalytics.instance;
    

Commencer à enregistrer des événements

Une fois que vous avez créé une instance FirebaseAnalytics, vous pouvez commencer à enregistrer des événements avec les méthodes log de la bibliothèque.

Certains événements sont recommandés pour toutes les applications, tandis que d'autres le sont pour des types ou secteurs d'activité spécifiques. Vous devez envoyer les événements recommandés avec les paramètres qui leur sont associés pour obtenir des rapports aussi détaillés que possible, et bénéficier des dernières fonctionnalités et intégrations dès qu'elles sont disponibles. Cette section montre comment enregistrer un événement prédéfini. Pour en savoir plus sur l'enregistrement d'événements, consultez Enregistrer des é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'
  );

Étapes suivantes