Google 致力于为黑人社区推动种族平等。查看具体举措

Premiers pas avec Google Analytics

Ce guide de démarrage rapide vous montre comment ajouter Google Analytics à votre application et commencer à enregistrer les é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: Qu'est - ce qui se passe dans votre application, telles que les actions de l' utilisateur, les événements du système ou des erreurs.
  • Propriétés de l' utilisateur: vous Attributs définissent pour décrire les segments de votre base d'utilisateurs, tels que les préférences linguistiques ou la situation géographique.

Analytics enregistre automatiquement certains événements et propriétés de l' utilisateur ; vous n'avez pas besoin d'ajouter de code pour les activer.

Avant que tu commences

Si vous avez pas déjà, ajoutez Firebase à votre projet Android et assurez - vous que Google Analytics est activé dans votre projet Firebase:

  • Si vous créez un nouveau projet Firebase, activez Google Analytics pendant le workflow de création de projet.

  • Si vous utilisez un projet existant qui ne Firebase pas Google Analytics activé, accédez à l' Intégrations onglet de vos > Paramètres du projet pour l' activer.

Lorsque vous activez Google Analytics dans votre projet, vos applications Firebase sont liées aux flux de données Google Analytics.

Ajouter le SDK Analytics à votre application

  1. Utilisation de la Firebase Android BoM , déclarer la dépendance de la bibliothèque Android Analytics dans votre module (app-niveau) de fichier Gradle (généralement app/build.gradle ).

    Java

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

    (Alternative) déclarer des dépendances de bibliothèque firebase sans utiliser la nomenclature

    Si vous choisissez de ne pas utiliser la nomenclature de 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 fortement d' utiliser la BoM pour gérer les versions bibliothèque, ce qui garantit que toutes les versions sont compatibles.

    dependencies {
        // Declare 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:19.0.1'
    }
    

    Kotlin+KTX

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

    (Alternative) déclarer des dépendances de bibliothèque firebase sans utiliser la nomenclature

    Si vous choisissez de ne pas utiliser la nomenclature de 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 fortement d' utiliser la BoM pour gérer les versions bibliothèque, ce qui garantit que toutes les versions sont compatibles.

    dependencies {
        // Declare 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:19.0.1'
    }
    

  2. Déclarer le com.google.firebase.analytics.FirebaseAnalytics objet en haut de votre activité:

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin+KTX

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

    Java

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

    Kotlin+KTX

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

Démarrer la journalisation des événements

Une fois que vous avez créé un FirebaseAnalytics exemple, vous pouvez commencer à enregistrer des événements avec le logEvent() méthode.

Certains événements sont recommandés pour toutes les applications ; d'autres sont recommandés pour des types d'entreprise ou des secteurs verticaux spécifiques. Vous devez envoyer des suggestions d'événements avec leurs paramètres prescrits, afin d'assurer un maximum de détails disponibles dans vos rapports et de bénéficier des futures fonctionnalités et intégrations dès qu'elles seront disponibles. Cette section explique la connexion d' un événement défini avant, pour plus d' informations sur l'enregistrement des événements, voir les événements du journal .

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

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);

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")
}

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 enregistrés. Cela inclut à la fois les événements enregistrés automatiquement et manuellement.

Vous pouvez activer la journalisation détaillée avec une série de adb commandes:

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, vous aidant à vérifier immédiatement que les événements sont envoyés.

Prochaines étapes