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

Registra eventi

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

Google Analytics registra automaticamente alcuni eventi per te; non è necessario aggiungere alcun codice per riceverli. Se la tua app deve raccogliere dati aggiuntivi, puoi registrare fino a 500 diversi tipi di eventi di Analytics nella tua app. Non c'è limite al volume totale di eventi registrati dall'app. Tieni presente che i nomi degli eventi fanno distinzione tra maiuscole e minuscole e che la registrazione di due eventi i cui nomi differiscono solo per maiuscole e minuscole risulterà in due eventi distinti.

Prima di iniziare

Prima di poter utilizzare Google Analytics , devi:

  • Registra il tuo progetto Unity e configuralo per utilizzare Firebase.

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

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

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

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

Registra eventi

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

Per aiutarti a iniziare, l'SDK di Analytics definisce una serie di eventi suggeriti 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 gli articoli su Eventi e proprietà nel Centro assistenza Firebase.

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

  • Eventi suggeriti: vedere l'elenco delle costanti Event .
  • Parametri prescritti: vedere 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 prescritti, è possibile aggiungere i seguenti parametri a qualsiasi evento:

  • Parametri personalizzati: i parametri personalizzati non sono rappresentati direttamente nei rapporti di Analytics, ma possono essere utilizzati come filtri nelle definizioni dei segmenti di pubblico 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.

  • Parametro VALUE : VALUE è un parametro generico utile per accumulare una metrica chiave relativa a un evento di Analytics. Gli esempi includono 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);

Visualizza gli eventi nell'output del registro

Androide

Puoi abilitare la registrazione dettagliata nel registro di debug di Android Studio, per verificare che gli eventi vengano registrati correttamente dall'SDK. Ciò include gli 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 visualizza i tuoi eventi nel 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.

Visualizza gli eventi di analisi nella dashboard

Puoi visualizzare statistiche aggregate sui tuoi eventi di Analytics nelle dashboard della console Firebase. Questi dashboard si aggiornano periodicamente durante il giorno. Per test immediati, utilizzare l'output di logcat come descritto nella sezione precedente.

Per accedere a questi dati nella console Firebase:

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

La scheda Eventi mostra i rapporti sugli eventi che vengono creati automaticamente per ogni tipo distinto di evento di Analytics registrato dalla tua app. Leggi ulteriori informazioni sulla dashboard dei rapporti di Analytics nel Centro assistenza Firebase.