É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. Vous n'avez pas besoin d'ajouter de code pour les recevoir. Si votre application doit collecter des données supplémentaires, vous pouvez consigner jusqu'à 500 types d'événements Analytics différents 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. Enregistrer deux événements dont les noms ne diffèrent que par la casse entraîne l'enregistrement de deux événements distincts.

Avant de commencer

Avant de pouvoir utiliser Google Analytics, vous devez:

• Enregistrez votre projet Unity et configurez-le pour utiliser Firebase.

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

  • Si vous ne disposez pas d'un projet Unity, vous pouvez télécharger un exemple d'application.

• Ajoutez le SDK Unity Firebase (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 console Firebase et dans votre projet Unity ouvert (par exemple, vous téléchargez des fichiers de configuration Firebase à partir de la console, puis les déplacez dans votre projet Unity).

Événements de journaux

Une fois le module Firebase.Analytics.FirebaseAnalytics initialisé, vous pouvez l'utiliser pour consigner des événements à l'aide de la méthode LogEvent().

Pour vous aider à démarrer, le SDK Analytics définit un certain nombre d'événements recommandés qui sont communs à différents types d'applications, y compris les applications de commerce et d'e-commerce, de voyage et de jeux. Pour en savoir plus sur ces événements et savoir quand les utiliser, consultez les articles Événements recommandés dans le centre d'aide Google Analytics.

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

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

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

    // 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 rapports Analytics, 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 permet d'accumuler une métrique clé concernant un événement Analytics. Exemples : revenus, distance, temps et points.

Si votre application présente des besoins spécifiques non couverts par un type d'événement Analytics suggéré, vous pouvez enregistrer vos propres événements Analytics personnalisés, comme illustré dans l'exemple suivant:

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 d'analyse dans le tableau de bord

Vous pouvez consulter 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 un test immédiat, utilisez la sortie logcat comme décrit dans la section précédente.

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

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

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