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.

Google 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 tipi di eventi Analytics diversi 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 risulta in due eventi distinti.

Prima di iniziare

Prima di poter utilizzare Google Analytics, devi:

• Registrare il tuo progetto Unity e configurarlo 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.

• Aggiungere Firebase Unity SDK (in particolare, FirebaseAnalytics.unitypackage) al tuo progetto Unity.

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

Tieni presente che l'aggiunta di Firebase al tuo progetto Unity comporta attività sia nella Firebase console sia nel progetto Unity aperto (ad esempio, scarichi i file di configurazione Firebase dalla console, quindi sposti i file 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'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 saperne di più su questi eventi e su quando utilizzarli, consulta gli articoli sugli eventi consigliati nel Centro assistenza di Google Analytics.

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

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

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

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

    // 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 Analytics report, ma possono essere utilizzati come filtri nelle definizioni del 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 Analytics evento. Alcuni esempi sono entrate, distanza, tempo e punti.

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

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

Visualizzare gli eventi nell'output dei log

iOS+

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

Android

Puoi abilitare il logging dettagliato nel log di debug di Android Studio per verificare che gli eventi vengano registrati correttamente dall'SDK. Sono inclusi sia gli eventi registrati automaticamente sia quelli registrati manualmente.

Puoi abilitare 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 di Analytics nella dashboard

Puoi visualizzare le statistiche aggregate sui tuoi Analytics eventi nelle Firebase dashboard della console. Queste dashboard vengono aggiornate periodicamente durante il giorno. Per i test immediati, utilizza l'output logcat come descritto nella sezione precedente.

Per accedere a questi dati nella Firebase console:

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

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