欢迎参加我们将于 2022 年 10 月 18 日举办的 Firebase 峰会(线上线下同时进行),了解 Firebase 如何帮助您加快应用开发速度、满怀信心地发布应用并在之后需要时轻松地扩大应用规模。立即报名

Utilisez Google Analytics pour obtenir des métriques pour les rapports de plantage

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 de niveau racine (niveau projet) ( build.gradle ), ajoutez des règles pour inclure le plug-in Google Services Gradle. Vérifiez que vous disposez également du référentiel Maven de Google.

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.14'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. Dans le fichier Gradle de votre module (au niveau de l'application) (généralement app/build.gradle ), appliquez le plug-in Google Services Gradle.

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

É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 ), ajoutez la dépendance pour la bibliothèque Analytics Android. Nous vous recommandons d'utiliser Firebase Android BoM pour contrôler la gestion des versions de la bibliothèque.

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:30.5.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) 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 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:21.1.1'
    }
    

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:30.5.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-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 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-ktx:21.1.1'
    }
    

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

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. Initialisez-le dans la méthode onCreate() :

    Java

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

    Kotlin+KTX

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

Prochaines étapes