Iniziare a utilizzare Google Analytics


Questa guida rapida illustra come aggiungere Google Analytics alla tua app e iniziare a registrare gli eventi.

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

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

Analytics registra automaticamente alcuni eventi e proprietà utente. Non è necessario aggiungere codice per attivarli.

Prima di iniziare

Se non lo hai già fatto, aggiungi Firebase al tuo progetto Android e assicurati che Google Analytics sia attivato nel progetto Firebase:

  • Se stai creando un nuovo progetto Firebase, abilita Google Analytics durante il flusso di lavoro di creazione del progetto.

  • Se utilizzi un progetto Firebase esistente in cui Google Analytics non è attivo, vai alla scheda Integrazioni di > Impostazioni progetto per attivarlo.

Quando attivi Google Analytics nel tuo progetto, le tue app Firebase vengono collegate agli stream di dati Google Analytics.

Aggiungere l'SDK Analytics all'app

  1. Nel file Gradle del modulo (a livello di app) (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi la dipendenza per la libreria Analytics per Android. Ti consigliamo di utilizzare Firebase Android BoM per controllare la versione della libreria. 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.6.0"))

    // Add the dependency for the Analytics library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-analytics")
}

    Utilizzando Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase per Android.

    (Alternativa)  Aggiungi le dipendenze delle librerie Firebase senza utilizzare il file BoM

    Se scegli di non utilizzare Firebase BoM, devi specificare ogni versione della libreria Firebase nella relativa riga di dipendenza.

    Tieni presente che se nella tua app utilizzi più librerie Firebase, ti consigliamo vivamente di utilizzare BoM per gestire le versioni delle librerie, in modo da garantire la compatibilità di tutte le versioni. 

    dependencies {
    // Add the dependency for the Analytics library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-analytics:22.1.2")
}
    Cerchi un modulo della libreria specifico per Kotlin? A partire da ottobre 2023 (Firebase BoM 32.5.0), sia gli sviluppatori Kotlin che Java possono fare affidamento sul modulo della libreria principale (per maggiori dettagli, consulta le Domande frequenti su questa iniziativa).

  2. Dichiara l'oggetto com.google.firebase.analytics.FirebaseAnalytics nella parte superiore dell'attività:

    Kotlin+KTX 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. Inizializzalo nel metodo onCreate():

    Kotlin+KTX 

    // Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analytics
    MainActivity.kt

    Java 

    // Obtain the FirebaseAnalytics instance.
mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
    MainActivity.java

Avvia la registrazione degli eventi

Dopo aver creato un'istanza FirebaseAnalytics, puoi iniziare a registrare gli eventi con il metodo logEvent().

Alcuni eventi sono consigliati per tutte le app; altri sono consigliati per verticali o tipi di attività specifici. Ti consigliamo di inviare gli eventi suggeriti insieme ai relativi parametri obbligatori per garantire il massimo livello di dettagli nei report e usufruire delle funzionalità e delle integrazioni future non appena diventano disponibili. Questa sezione mostra come eseguire il logging di un evento predefinito. Per ulteriori informazioni sul logging degli eventi, consulta Eventi di log.

Il seguente codice registra un evento SELECT_CONTENT quando un utente fa clic su un elemento specifico nella tua app.

Kotlin+KTX 

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

Puoi attivare il logging dettagliato per monitorare il logging degli eventi da parte dell'SDK per contribuire a 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, consentendoti di verificare immediatamente che gli eventi vengano inviati.

Passaggi successivi