DebugView ti consente di visualizzare i dati sugli eventi non elaborati registrati dalla tua app sui dispositivi di sviluppo quasi in tempo reale. È molto utile per la convalida durante la fase di strumentazione dello sviluppo e può aiutarti a scoprire errori e sviste nell'implementazione di Analytics e a confermare che tutti gli eventi e le proprietà utente vengono registrati correttamente.
Abilita modalità di debug
In genere, gli eventi registrati dalla tua app vengono raggruppati per un periodo di circa un'ora e caricati insieme. Questo approccio consente di risparmiare la batteria dei dispositivi degli utenti finali e riduce l'utilizzo dei dati di rete. Tuttavia, ai fini della convalida dell'implementazione di Analytics (e per visualizzare Analytics nel report DebugView), puoi attivare la modalità di debug sul tuo 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 specificando il seguente argomento della riga di comando:
-FIRDebugDisabled
Puoi aggiungere questi argomenti modificando lo schema del progetto e aggiungendo una nuova voce a "Arguments Passed On Launch".
Android
Per attivare la modalità di debug Analytics su un dispositivo Android, esegui questi 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à 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 di eventi o proprietà utente) sia altri eventi che includono un parametro firebase_error.
Tieni presente che mentre gli eventi error vengono visualizzati direttamente nello stream, per gli 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 i 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 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, viene visualizzato un elenco degli eventi registrati negli ultimi 60 secondi. A ogni evento è associato 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 durante l'utilizzo dell'app, vedrai una voce per questa 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 conteggio degli 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 gli 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 del set 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 su cui si concentrerà il report DebugView. In questo modo, più sviluppatori possono concentrarsi sui propri sforzi di strumentazione e convalida senza influire l'uno sull'altro.
