DebugView ti consente di visualizzare i dati sugli eventi non elaborati registrati dalla tua app sui dispositivi di sviluppo quasi in tempo reale. Questo è molto utile per scopi di convalida durante la fase di strumentazione dello sviluppo e può aiutarti a scoprire errori e sbagli nell'implementazione di Analytics e a confermare che tutti gli eventi e le proprietà utente vengano registrati correttamente.
Abilita modalità di debug
In genere, i log eventi registrati dalla tua app vengono raggruppati in batch per un periodo di circa un'ora e caricati insieme. Questo approccio consente di risparmiare la batteria sui dispositivi degli utenti finali e riduce l'utilizzo dei dati di rete. Tuttavia, per convalidare l'implementazione di Analytics (e per visualizzare Analytics nel report DebugView), puoi attivare la modalità di debug sul dispositivo di sviluppo per caricare gli eventi con un ritardo minimo.
iOS+
Per attivare la modalità di debug di Analytics sul tuo dispositivo di sviluppo, specifica il seguente argomento della riga di comando in Xcode:
-FIRDebugEnabled
Questo comportamento persiste finché non disattivi in modo esplicito la modalità di debug tramite il seguente argomento della riga di comando:
-FIRDebugDisabled
Puoi aggiungere questi argomenti modificando lo schema del progetto e aggiungendo una nuova voce ad "Arguments Passed On Launch" (Argomenti passati al lancio).
Android
Per attivare la modalità di debug di Analytics su un dispositivo Android, esegui i seguenti comandi:
adb shell setprop debug.firebase.analytics.app PACKAGE_NAME
Questo comportamento persiste finché non disattivi in modo esplicito la modalità di debug tramite il seguente comando:
adb shell setprop debug.firebase.analytics.app .none.
Web
Per attivare la modalità di debug di Analytics nel browser, installa l'estensione di Chrome Google Analytics Debugger.
Al termine dell'installazione, attiva l'estensione e aggiorna la pagina. Da quel momento in poi, l'estensione registrerà gli eventi nella tua app in modalità di debug.
Puoi visualizzare gli eventi registrati in DebugView nella console Firebase.
Visualizza error eventi
Nel report DebugView vengono visualizzati sia gli eventi error registrati automaticamente (che indicano problemi con la registrazione degli eventi o delle proprietà utente) sia altri eventi che includono un parametro firebase_error.
Tieni presente che, mentre gli eventi error vengono visualizzati direttamente nello stream, per altri eventi che includono un parametro firebase_error, DebugView non mostra un indicatore di errore speciale nello stream di eventi principale. Devi fare clic sull'evento per visualizzare il parametro firebase_error nell'elenco dei parametri.
Per facilitare il debug degli errori di implementazione di Analytics, controlla i log della console del dispositivo per verificare la presenza di messaggi dell'SDK Firebase Analytics, che spesso forniscono dettagli sul motivo per cui un evento o un parametro è stato rifiutato.
Report sui dati sugli eventi
Assicurati di aver attivato la modalità di debug sui tuoi dispositivi di sviluppo come descritto nella sezione precedente di questa guida.
Nella console Firebase, vai ad Analytics > DebugView.
Inizia a interagire con la tua app per visualizzare gli eventi dell'app registrati nel report DebugView nella console Firebase.
Lo stream Secondi (la colonna centrale) mostra gli eventi registrati negli ultimi 60 secondi. Lo stream Minuti (la colonna a sinistra) mostra una serie di archivi degli eventi registrati negli ultimi 30 minuti. La colonna a destra mostra gli eventi principali registrati nell'arco di 30 minuti, insieme alle proprietà utente correnti relative al dispositivo di sviluppo selezionato.
Sequenza Secondi
Per impostazione predefinita, vedrai un elenco di eventi registrati negli ultimi 60 secondi. A ogni evento è associato a un timestamp che indica l'ora della registrazione sul dispositivo di sviluppo. Puoi fare clic su un evento per visualizzare un elenco dei parametri associati.
Man mano che i valori delle proprietà utente cambiano nel corso dell'utilizzo dell'app, vedrai una voce per ogni modifica.
Sequenza Minuti
Questo stream mostra una serie di cerchi, ognuno dei quali corrisponde a un minuto di tempo negli ultimi 30 minuti. Il numero nel cerchio indica il numero di eventi ricevuti in quel minuto. Se fai clic su uno di questi cerchi, lo stream Secondi viene compilato con gli eventi registrati durante quel minuto. In questo modo, puoi esaminare in dettaglio i log eventi registrati negli ultimi 30 minuti.
Eventi principali e Proprietà dell'utente attuale
La tabella Eventi principali mostra gli eventi principali registrati nell'arco di 30 minuti. La tabella Proprietà utente correnti mostra lo stato più recente dell'insieme di proprietà utente per il dispositivo di sviluppo selezionato.
Selettore dispositivo
Poiché la modalità di debug può essere attivata su molti dispositivi di sviluppo diversi, puoi utilizzare il selettore dispositivo per scegliere quello specifico per il report DebugView. In questo modo, più sviluppatori possono concentrarsi sulle proprie attività di strumentazione e convalida senza interferire tra loro.
