DebugView vous permet de consulter les données brutes des événements enregistrés par votre application sur les appareils de développement en temps quasi réel. Cette fonctionnalité est très utile à des fins de validation lors de la phase d'instrumentation du développement. Elle peut vous aider à détecter les erreurs et les problèmes dans votre Analytics implémentation, et à confirmer que tous les événements et toutes les propriétés utilisateur sont correctement enregistrés.
Activer le mode de débogage
En règle générale, les événements enregistrés par votre application sont regroupés par lots sur une période d'environ une heure, puis importés ensemble. Cette approche permet de préserver la batterie des appareils des utilisateurs finaux et de réduire l'utilisation des données réseau. Toutefois, pour les besoins de validation de votre implémentation Analytics (et pour afficher vos données Analytics dans le rapport DebugView), vous pouvez activer le mode de débogage sur votre appareil de développement afin d'importer les événements avec 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
Le mode de débogage est exécuté jusqu'à ce que vous le désactiviez directement en spécifiant l'argument de ligne de commande ci-dessous :
-FIRDebugDisabled
Vous pouvez ajouter ces arguments en modifiant le schéma de votre projet et en ajoutant une entrée à "Arguments Passed On Launch" (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
Le mode de débogage est exécuté jusqu'à ce que vous le désactiviez directement en exécutant la commande suivante :
adb shell setprop debug.firebase.analytics.app .none.
Web
Pour activer le mode débogage Analytics dans votre navigateur, installez l' extension Chrome Google Analytics Debugger.
Une fois l'extension installée, activez-la et actualisez la page. L'extension consigne alors les événements de votre application en mode débogage.
Vous pouvez consulter les événements consignés dans DebugView dans la Firebase console.
Rapport sur les données d'événement
Une fois le mode de débogage activé sur vos appareils de développement, accédez à DebugView en sélectionnant la flèche à côté de StreamView dans le panneau de navigation supérieur de Google Analytics et en sélectionnant DebugView.
Google Analytics et en sélectionnant DebugView">
Commencez ensuite à utiliser votre application pour que les événements soient enregistrés dans le rapport DebugView.
Le flux en secondes (colonne du milieu) indique les événements qui ont été enregistrés dans les 60 dernières secondes. Le flux en minutes (colonne de gauche) affiche une série d'événements qui ont été archivés au cours des 30 dernières minutes. La colonne de droite regroupe les principaux événements qui ont été enregistrés pendant la période de 30 minutes, ainsi que les propriétés utilisateur actuelles pour l'appareil de développement sélectionné.
Flux en secondes
Par défaut, la liste des événements enregistrés au cours des 60 dernières secondes s'affiche. L'horodatage indiqué pour chaque événement correspond au moment de l'enregistrement sur l'appareil de développement. Vous pouvez cliquer sur un événement pour afficher la liste des paramètres qui lui sont associés.
À mesure que les valeurs des propriétés utilisateur changent au cours de l'utilisation de l'application, une entrée s'affiche pour indiquer cette modification.
Flux en minutes
Ce flux affiche une série de cercles pour les 30 dernières minutes. Chaque cercle correspond à une minute. Le nombre indiqué dans le cercle correspond au nombre d'événements reçus au cours de cette minute. Si vous cliquez sur l'un des cercles, les événements consignés pendant la minute correspondante s'affichent dans le flux en secondes. Ainsi, vous êtes en mesure d'examiner les événements enregistrés au cours des 30 dernières minutes de façon très détaillée.
Principaux événements et propriétés utilisateur actuelles
Le tableau Principaux événements montre les événements les plus importants consignés pendant la période de 30 minutes. Le tableau Propriétés utilisateur actuelles affiche l'état le plus récent associé à l'ensemble de propriétés utilisateur pour l'appareil de développement actuellement sélectionné.
Sélecteur d'appareils
Il existe de nombreux appareils de développement sur lesquels le mode de débogage peut être activé. Afin de choisir l'appareil spécifique sur lequel axer le rapport DebugView, vous pouvez utiliser le sélecteur d'appareil. Ainsi, si plusieurs développeurs travaillent simultanément, chacun peut se concentrer sur ses propres tâches d'instrumentation et de validation sans être gêné par les autres.
