Iniziare a utilizzare Google Analytics

Questa guida rapida ti 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, come azioni dell'utente, eventi di sistema o errori.
  • Proprietà utente: attributi che definisci per descrivere segmenti della tua base utenti, come la preferenza della lingua o la posizione geografica.

Analytics registra automaticamente alcuni eventi e proprietà dell'utente ; non è necessario aggiungere alcun codice per abilitarli.

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 stai creando un nuovo progetto Firebase, abilita Google Analytics durante il flusso di lavoro di creazione del progetto.

  • Se utilizzi un progetto Firebase esistente su cui non è abilitato Google Analytics, vai alla scheda Integrazioni del tuo > Impostazioni progetto per abilitarlo.

Quando abiliti Google Analytics nel tuo progetto, le tue app Firebase sono collegate ai flussi di dati di Google Analytics.

Aggiungi l'SDK di Analytics alla tua app

  1. Nel file Gradle del modulo (a livello di app) (solitamente <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 distinta base Android Firebase per controllare il controllo delle versioni della libreria.

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

    (Alternativa) Aggiungi le dipendenze della libreria Firebase senza utilizzare la distinta base

    Se scegli di non utilizzare la distinta base Firebase, devi specificare ciascuna versione della libreria Firebase nella relativa riga di dipendenza.

    Tieni presente che se utilizzi più librerie Firebase nella tua app, ti consigliamo vivamente di utilizzare la distinta base per gestire le versioni della libreria, il che garantisce 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:21.5.1")
    }
    
    Cerchi un modulo di libreria specifico per Kotlin? A partire da ottobre 2023 (Firebase BoM 32.5.0) , sia gli sviluppatori Kotlin che quelli Java potranno dipendere dal modulo della libreria principale (per i dettagli, vedere le FAQ su questa iniziativa ).

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

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. Inizializzalo nel metodo onCreate() :

    Kotlin+KTX

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

    Java

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

Inizia 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 di attività o settori verticali specifici. Dovresti inviare gli eventi suggeriti insieme ai parametri prescritti, per garantire il massimo dettaglio disponibile nei tuoi report e per trarre vantaggio dalle funzionalità e integrazioni future non appena diventano disponibili. Questa sezione illustra la registrazione di un evento predefinito. Per ulteriori informazioni sulla registrazione degli eventi, vedere Registrare eventi .

Il codice seguente 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")
}

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

È possibile abilitare la registrazione dettagliata per monitorare la registrazione degli eventi da parte dell'SDK per verificare che gli eventi vengano registrati correttamente. Ciò include sia gli eventi registrati automaticamente che quelli registrati 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.

Prossimi passi