Premiers pas avec Google Analytics pour Android

Sélectionnez la 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 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

Si ce n'est pas déjà 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 vos > 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 Analytics SDK à 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 la Firebase Android BoM pour contrôler la gestion des versions de la bibliothèque. 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.11.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 les Firebase Android BoM, votre application utilisera toujours des versions compatibles des bibliothèques Firebase Android.

    (Autre solution)  Ajouter des dépendances de bibliothèque Firebase sans utiliser la BoM

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

    Notez que si vous utilisez plusieurs bibliothèques Firebase dans votre application, nous vous recommandons vivement d'utiliser la 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:23.2.0")
}

  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 ; d'autres le sont pour des types d'entreprises ou des secteurs spécifiques. Vous devez envoyer les événements suggérés avec leurs paramètres prescrits pour disposer de rapports aussi détaillés que possible, 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 SELECT_CONTENT événement 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 l'enregistrement des événements par le SDK et vous assurer qu'ils 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 qu'ils sont envoyés.

Étapes suivantes