Cette page a été traduite par l'API Cloud Translation.
Switch to English

Commencez 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: ce qui se passe dans votre application, comme les actions des utilisateurs, 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, tels que la préférence de langue ou l'emplacement géographique.

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

Avant que tu commences

Si vous ne l'avez pas déjà fait, 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 processus de création de projet.

  • Si vous disposez d'un projet Firebase existant pour lequel Google Analytics n'est pas activé, vous pouvez activer Google Analytics à partir de l'onglet Intégrations de vos > Paramètres du projet .

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

Ajoutez le SDK Analytics à votre application

  1. Ajoutez la dépendance de la bibliothèque Google Analytics Android à votre fichier Gradle de module (au niveau de l'application) (généralement app/build.gradle ):

    Java

    implementation 'com.google.firebase:firebase-analytics:17.5.0'
    

    Kotlin + KTX

    implementation 'com.google.firebase:firebase-analytics-ktx:17.5.0'
    
  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

Commencer la journalisation des événements

Après avoir créé une instance FirebaseAnalytics , vous pouvez commencer à consigner les événements avec la méthode logEvent() .

Certains événements sont recommandés pour toutes les applications ; d'autres sont recommandés pour des types d'entreprises ou des secteurs verticaux spécifiques. Vous devez envoyer des suggestions d'événements avec leurs paramètres prescrits, pour garantir un maximum de détails disponibles dans vos rapports et pour bénéficier des futures fonctionnalités et intégrations dès qu'elles seront disponibles. Cette section montre la journalisation d'un événement prédéfini, pour plus d'informations sur la journalisation des événements, voir Journaliser les événements .

Le code suivant enregistre un événement SELECT_CONTENT lorsqu'un utilisateur clique sur un élément spécifique de 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 journalisés. Cela comprend les événements enregistrés automatiquement et manuellement.

Vous pouvez activer la journalisation détaillée avec 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 d'Android Studio, vous aidant à vérifier immédiatement que les événements sont envoyés.

Prochaines étapes