Premiers pas avec Google Analytics pour Flutter

Sélectionnez une plate-forme : iOS+ Android Web Flutter Unity C++

Ce guide de démarrage rapide explique 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 : tout ce qui se passe dans votre application, comme les actions de l'utilisateur, les événements du 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 leur préférence linguistique ou leur position géographique.

Analytics enregistre automatiquement certains événements et propriétés utilisateur. Il n'y a donc pas de code à ajouter 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 l'opération terminée, recréez votre application Flutter :

    flutter run

  3. Une fois installé, vous pouvez accéder au firebase_analytics plug-in 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 instance propriété 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 ; d'autres le sont pour des types d'entreprises 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 explique comment enregistrer un événement prédéfini. Pour en savoir plus sur l'enregistrement des événements, consultez la page Événements de journaux.

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