Événements de journaux

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

Google Analytics enregistre automatiquement certains événements pour vous. Il n'y a donc pas de code à ajouter pour les recevoir. Si votre application doit collecter des données supplémentaires, vous pouvez y enregistrer jusqu'à 500 types d'événements Analytics différents. 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. Ainsi, si deux événements portent le même nom, mais avec une casse différente, deux événements distincts sont créés.

Avant de commencer

Avant de pouvoir utiliser Google Analytics, vous devez :

• enregistrer votre projet Unity et le configurer pour utiliser Firebase.

  • Si votre projet Unity utilise déjà Firebase, il est déjà enregistré et configuré pour Firebase.

  • Si vous n'avez pas de projet Unity, vous pouvez télécharger un exemple d'application.

• ajouter le Firebase Unity SDK (plus précisément, FirebaseAnalytics.unitypackage) à votre projet Unity.

Notez que l'ajout de Firebase à votre projet Unity implique des tâches à la fois dans la Firebase console et dans votre projet Unity ouvert (par exemple, vous téléchargez des fichiers de configuration Firebase depuis la console, puis vous les déplacez dans votre projet Unity).

Événements de journaux

Une fois que vous avez initialisé le Firebase.Analytics.FirebaseAnalytics module, vous pouvez l'utiliser pour enregistrer des événements avec la LogEvent() méthode.

Pour vous aider à démarrer, le Analytics SDK 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 les articles sur les événements recommandés dans le centre d'aide Google Analytics.

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

• Événements suggérés : consultez la liste des Event constantes.
• Paramètres prescrits : consultez la liste des Parameters constantes.

L'exemple suivant montre comment enregistrer un événement suggéré SELECT_CONTENT :

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

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

• Paramètres personnalisés : les paramètres personnalisés ne sont pas représentés directement dans vos Analytics rapports, mais ils peuvent être utilisés comme filtres 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.

• Paramètre VALUE : VALUE est un paramètre à usage général qui est utile pour cumuler une métrique clé liée à un Analytics é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 suggéré Analytics, vous pouvez enregistrer vos propres événements personnalisés Analytics comme indiqué dans cet exemple :

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

Afficher les événements dans la sortie du journal

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

Afficher les événements Analytics dans le tableau de bord

Vous pouvez afficher des statistiques agrégées sur vos événements Analytics 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.

Pour accéder à ces données dans la Firebase console :

1. Dans la Firebase console, ouvrez votre projet.
2. Sélectionnez Analytics dans le menu pour afficher le tableau de bord de création de rapports Analytics.

L'onglet Événements affiche les rapports d'événements créés automatiquement pour chaque type distinct d'événement Analytics enregistré par votre application. En savoir plus sur le tableau de bord.