Catch up on highlights from Firebase at Google I/O 2023. Learn more

Événements de débogage

DebugView vous permet de voir les données d'événement 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 erreurs 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. Toutefois, aux fins de validation de votre implémentation Analytics (et pour afficher vos analyses dans le rapport DebugView), vous pouvez activer le mode débogage sur votre appareil de développement pour télécharger des événements avec un délai minimal.

iOS+

Pour activer le mode de débogage d'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 passés au lancement".

Android

Pour activer le mode de débogage d'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 d'Analytics dans votre navigateur, installez l'extension Google Analytics Debugger Chrome.

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 barre de 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 barre de 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 consigné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 (la 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 l'appareil de développement. Vous pouvez cliquer sur un événement pour afficher une liste des paramètres associés à cet événement.

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

Au fur et à 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. Cliquer sur l'un de ces cercles remplira le flux Seconds avec les événements qui ont été enregistrés pendant cette minute. Cela vous permet d'examiner efficacement les événements enregistrés au cours des 30 dernières minutes avec des détails précis.

Un exemple de 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 de l'utilisateur actuel affiche le dernier état de l'ensemble des propriétés de l'utilisateur pour le périphérique de développement actuellement sélectionné.

Un exemple de la table top-events.

Sélecteur d'appareil

Étant donné que de nombreux appareils de développement différents peuvent avoir le mode débogage activé, vous pouvez utiliser le sélecteur d'appareil pour choisir l'appareil 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 impact les uns sur les autres.

Un exemple de sélecteur d'appareil.