Utilisez Google Analytics pour obtenir des statistiques pour les rapports d'erreur

Google Analytics est le moteur d'analyse de Firebase. Lorsque vous utilisez Analytics et Crashlytics ensemble dans votre application, vous obtenez des fonctionnalités qui vous aident à générer des problèmes et à suivre les données de plantage avec plus de granularité, telles que des utilisateurs sans plantage, des fils d'Ariane qui suivent des événements spécifiques avant un plantage et BigQuery, où vous pouvez visualiser les indicateurs clés de votre application.

Ce guide décrit comment ajouter Analytics à une application sur laquelle Crashlytics est configuré (si vous ne l'avez pas déjà fait, ajoutez Crashlytics à votre application ).

Étape 1 : Ajouter un fichier de configuration Firebase

  1. Ajoutez le fichier de configuration Firebase Android à votre application :

    1. Ouvrez vos paramètres de projet. Dans la carte Vos applications , sélectionnez le nom du package de l'application pour laquelle vous avez besoin d'un fichier de configuration.

    2. Cliquez sur Télécharger google-services.json pour obtenir votre fichier de configuration Firebase Android ( google-services.json ).

      • Vous pouvez télécharger à nouveau votre fichier de configuration Firebase Android à tout moment.
      • Assurez-vous que le fichier de configuration n'est pas ajouté avec des caractères supplémentaires, comme (2) .

    3. Déplacez votre fichier de configuration dans le répertoire du module (au niveau de l'application) de votre application.

  2. Pour activer les produits Firebase dans votre application, ajoutez le plug-in google-services à vos fichiers Gradle.

    1. Dans votre fichier Gradle au niveau de la racine (au niveau du projet) ( <project>/build.gradle.kts ou <project>/build.gradle ), ajoutez des règles pour inclure le plug-in Gradle des services Google. Vérifiez que vous disposez également du référentiel Maven de Google.

      Kotlin

      plugins {
   id("com.android.application") version "7.2.0" apply false
   // ...

   // Add the dependency for the Google services Gradle plugin
   id("com.google.gms.google-services") version "4.3.15" apply false
}

      Groovy

      plugins {
   id 'com.android.application' version '7.2.0' apply false
   // ...

   // Add the dependency for the Google services Gradle plugin
   id 'com.google.gms.google-services' version '4.3.15' apply false
}

    2. 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 ), appliquez le plug-in Gradle des services Google.

      Kotlin

      plugins {
   id("com.android.application")

   // Add the Google services Gradle plugin
   id("com.google.gms.google-services")
   // ...
}

      Groovy

      plugins {
   id 'com.android.application'

   // Add the Google services Gradle plugin
   id 'com.google.gms.google-services'
   // ...
}

Étape 2 : Ajoutez 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 Analytics Android bibliothèque. Nous vous recommandons d'utiliser Firebase Android BoM pour contrôler la gestion des versions de la bibliothèque.

    Kotlin+KTX

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

    // 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-ktx'
}

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

    (Alternative) Ajouter des dépendances à la bibliothèque Firebase sans utiliser le BoM

    Si vous choisissez de ne pas utiliser la nomenclature Firebase, 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 de 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-ktx:21.3.0'
}

    Java

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

    // 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) Ajouter des dépendances à la bibliothèque Firebase sans utiliser le BoM

    Si vous choisissez de ne pas utiliser la nomenclature Firebase, 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 de 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:21.3.0'
}

  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

Prochaines étapes