Événements de journaux


Ce guide vous explique comment consigner des événements dans votre application.

Les événements vous renseignent sur ce qui se passe dans votre application (actions des utilisateurs, événements système ou erreurs, par exemple).

Analytics enregistre automatiquement certains événements pour vous. Vous n'avez pas besoin d'ajouter de code pour les recevoir. Si votre application doit collecter des données supplémentaires, vous pouvez enregistrer jusqu'à 500 types d'Analytics événements dans votre application. Le volume total d'événements enregistrés par votre application n'est pas limité. Notez que les noms des événements sont sensibles à la casse. Si vous enregistrez deux événements dont les noms ne diffèrent que par la casse, deux événements distincts sont créés.

Avant de commencer

Assurez-vous d'avoir configuré votre projet et d'avoir accès à Analytics, comme décrit dans Premiers pas avec Analytics.

Événements de journaux

Une fois que vous avez 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 recommandés qui sont courants dans différents types d'applications, y compris les applications de vente au détail et d'e-commerce, de voyage et de jeux. Pour en savoir plus sur ces événements et sur le moment où les utiliser, consultez Événements recommandés.

Vous trouverez des informations sur l'implémentation des types d'événements recommandés aux emplacements suivants :

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

Kotlin 

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

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);
MainActivity.java

En plus des paramètres prescrits, vous pouvez ajouter les paramètres suivants à n'importe quel événement :

  • Paramètres personnalisés : ils peuvent être utilisés comme dimensions ou métriques dans les rapports Analytics. Vous pouvez utiliser des dimensions personnalisées pour les données de paramètres d'événement non numériques et des métriques personnalisées pour les données de paramètres mieux représentées sous forme numérique. Après avoir enregistré un paramètre personnalisé à l'aide du SDK, enregistrez la dimension ou la métrique pour vous assurer que ces paramètres personnalisés apparaissent dans les rapports Analytics. Pour ce faire, accédez à Analytics > Événements > Gérer les définitions personnalisées > Créer des dimensions personnalisées.

    Les paramètres personnalisés peuvent être utilisés dans les définitions d'audience applicables à chaque rapport. Les paramètres personnalisés sont également inclus dans les données exportées vers BigQuery si votre application est associée à un projet BigQuery. Retrouvez des exemples de requêtes et bien plus encore sur BigQuery Export pour Google Analytics 4.

  • Paramètre VALUE : VALUE est un paramètre à usage général qui permet d'accumuler une métrique clé liée à un événement. Par exemple, les revenus, la distance, le temps et les points.

Si votre application a des besoins spécifiques qui ne sont pas couverts par un type d'événement recommandé, vous pouvez enregistrer vos propres événements personnalisés en suivant l'exemple ci-dessous :

Kotlin 

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

Java 

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

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

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

Comme pour les paramètres personnalisés, enregistrez les paramètres d'événement par défaut pour vous assurer qu'ils apparaissent dans les rapports Analytics.

Kotlin 

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Java 

Bundle parameters = new Bundle();
parameters.putString("level_name", "Caverns01");
parameters.putInt("level_difficulty", 4);
mFirebaseAnalytics.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 Android Studio

Vous pouvez activer la journalisation détaillée pour surveiller la journalisation des événements par le SDK et vérifier que les événements sont correctement enregistrés. Cela inclut les événements enregistrés automatiquement et manuellement.

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

Afficher les événements dans le tableau de bord

Vous pouvez consulter 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 régulièrement tout au long de la journée. Pour effectuer des tests immédiats, utilisez la sortie logcat comme décrit dans la section précédente.

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