Registra eventi

Seleziona la piattaforma: iOS+ Android Web Flutter Unity C++

Gli eventi forniscono informazioni su ciò che accade nella tua app, ad esempio azioni degli utenti , eventi di sistema o errori.

Analytics registra automaticamente alcuni eventi per te, quindi non devi aggiungere alcun codice per riceverli. Se la tua app deve raccogliere dati aggiuntivi, puoi registrare fino a 500 diversi eventi Analytics tipi nella tua app. Non esiste un limite al volume totale di eventi registrati dalla tua app. Tieni presente che i nomi degli eventi sono sensibili alle maiuscole e che la registrazione di due eventi i cui nomi differiscono solo per l'uso delle maiuscole comporta la creazione di due eventi distinti.

Prima di iniziare

Assicurati di aver configurato il progetto e di poter accedere a Analytics come descritto nella Guida introduttiva a Analytics.

Eventi dei log

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

Per aiutarti a iniziare, l'Analytics SDK definisce una serie di eventi consigliati comuni a diversi tipi di app, tra cui app di vendita al dettaglio ed e-commerce, di viaggi e di giochi. Per scoprire di più 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:

Il seguente esempio mostra come registrare un SELECT_CONTENT evento:

Kotlin 

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

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);
MainActivity.java

Oltre ai parametri prescritti, puoi aggiungere i seguenti parametri a qualsiasi evento:

  • Parametri personalizzati: i parametri personalizzati possono essere utilizzati come dimensioni o metriche nei Analytics report. Puoi utilizzare le dimensioni personalizzate per i dati dei parametri evento non numerici e le metriche personalizzate per i dati dei parametri rappresentati meglio numericamente. Dopo aver registrato un parametro personalizzato utilizzando l'SDK, registra la dimensione o la metrica per assicurarti che questi parametri personalizzati vengano visualizzati nei report di Analytics. Per farlo, vai a Analytics > Eventi > Gestisci definizioni personalizzate > Crea dimensioni personalizzate

    I parametri personalizzati possono essere utilizzati nelle definizioni dei segmenti di pubblico che possono essere applicate a ogni report. 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 ancora in BigQuery Export di Google Analytics 4.

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

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

Kotlin 

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

Java 

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

Impostare i parametri evento predefiniti

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

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

Kotlin 

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Java 

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

Se un parametro viene specificato nel logEvent() metodo, viene utilizzato questo valore anziché quello predefinito.

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

Visualizzare gli eventi nel log di debug di Android Studio

Puoi attivare il logging dettagliato per monitorare la registrazione degli eventi da parte dell'SDK e verificare che gli eventi vengano registrati correttamente. Sono inclusi sia gli eventi registrati automaticamente sia quelli registrati manualmente.

Puoi attivare il logging dettagliato 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 gli eventi in logcat di Android Studio, aiutandoti a verificare immediatamente che gli eventi vengano inviati.

Visualizzare gli eventi nella dashboard

Puoi visualizzare le statistiche aggregate sugli eventi nelle Firebase console dashboards. Queste dashboard vengono aggiornate periodicamente durante la giornata. Per i test immediati, utilizza l'output di logcat come descritto nella sezione precedente.

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