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

Debug degli eventi

DebugView ti consente di visualizzare i dati degli eventi non elaborati registrati dalla tua app sui dispositivi di sviluppo quasi in tempo reale. Questo è molto utile ai fini della convalida durante la fase di sviluppo della strumentazione e può aiutarti a scoprire errori ed errori nell'implementazione di Analytics e confermare che tutti gli eventi e le proprietà utente siano registrati correttamente.

Abilita la modalità di debug

In genere, gli eventi registrati dalla tua app vengono raggruppati insieme per un periodo di circa un'ora e caricati insieme. Questo approccio conserva la batteria sui 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 rapporto DebugView), puoi abilitare la modalità di debug sul tuo dispositivo di sviluppo per caricare gli eventi con un ritardo minimo.

iOS+

Per abilitare 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 disabiliti esplicitamente la modalità di debug specificando il seguente argomento della riga di comando:

-FIRDebugDisabled

Puoi aggiungere questi argomenti modificando lo schema del tuo progetto e aggiungendo una nuova voce a "Argomenti trasmessi all'avvio".

Androide

Per abilitare 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 fino a quando non disabiliti esplicitamente la modalità di debug eseguendo il seguente comando:

adb shell setprop debug.firebase.analytics.app .none.

ragnatela

Per abilitare la modalità di debug di Analytics nel tuo browser, installa l'estensione Chrome di Google Analytics Debugger .

Una volta installato, abilita 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.

Rapporto sui dati dell'evento

Dopo aver abilitato la modalità di debug sui tuoi dispositivi di sviluppo, passa a DebugView selezionando la freccia accanto a StreamView nella barra di navigazione superiore di Google Analytics e selezionando DebugView.

Passare a DebugView selezionando la freccia accanto a StreamView nella barra di navigazione superiore di Google Analytics e selezionando DebugView

Quindi, inizia a utilizzare la tua app per vedere gli eventi della tua app registrati nel rapporto DebugView.

Il rapporto DebugView.

Il flusso Secondi (colonna centrale) mostra gli eventi che sono stati registrati negli ultimi 60 secondi. Il flusso dei minuti (la colonna di sinistra) mostra una serie di archivi di eventi degli ultimi 30 minuti. E la colonna di destra mostra i principali eventi registrati nel periodo di 30 minuti, nonché le proprietà dell'utente corrente per il dispositivo di sviluppo attualmente selezionato.

Flusso di secondi

Per impostazione predefinita, vedrai un elenco di eventi registrati negli ultimi 60 secondi. Ogni evento visualizza un timestamp che corrisponde all'ora della sua registrazione sul dispositivo di sviluppo. È possibile fare clic su un evento per visualizzare un elenco dei parametri associati a tale evento.

Un esempio di elenco di parametri evento.

Man mano che i valori delle proprietà utente cambiano durante l'utilizzo dell'app, vedrai una voce per tale modifica.

Una proprietà utente di esempio.

Flusso di minuti

Questo flusso mostra una serie di cerchi che corrispondono ciascuno a un minuto di tempo negli ultimi 30 minuti. Il numero nel cerchio indica il conteggio degli eventi ricevuti in quel minuto. Facendo clic su uno di questi cerchi, lo stream Secondi verrà popolato con gli eventi registrati durante quel minuto di tempo. Ciò consente in modo efficace di esaminare gli eventi registrati negli ultimi 30 minuti in dettaglio.

Un esempio del flusso dei minuti.

Principali eventi e proprietà dell'utente corrente

La tabella Eventi principali mostra gli eventi principali che sono stati registrati durante il periodo di 30 minuti. E la tabella Proprietà utente corrente mostra lo stato più recente del set di proprietà utente per il dispositivo di sviluppo attualmente selezionato.

Un esempio della tabella dei migliori eventi.

Selettore dispositivo

Poiché molti dispositivi di sviluppo diversi possono avere la modalità di debug abilitata, puoi utilizzare il Selettore dispositivo per scegliere il dispositivo specifico su cui si concentrerà il rapporto DebugView. Ciò consente a più sviluppatori di concentrarsi sui propri sforzi di strumentazione e convalida senza influire l'uno sull'altro.

Un esempio del selettore del dispositivo.