Événements de journaux


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

Les événements fournissent des insights 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 à votre place. 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. 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

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

Événements de journaux

Une fois l'instance firebase.analytics() configurée, vous pouvez commencer à consigner des événements à l'aide de la méthode logEvent(). Si vous connaissez déjà Google Analytics, cette méthode équivaut à utiliser la commande event dans gtag.js.

Pour vous aider à vous lancer, 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 à quel moment les utiliser, consultez la section Événements recommandés.

Remarque : Pour obtenir le maximum de détails dans les rapports, enregistrez les événements recommandés qui ont du sens pour votre application et leurs paramètres prescrits. Vous bénéficiez ainsi des dernières fonctionnalités Google Analytics dès qu'elles sont disponibles.

Pour en savoir plus sur l'implémentation de plusieurs événements et de leurs paramètres, consultez la documentation de référence sur les événements gtag.js.

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

Web

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453'
});

Web

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

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 peuvent être utilisés en tant que dimensions ou métriques dans les rapports Analytics. Vous pouvez utiliser des dimensions personnalisées pour les données de paramètre d'événement non numériques et des métriques personnalisées pour toutes les données de paramètre mieux représentées numériquement. Une fois que vous avez 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 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 associée à un projet BigQuery. Vous trouverez des exemples de requêtes et bien plus encore dans BigQuery Export de Google Analytics 4.

  • Paramètre value: value est un paramètre à usage général qui permet d'accumuler une métrique clé concernant un événement. Exemples : revenus, distance, durée et points.

Si votre application présente des besoins spécifiques non couverts par un type d'événement recommandé, vous pouvez enregistrer vos propres événements personnalisés. Par exemple, si vous développez un jeu et que vous souhaitez suivre quand un joueur atteint un objectif particulier, vous pouvez consigner un événement semblable à l'exemple suivant :

Web

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});

Web

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

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 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 sur les événements qui sont automatiquement créés pour chaque type d'événement distinct enregistré par votre application.