Ce guide vous montre comment enregistrer des événements dans votre application.
Les événements fournissent un aperçu de ce qui se passe dans votre application, tels que les actions 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 a besoin de 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 sur le volume total d’événements que votre application enregistre.,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 dans la casse entraînera deux événements distincts.
avant de commencer
assurez-vous que vous avez configuré votre projet et que vous pouvez accéder à Analytics comme décrit dans le cadre d’Analytics.
Journal des événements
Après avoir configuré lefirebase.analytics()
exemple,vous pouvez commencer à enregistrer des événements avec la baliselogEvent()
méthode. Si vous connaissez déjà Google Analytics, cette méthode est équivalente à l’utilisation de la commande event
ingtag.js.,
pour vous aider à démarrer, le SDK Analytics définit un certain nombre d’événements suggéré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 quand les utiliser,parcourez theEvents et propertiesarticles dans le centre D’aide Firebase.
Remarque: pour obtenir le maximum de détails dans les rapports, enregistrez les événements suggéré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 à mesure qu’elles deviennent disponibles.,
Vous pouvez trouver les détails d’implémentation pour plusieurs événements et leurs paramètres inthegtag.référence d’événement js.
l’exemple suivant montre comment enregistrer un événement select_content
:
analytics.logEvent('select_content', { content_type: 'image', content_id: 'P12453', items: });
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 enregistrés pour les rapports dans vos rapports Analytics. Ils peuvent également être utilisés comme filtresdans audiencedéfinitions qui peuvent être appliquées à chaque rapport., Les paramètres personnalisés sont également inclus dans dataexported to Bigquerysi votre application est liée à un projet BigQuery.
-
value
paramètre:value
est un objet général paramètre est utile pour accumuler un paramètre 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 suggéré,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 similaire à l’exemple suivant:
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 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.
Vous pouvez accéder à ces données à partir de theEventsdashboard dans la console Firebase., Ce tableau de bord affiche les rapports d’événements créés automatiquement pour chaque type d’événement enregistré par votre application.