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 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 la préférence linguistique ou l'emplacement géographique.

Analytics enregistre automatiquement certains événements et propriétés utilisateur. Vous n'avez 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:

  • Si vous créez un projet Firebase, activez Google Analytics au cours du workflow de création du projet.

  • Si vous utilisez un projet Firebase existant pour lequel Google Analytics n'est pas activé, accédez à l'onglet Integrations (Intégrations) de  > Project settings (Paramètres du projet) pour l'activer.

Lorsque vous activez Google Analytics dans votre projet, vos applications Firebase sont associées aux 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 contrôle des versions de la bibliothèque. 

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

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

    Si vous choisissez de ne pas utiliser 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 BoM pour gérer les versions de la bibliothèque, 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.1.2")
}
    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 peuvent 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+KTX 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

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

    Kotlin+KTX 

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

    Java 

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

Démarrer la journalisation des événements

Une fois une instance FirebaseAnalytics créée, vous pouvez commencer à consigner des événements à l'aide de la méthode logEvent().

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 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 journalisation des événements, consultez la section Événements de journaux.

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

Kotlin+KTX 

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 afin de vérifier que les événements sont correctement consigné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 des événements sont envoyés.

Étapes suivantes