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.
Ensuite, commencez simplement à utiliser votre application pour voir les événements de votre application enregistrés dans 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.
À 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.
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.
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é.
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.