Journaliser les événements

Les événements fournissent un aperçu de ce qui se passe dans votre application, comme les actions des utilisateurs, les événements système ou les erreurs.

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 enregistrer jusqu'à 500 types d'événements Analytics différents dans votre application. Il n'y a aucune limite sur le volume total d'événements enregistrés par votre application. Notez que les noms d'événements sont sensibles à la casse et que la journalisation de deux événements dont les noms diffèrent uniquement par la casse entraîne deux événements distincts.

Avant que tu commences

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 n'avez pas de projet Unity, vous pouvez télécharger un exemple d'application .

• Ajoutez le SDK Firebase Unity (en particulier, FirebaseAnalytics.unitypackage ) à votre projet Unity.

Trouvez des instructions détaillées pour ces tâches de configuration initiale dans Ajouter Firebase à 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 les fichiers de configuration Firebase depuis la console, puis vous les déplacez dans votre projet Unity).

Journaliser les événements

Après avoir initialisé le module Firebase.Analytics.FirebaseAnalytics , vous pouvez l'utiliser pour enregistrer 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 communs à différents types d'applications, notamment les applications de vente au détail et de commerce électronique, de voyage et de jeux. Pour en savoir plus sur ces événements et savoir quand les utiliser, consultez les articles sur les événements recommandés dans le centre d'aide Google Analytics.

Remarque : Pour obtenir le maximum de détails dans les rapports, enregistrez les événements Analytics suggérés qui sont pertinents pour votre application et leurs paramètres prescrits. Cela garantit également que vous bénéficiez des dernières fonctionnalités de Google Analytics dès qu'elles sont disponibles.

Vous pouvez trouver les détails de mise en œuvre des événements recommandés aux emplacements suivants :

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

L'exemple suivant montre comment enregistrer 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 pouvant être appliquées à 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é relative à un événement Analytics. 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 Analytics suggéré, vous pouvez enregistrer vos propres événements Analytics personnalisés, comme indiqué dans cet exemple :

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

Afficher les événements dans la sortie du journal

Android

Vous pouvez activer la journalisation détaillée dans le journal de débogage d'Android Studio, pour vérifier que les événements sont correctement enregistrés par le SDK. Cela inclut 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 ainsi à vérifier immédiatement que les événements sont envoyés.

iOS+

Les événements sont enregistrés sur la console et peuvent être consultés lors de l'exécution de l'application via XCode.

Afficher les événements d'analyse 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 périodiquement tout au long de la journée. Pour 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 console Firebase :

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

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