Ce guide vous montre comment enregistrer des événements dans votre application.
Les événements fournissent des informations sur ce qui se passe dans votre application, comme les actions de l'utilisateur, les événements système ou les erreurs.
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 pas de limite au 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 ne diffèrent que par la casse entraînera deux événements distincts.
Avant que tu commences
Assurez-vous que vous avez configuré votre projet et que vous pouvez accéder à Analytics comme décrit dans Premiers pas avec Analytics .
Journaliser les événements
Après avoir configuré l'instance firebase.analytics() , vous pouvez commencer à consigner les é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 à 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 vente au détail et de commerce électronique, de voyage et de jeu. Pour en savoir plus sur ces événements et savoir quand les utiliser, voir Événements recommandés .
Remarque : Pour obtenir le maximum de détails dans les rapports, enregistrez les événements recommandés qui ont un sens 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 des détails sur la mise en œuvre de plusieurs événements et leurs paramètres dans la référence d'événement gtag.js .
L'exemple suivant montre comment consigner un événement select_content :
Web version 9
import { getAnalytics, logEvent } from "firebase/analytics";
const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
content_type: 'image',
content_id: 'P12453'
});Web version 8
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 comme dimensions ou statistiques 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 statistique 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 qui peuvent ê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. Trouvez des exemples de requêtes et bien plus encore sur Google Analytics 4 BigQuery Export .
Paramètre
value:valueest un paramètre à usage général qui est utile pour accumuler une métrique clé qui se rapporte à un événement. 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 recommandé, vous pouvez consigner vos propres événements personnalisés. Par exemple, si vous développez un jeu et souhaitez savoir quand un joueur atteint un objectif particulier, vous pouvez enregistrer un événement similaire à l'exemple suivant :
Web version 9
import { getAnalytics, logEvent } from "firebase/analytics";
const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});Web version 8
analytics.logEvent('goal_completion', { name: 'lever_puzzle'});Afficher les événements dans le tableau de bord
Vous pouvez afficher 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 périodiquement 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 des événements dans la console Firebase. Ce tableau de bord affiche les rapports d'événements créés automatiquement pour chaque type distinct d'événement enregistré par votre application.