Premiers pas avec Google Analytics


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

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

  • Événements:tout 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, comme la préférence linguistique ou l'emplacement géographique.

Analytics enregistre automatiquement certains événements et 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. À partir de 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 terminée, reconstruisez 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;

Démarrer la journalisation des événements

Une fois que vous avez créé une instance FirebaseAnalytics, vous pouvez commencer à consigner des événements à l'aide des méthodes log de la bibliothèque.

Certains événements sont recommandés pour toutes les applications, tandis que d'autres sont recommandés pour des types d'activités ou des secteurs spécifiques. Vous devez envoyer les événements recommandés avec leurs paramètres prescrits pour obtenir le plus de détails possible dans vos rapports, et profiter des futures fonctionnalités et intégrations dès qu'elles seront disponibles. Cette section montre comment consigner un événement prédéfini. Pour en savoir plus sur la journalisation des événements, consultez la section Événements de journaux.

Le code suivant consigne 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