Registra eventi

Gli eventi forniscono informazioni su cosa sta succedendo nella tua app, ad esempio azioni degli utenti, eventi di sistema o errori.

Google Analytics registra automaticamente alcuni eventi per te; non devi aggiungere alcun codice per riceverli. Se la tua app deve raccogliere dati aggiuntivi, puoi registrare fino a 500 diversi tipi di eventiAnalytics nella tua app. Non esiste un limite per il 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 genera due eventi distinti.

Prima di iniziare

Prima di poter utilizzare Google Analytics, devi:

• Registra il tuo progetto Unity e configuralo in modo che utilizzi Firebase.

  • Se il tuo progetto Unity utilizza già Firebase, è già registrato e configurato per Firebase.

  • Se non hai un progetto Unity, puoi scaricare un'app di esempio.

• Aggiungi l'SDK Firebase Unity (in particolare FirebaseAnalytics.unitypackage) al tuo progetto Unity.

Scopri le istruzioni dettagliate per queste attività di configurazione iniziale in Aggiungere Firebase al progetto Unity.

Tieni presente che l'aggiunta di Firebase al progetto Unity comporta attività sia nella console Firebase sia nel progetto Unity aperto (ad esempio, scarichi i file di configurazione di Firebase dalla console, quindi li sposti nel progetto Unity).

Eventi dei log

Dopo aver inizializzato il modulo Firebase.Analytics.FirebaseAnalytics, puoi utilizzarlo per registrare gli eventi con il metodo LogEvent().

Per aiutarti a iniziare, l'SDK Analytics 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 gli articoli sugli eventi consigliati nel Centro assistenza Google Analytics.

Nota: per ottenere il massimo livello di dettaglio nei report, registra gli Analytics eventi suggeriti pertinenti per la tua app e i relativi parametri obbligatori. In questo modo, puoi anche usufruire delle funzionalità Google Analytics più recenti non appena diventano disponibili.

Puoi trovare i dettagli di implementazione per gli eventi consigliati nelle seguenti località:

• Eventi suggeriti: consulta l'elenco delle costanti Event.
• Parametri prescritti: consulta l'elenco delle costanti Parameters.

L'esempio seguente mostra come registrare un evento SELECT_CONTENT suggerito:

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

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

• Parametri personalizzati: i parametri personalizzati non sono rappresentati direttamente nei reportAnalytics, ma possono essere utilizzati come filtri nelle definizioni del segmento 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.

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

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

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

Visualizzare gli eventi nell'output del log

Android

Puoi attivare il logging dettagliato nel log di debug di Android Studio per verificare che gli eventi vengano registrati correttamente dall'SDK. Sono inclusi gli eventi registrati sia automaticamente sia 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.

iOS+

Gli eventi vengono registrati nella console e possono essere visualizzati durante l'esecuzione dell'app tramite Xcode.

Visualizzare gli eventi di analisi nella dashboard

Puoi visualizzare le statistiche aggregate relative ai tuoi Analytics eventi nelle dashboard della console Firebase. Queste dashboard vengono aggiornate periodicamente nel corso della giornata. Per test immediati, utilizza l'output di logcat come descritto nella sezione precedente.

Per accedere a questi dati nella console Firebase:

1. Nella console Firebase, apri il progetto.
2. Seleziona Analytics dal menu per visualizzare la dashboard dei report Analytics.

La scheda Eventi mostra i report sugli eventi che vengono creati automaticamente per ogni tipo distinto di evento Analytics registrato dalla tua app. Scopri di più sulla dashboard.