Ikuti semua informasi yang diumumkan di Firebase Summit, dan pelajari bagaimana Firebase dapat membantu Anda mempercepat pengembangan aplikasi dan menjalankan aplikasi dengan percaya diri. Pelajari Lebih Lanjut

Memulai Google Analytics

Panduan memulai ini menunjukkan cara menambahkan Google Analytics ke aplikasi Anda dan mulai mencatat peristiwa.

Google Analytics mengumpulkan data penggunaan dan perilaku untuk aplikasi Anda. SDK mencatat dua jenis informasi utama:

  • Peristiwa: Apa yang terjadi di aplikasi Anda, seperti tindakan pengguna, peristiwa sistem, atau kesalahan.
  • Properti pengguna: Atribut yang Anda tentukan untuk menggambarkan segmen basis pengguna Anda, seperti preferensi bahasa atau lokasi geografis.

Analytics secara otomatis mencatat beberapa peristiwa dan properti pengguna ; Anda tidak perlu menambahkan kode apa pun untuk mengaktifkannya.

Sebelum kamu memulai

Jika Anda belum melakukannya, tambahkan Firebase ke proyek Android Anda dan pastikan Google Analytics diaktifkan di proyek Firebase Anda:

  • Jika Anda membuat proyek Firebase baru, aktifkan Google Analytics selama alur kerja pembuatan proyek.

  • Jika Anda menggunakan proyek Firebase yang sudah ada yang tidak mengaktifkan Google Analytics, buka tab Integrasi di Anda > Setelan proyek untuk mengaktifkannya.

Saat Anda mengaktifkan Google Analytics di proyek Anda, aplikasi Firebase Anda ditautkan ke aliran data Google Analytics.

Tambahkan SDK Analytics ke aplikasi Anda

  1. Dalam file Gradle modul (tingkat aplikasi) Anda (biasanya <project>/<app-module>/build.gradle ), tambahkan dependensi untuk pustaka Android Analytics. Sebaiknya gunakan Firebase Android BoM untuk mengontrol pembuatan versi library.

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.1.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'
    }
    

    Dengan menggunakan Firebase Android BoM , aplikasi Anda akan selalu menggunakan versi library Firebase Android yang kompatibel.

    (Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM

    Jika Anda memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi pustaka Firebase di baris dependensinya.

    Perhatikan bahwa jika Anda menggunakan beberapa pustaka Firebase di aplikasi Anda, kami sangat menyarankan penggunaan BoM untuk mengelola versi pustaka, yang memastikan bahwa semua versi kompatibel.

    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.2.0'
    }
    

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.1.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-ktx'
    }
    

    Dengan menggunakan Firebase Android BoM , aplikasi Anda akan selalu menggunakan versi library Firebase Android yang kompatibel.

    (Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM

    Jika Anda memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi pustaka Firebase di baris dependensinya.

    Perhatikan bahwa jika Anda menggunakan beberapa pustaka Firebase di aplikasi Anda, kami sangat menyarankan penggunaan BoM untuk mengelola versi pustaka, yang memastikan bahwa semua versi kompatibel.

    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-ktx:21.2.0'
    }
    

  2. Deklarasikan objek com.google.firebase.analytics.FirebaseAnalytics di bagian atas aktivitas Anda:

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. Inisialisasi dalam metode onCreate() :

    Java

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

    Kotlin+KTX

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

Mulai mencatat acara

Setelah membuat instance FirebaseAnalytics , Anda dapat mulai mencatat peristiwa dengan metode logEvent() .

Acara tertentu direkomendasikan untuk semua aplikasi ; lainnya direkomendasikan untuk jenis bisnis atau vertikal tertentu. Anda harus mengirim acara yang disarankan bersama dengan parameter yang ditentukan, untuk memastikan detail maksimum yang tersedia dalam laporan Anda dan untuk mendapatkan manfaat dari fitur dan integrasi di masa mendatang saat tersedia. Bagian ini mendemonstrasikan pendataan peristiwa yang telah ditentukan sebelumnya, untuk informasi selengkapnya tentang pendataan peristiwa, lihat Mencatat peristiwa .

Kode berikut mencatat peristiwa SELECT_CONTENT saat pengguna mengklik elemen tertentu di aplikasi Anda.

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

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

Anda dapat mengaktifkan pencatatan log verbose untuk memantau pencatatan log peristiwa oleh SDK guna membantu memverifikasi bahwa peristiwa dicatat dengan benar. Ini termasuk peristiwa yang dicatat secara otomatis dan manual.

Anda dapat mengaktifkan pencatatan verbose dengan serangkaian perintah adb :

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

Perintah ini menampilkan acara Anda di logcat Android Studio, membantu Anda segera memverifikasi bahwa acara sedang dikirim.

Langkah selanjutnya