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 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 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 propriétés utilisateur. Vous n'avez donc pas besoin d'ajouter de code pour les activer.

Avant de commencer

Si ce n'est pas encore fait, ajoutez Firebase à votre projet Android et assurez-vous que Google Analytics est activé dans votre projet Firebase :

  • S'il s'agit d'un nouveau projet Firebase, activez Google Analytics pendant que vous le créez.

  • Si vous utilisez un projet Firebase existant où Google Analytics n'est pas activé, activez-le en accédant à l'onglet Intégrations de > Paramètres du projet.

Lorsque vous activez Google Analytics dans votre projet, vos applications Firebase sont associées à des flux de données Google Analytics.

Ajouter le SDK Analytics à votre application

  1. Dans le fichier Gradle de votre module (au niveau de l'application) (généralement <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle), ajoutez la dépendance pour la bibliothèque Analytics pour Android. Nous vous recommandons d'utiliser Firebase Android BoM pour contrôler le versionnage de la bibliothèque. 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.16.0"))

    // Add the dependency for the Analytics library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-analytics")
}

    En utilisant la Firebase Android BoM, votre application utilisera toujours des versions compatibles des bibliothèques Firebase Android.

    (Alternative)  Ajoutez les dépendances de la bibliothèque Firebase sans utiliser BoM.

    Si vous choisissez de ne pas utiliser Firebase BoM, vous devez spécifier la version de chaque bibliothèque Firebase sur sa ligne de dépendance.

    Notez que si vous utilisez plusieurs bibliothèques Firebase dans votre application, nous vous recommandons vivement d'utiliser BoM pour gérer les versions des bibliothèques, ce qui garantit que toutes les versions sont compatibles. 

    dependencies {
    // Add the dependency for the Analytics library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-analytics:22.5.0")
}
         Vous recherchez un module de bibliothèque spécifique à Kotlin ? À partir d'octobre 2023 (Firebase BoM 32.5.0), les développeurs Kotlin et Java pourront dépendre du module de bibliothèque principal (pour en savoir plus, consultez les questions fréquentes sur cette initiative).

  2. Déclarez l'objet com.google.firebase.analytics.FirebaseAnalytics en haut de votre activité :

    Kotlin 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. Initialisez-le dans la méthode onCreate() :

    Kotlin 

    // Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analytics
    MainActivity.kt

    Java 

    // Obtain the FirebaseAnalytics instance.
mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
    MainActivity.java

Commencer à enregistrer des événements

Une fois que vous avez créé une instance FirebaseAnalytics, vous pouvez commencer à enregistrer des événements avec la méthode logEvent().

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 suggéré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 consignation d'événements, consultez Consigner des événements.

Le code suivant enregistre un événement SELECT_CONTENT lorsqu'un utilisateur clique sur un élément spécifique de votre application.

Kotlin 

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

Java 

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
MainActivity.java

Vous pouvez activer la journalisation détaillée pour surveiller la journalisation des événements par le SDK et vérifier que les événements sont correctement enregistrés. Cela inclut les événements enregistrés automatiquement et manuellement.

Vous pouvez activer la journalisation détaillée à l'aide d'une série de commandes adb :

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

Cette commande affiche vos événements dans le logcat Android Studio, ce qui vous permet de vérifier immédiatement que les événements sont envoyés.

Étapes suivantes