Iniziare a utilizzare Google Analytics per Android

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


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 della 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.

Prima di iniziare

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

  • Se generi 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, puoi abilitarlo nella scheda Impostazioni > Integrazioni.

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

Aggiungere l'SDK Analytics alla tua app

  1. Nel file Gradle del modulo (a livello di app) (in genere <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 la 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:34.13.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")
}

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

    (Alternativa)  Aggiungere dipendenze della libreria Firebase senza utilizzare la BoM

    Se scegli di non utilizzare la Firebase BoM, devi specificare la versione di ogni libreria Firebase nella riga di 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 che tutte le versioni siano compatibili. 

    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:23.2.0")
}

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

    Kotlin 

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;

  3. Inizializzalo nel metodo onCreate():

    Kotlin 

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

    Java 

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

Iniziare a registrare gli 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 tipi o verticali di attività specifici. Ti suggeriamo di inviare gli eventi suggeriti con i relativi parametri prescritti, per garantire il livello massimo di dettagli disponibile nei report e usufruire delle funzionalità e delle integrazioni future non appena diventano disponibili. Questa sezione mostra come registrare un evento predefinito. Per ulteriori informazioni 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 nella 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")
}

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);

Puoi abilitare il logging dettagliato per monitorare la registrazione 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 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.

Passaggi successivi