Iniziare a utilizzare Google Analytics per Unity

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

Google Analytics raccoglie dati sull'utilizzo e sul comportamento per la tua app. L'SDK registra due tipi principali di informazioni:

  • Eventi: cosa sta succedendo nella tua app, ad esempio azioni degli utenti, eventi di sistema o errori.
  • Proprietà utente: attributi che definisci per descrivere i segmenti della tua base utenti, come la preferenza sulla lingua o la posizione geografica.

Analytics registra automaticamente alcuni eventi e proprietà utente; per abilitarle non è necessario aggiungere alcun codice. Se la tua app deve raccogliere dati aggiuntivi, puoi configurare fino a 25 proprietà utente Analytics diverse e registrare fino a 500 Analytics _tipi_di eventi diversi nella tua app. Non esiste un limite al volume totale di eventi registrati dalla tua app.

Per accedere a questi dati:

  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.

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, viaggi e giochi. Per scoprire di più su questi eventi e su quando utilizzarli, consulta Eventi consigliati. Per ottenere il massimo livello di dettaglio nei report, registra gli eventi Analytics suggeriti che hanno senso per la tua app e i relativi parametri obbligatori. In questo modo, potrai usufruire delle funzionalità più recenti Google Analytics non appena diventano disponibili.

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 l'Firebase Unity SDK (in particolare, FirebaseAnalytics.unitypackage) al tuo 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

Puoi iniziare immediatamente a registrare gli eventi con il LogEvent() metodo.

Il seguente esempio registra gli eventi con vari tipi di argomenti:

// Log an event with no parameters.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);

// Log an event with a float parameter
Firebase.Analytics.FirebaseAnalytics
  .LogEvent("progress", "percent", 0.4f);

// Log an event with an int parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventPostScore,
    Firebase.Analytics.FirebaseAnalytics.ParameterScore,
    42
  );

// Log an event with a string parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,
    Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,
    "spoon_welders"
  );

// Log an event with multiple parameters, passed as a struct:
Firebase.Analytics.Parameter[] LevelUpParameters = {
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, "mrspoon"),
  new Firebase.Analytics.Parameter(
    "hit_accuracy", 3.14f)
};
Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventLevelUp,
  LevelUpParameters);

Passaggi successivi