Événements de journaux

Sélectionnez une plate-forme : iOS+ Android Web Flutter Unity C++


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 Analytics types d'événements dans votre application (2 000 si vous utilisez Google Analytics 360). Le volume total d'événements enregistrés par votre application n'est pas limité. Notez que les noms d'é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 de pouvoir accéder à Analytics comme décrit dans Premiers pas avec Analytics.

Événements de journaux

Une fois l'instance firebase.analytics() configurée, vous pouvez commencer à consigner des événements avec 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 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 de plusieurs événements et de leurs paramètres dans 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 : 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. 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, dans la console Firebase, accédez à Analytics > Définitions personnalisées.

    Vous pouvez utiliser des paramètres personnalisés dans les définitions d'audience qui peuvent être appliquées à tous les rapports. 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, la durée 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. Par exemple, si vous développez un jeu et que vous souhaitez suivre le moment où un joueur atteint un objectif particulier, vous pouvez enregistrer 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

Dans la console Firebase, vous pouvez afficher des statistiques agrégées sur vos événements dans le tableau de bord Analytics > Événements.

Notez les points suivants concernant ce tableau de bord :

  • Le 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.

  • Le tableau de bord est actualisé régulièrement tout au long de la journée. Pour effectuer des tests immédiats, utilisez DebugView.