Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Registra eventi

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questa guida ti mostra come registrare gli eventi nella tua app.

Gli eventi forniscono informazioni dettagliate su ciò che sta accadendo nella tua app, ad esempio azioni dell'utente, eventi di sistema o errori.

Analytics registra automaticamente alcuni eventi per te; non è necessario aggiungere alcun codice per riceverli. Se la tua app ha bisogno di raccogliere dati aggiuntivi, puoi registrare fino a 500 diversi tipi di eventi di analisi nella tua app. Non c'è limite al volume totale di eventi che la tua app registra. Si noti che i nomi degli eventi fanno distinzione tra maiuscole e minuscole e che la registrazione di due eventi i cui nomi differiscono solo nel caso si tradurrà in due eventi distinti.

Prima di iniziare

Assicurati di aver impostato il tuo progetto e di poter accedere ad Analytics come descritto in Introduzione ad Analytics .

Registra eventi

Dopo aver creato un'istanza FirebaseAnalytics , puoi utilizzarla per registrare eventi con il metodo logEvent() .

Per aiutarti a iniziare, l'SDK di Analytics definisce una serie di eventi consigliati comuni a diversi tipi di app, tra cui app di vendita al dettaglio ed e-commerce, viaggi e giochi. Per ulteriori informazioni su questi eventi e su quando utilizzarli, consulta Eventi consigliati .

Puoi trovare i dettagli di implementazione per i tipi di eventi consigliati nelle seguenti posizioni:

L'esempio seguente mostra come registrare un evento SELECT_CONTENT :

Java

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);

Kotlin+KTX

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}

Oltre ai parametri prescritti, è possibile aggiungere in ogni caso i seguenti parametri:

  • Parametri personalizzati: i parametri personalizzati possono essere utilizzati come dimensioni o metriche nei rapporti di Analytics . È possibile utilizzare dimensioni personalizzate per i dati dei parametri degli eventi non numerici e le metriche personalizzate per tutti i dati dei parametri meglio rappresentati numericamente. Dopo aver registrato un parametro personalizzato utilizzando l'SDK, registra la dimensione o la metrica per assicurarti che tali parametri personalizzati vengano visualizzati nei rapporti di Analytics. Procedi tramite: Analytics > Eventi > Gestisci definizioni personalizzate > Crea dimensioni personalizzate

    I parametri personalizzati possono essere utilizzati nelle definizioni dei destinatari che possono essere applicati a ogni rapporto. I parametri personalizzati sono inclusi anche nei dati esportati in BigQuery se la tua app è collegata a un progetto BigQuery. Trova query di esempio e molto altro in Google Analytics 4 BigQuery Export .

  • Parametro VALUE : VALUE è un parametro generico utile per accumulare una metrica chiave relativa a un evento. Gli esempi includono entrate, distanza, tempo e punti.

Se la tua applicazione ha esigenze specifiche non coperte da un tipo di evento consigliato, puoi registrare i tuoi eventi personalizzati come mostrato in questo esempio:

Java

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Kotlin+KTX

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}

Imposta i parametri dell'evento predefiniti

Puoi registrare i parametri tra gli eventi usando setDefaultEventParameters . I parametri predefiniti sono associati a tutti gli eventi futuri registrati.

Come per i parametri personalizzati, registra i parametri dell'evento predefiniti per assicurarti che vengano visualizzati nei rapporti di Analytics.

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

Kotlin+KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Se un parametro è specificato nel metodo logEvent() , viene utilizzato quel valore invece del valore predefinito.

Per cancellare un parametro predefinito, chiama il metodo setDefaultEventParameters con il parametro impostato su null .

Visualizza gli eventi nel registro di debug di Android Studio

È possibile abilitare la registrazione dettagliata per monitorare la registrazione degli eventi da parte dell'SDK per verificare che gli eventi vengano registrati correttamente. Ciò include eventi registrati sia automaticamente che manualmente.

Puoi abilitare la registrazione dettagliata con una serie di comandi adb:

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

Questo comando mostra i tuoi eventi nel logcat di Android Studio, aiutandoti a verificare immediatamente che gli eventi vengano inviati.

Visualizza gli eventi nella dashboard

Puoi visualizzare statistiche aggregate sui tuoi eventi nelle dashboard della console Firebase. Questi dashboard si aggiornano periodicamente nel corso della giornata. Per il test immediato, utilizzare l'output logcat come descritto nella sezione precedente.

Puoi accedere a questi dati dalla dashboard Eventi nella console Firebase. Questa dashboard mostra i rapporti sugli eventi che vengono creati automaticamente per ogni tipo distinto di evento registrato dalla tua app.