Iniziare a utilizzare Google Analytics


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

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 della lingua o la posizione geografica.

Analytics registra automaticamente alcuni eventi e proprietà utente; non devi aggiungere alcun codice per abilitarli.

Prima di iniziare

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

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

  • Se utilizzi un progetto Firebase esistente in cui non è abilitato Google Analytics, 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 (a livello di app) del modulo (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 il controllo delle versioni della libreria. 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.16.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 la Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase Android.

    (Alternativa)  Aggiungi le dipendenze della libreria Firebase senza utilizzare BoM

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

    Tieni presente che se utilizzi più librerie Firebase nella tua app, ti consigliamo vivamente di utilizzare la 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.5.0")
}
         Cerchi un modulo della libreria specifico per Kotlin? A partire da ottobre 2023 (Firebase BoM 32.5.0), gli sviluppatori Kotlin e Java possono fare affidamento sul modulo della libreria principale (per i dettagli, consulta le domande frequenti su questa iniziativa).

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

    Kotlin 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. Inizializzalo nel metodo onCreate():

    Kotlin 

    // 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 disponibile nei report e usufruire delle funzionalità e delle integrazioni future non appena diventano disponibili. Questa sezione mostra la registrazione di un evento predefinito. Per saperne di più sulla registrazione degli eventi, vedi Registrare gli eventi.

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

Kotlin 

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 e 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, aiutandoti a verificare immediatamente che gli eventi vengano inviati.

Passaggi successivi