Google 致力于为黑人社区推动种族平等。查看具体举措
此页面由 Cloud Translation API 翻译。
Switch to English

Journaliser les événements

Ce guide vous montre comment enregistrer des événements dans votre application.

Les événements fournissent des informations sur ce qui se passe dans votre application, comme les actions des utilisateurs, les événements système ou les erreurs.

Analytics enregistre automatiquement certains événements pour vous; vous n'avez pas besoin d'ajouter de code pour les recevoir. Si votre application a besoin de collecter des données supplémentaires, vous pouvez enregistrer jusqu'à 500 types d' événements Analytics différents dans votre application. Il n'y a pas de limite au volume total d'événements que votre application enregistre. Notez que les noms d'événements sont sensibles à la casse et que la journalisation de deux événements dont les noms ne diffèrent que par la casse entraînera deux événements distincts.

Avant que tu commences

Assurez-vous que vous avez configuré votre projet et que vous pouvez accéder à Analytics comme décrit dans Premiers pas avec Analytics .

Journaliser les événements

Après avoir créé une instance FirebaseAnalytics , vous pouvez l'utiliser pour consigner des événements avec la méthode logEvent() .

Pour vous aider à démarrer, le SDK Analytics définit un certain nombre d'événements suggérés qui sont communs à différents types d'applications, y compris les applications de vente au détail et de commerce électronique, de voyage et de jeu. Pour en savoir plus sur ces événements et savoir quand les utiliser, parcourez les articles sur les événements et les propriétés dans le centre d'aide Firebase.

Vous pouvez trouver des détails d'implémentation pour les types d'événement suggérés aux emplacements suivants:

L'exemple suivant montre comment consigner un événement SELECT_CONTENT :

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

En plus des paramètres prescrits, vous pouvez ajouter les paramètres suivants à tout événement:

  • Paramètres personnalisés: des paramètres personnalisés peuvent être enregistrés pour la création de rapports dans vos rapports Analytics. Ils peuvent également être utilisés comme filtres dans les définitions d' audience qui peuvent être appliqués à chaque rapport. Les paramètres personnalisés sont également inclus dans les données exportées vers BigQuery si votre application est liée à un projet BigQuery.

  • Paramètre VALUE : VALUE est un paramètre à usage général qui est utile pour accumuler une métrique clé qui se rapporte à un événement. Les exemples incluent les revenus, la distance, le temps et les points.

Si votre application a des besoins spécifiques non couverts par un type d'événement suggéré, vous pouvez enregistrer vos propres événements personnalisés comme indiqué dans cet exemple:

Java

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Kotlin + KTX

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}

Définir les paramètres d'événement par défaut

Vous pouvez consigner les paramètres entre les événements à l'aide de setDefaultEventParameters . Les paramètres par défaut sont associés à tous les événements futurs enregistrés.

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

Kotlin + KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Si un paramètre est spécifié dans la méthode logEvent() , cette valeur est utilisée à la place de la valeur par défaut.

Pour effacer un paramètre par défaut, appelez la méthode setDefaultEventParameters avec le paramètre défini sur null .

Afficher les événements dans le journal de débogage d'Android Studio

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.

Afficher les événements dans le tableau de bord

Vous pouvez afficher des statistiques agrégées sur vos événements dans les tableaux de bord de la console Firebase. Ces tableaux de bord sont mis à jour périodiquement tout au long de la journée. Pour un test immédiat, utilisez la sortie logcat comme décrit dans la section précédente.

Vous pouvez accéder à ces données à partir du tableau de bord Événements de la console Firebase. Ce tableau de bord affiche les rapports d'événements qui sont automatiquement créés pour chaque type distinct d'événement enregistré par votre application.