Événements de débogage

DebugView vous permet de voir les données d'événements brutes enregistrées par votre application sur les appareils de développement en temps quasi réel. Ceci est très utile à des fins de validation pendant la phase d'instrumentation du développement et peut vous aider à découvrir les erreurs et les fautes dans votre implémentation Analytics et à confirmer que tous les événements et propriétés utilisateur sont correctement enregistrés.

Activer le mode débogage

Généralement, les événements enregistrés par votre application sont regroupés sur une période d'environ une heure et téléchargés ensemble. Cette approche préserve la batterie des appareils des utilisateurs finaux et réduit l'utilisation des données du réseau. Cependant, dans le but de valider votre implémentation Analytics (et afin d'afficher vos Analytics dans le rapport DebugView), vous pouvez activer le mode débogage sur votre appareil de développement pour télécharger des événements dans un délai minimal.

iOS+

Pour activer le mode débogage Analytics sur votre appareil de développement, spécifiez l'argument de ligne de commande suivant dans Xcode :

-FIRDebugEnabled

Ce comportement persiste jusqu'à ce que vous désactiviez explicitement le mode débogage en spécifiant l'argument de ligne de commande suivant :

-FIRDebugDisabled

Vous pouvez ajouter ces arguments en modifiant le schéma de votre projet et en ajoutant une nouvelle entrée à « Arguments transmis au lancement ».

Android

Pour activer le mode débogage Analytics sur un appareil Android, exécutez les commandes suivantes :

adb shell setprop debug.firebase.analytics.app PACKAGE_NAME

Ce comportement persiste jusqu'à ce que vous désactiviez explicitement le mode débogage en exécutant la commande suivante :

adb shell setprop debug.firebase.analytics.app .none.

la toile

Pour activer le mode de débogage Analytics dans votre navigateur, installez l'extension Chrome Google Analytics Debugger .

Une fois installé, activez l'extension et actualisez la page. À partir de ce moment, l'extension enregistrera les événements dans votre application en mode débogage.

Vous pouvez afficher les événements enregistrés dans DebugView dans la console Firebase.

Rapport sur les données d'événement

Une fois que vous avez activé le mode débogage sur vos appareils de développement, accédez à DebugView en sélectionnant la flèche à côté de StreamView dans la navigation supérieure de Google Analytics et en sélectionnant DebugView.

Accédez à DebugView en sélectionnant la flèche à côté de StreamView dans la navigation supérieure de Google Analytics et en sélectionnant DebugView.

Ensuite, commencez simplement à utiliser votre application pour voir les événements de votre application enregistrés dans le rapport DebugView.

Le rapport DebugView.

Le flux Secondes (la colonne du milieu) affiche les événements qui ont été enregistrés au cours des 60 dernières secondes. Le flux Minutes (colonne de gauche) affiche une série d'archives d'événements au cours des 30 dernières minutes. Et la colonne de droite affiche les principaux événements enregistrés au cours de la période de 30 minutes ainsi que les propriétés de l'utilisateur actuel pour le périphérique de développement actuellement sélectionné.

Flux de secondes

Par défaut, vous verrez une liste des événements enregistrés au cours des 60 dernières secondes. Chaque événement affiche un horodatage qui correspond à l'heure de sa journalisation sur le périphérique de développement. Vous pouvez cliquer sur un événement pour voir une liste des paramètres associés à cet événement.

Un exemple de liste de paramètres d'événement.

À mesure que les valeurs des propriétés utilisateur changent au cours de l'utilisation de l'application, vous verrez une entrée pour ce changement.

Un exemple de propriété utilisateur.

Flux de minutes

Ce flux montre une série de cercles qui correspondent chacun à une minute de temps au cours des 30 dernières minutes. Le nombre dans le cercle indique le nombre d'événements reçus au cours de cette minute. En cliquant sur l'un de ces cercles, le flux Secondes sera rempli avec les événements enregistrés pendant cette minute. Cela vous permet effectivement d’examiner les événements enregistrés au cours des 30 dernières minutes avec une grande précision.

Un exemple du flux de minutes.

Principaux événements et propriétés de l'utilisateur actuel

Le tableau Principaux événements affiche les principaux événements enregistrés au cours de la période de 30 minutes. Et le tableau Propriétés utilisateur actuelles affiche le dernier état de l'ensemble des propriétés utilisateur pour le périphérique de développement actuellement sélectionné.

Un exemple de tableau des principaux événements.

Sélecteur d'appareil

Étant donné que le mode débogage peut être activé sur de nombreux appareils de développement différents, vous pouvez utiliser le sélecteur de périphérique pour choisir le périphérique spécifique sur lequel le rapport DebugView se concentrera. Cela permet à plusieurs développeurs de se concentrer sur leurs propres efforts d’instrumentation et de validation sans s’impacter mutuellement.

Un exemple de sélecteur de périphérique.