Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Memulai Google Analytics

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

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

  • Peristiwa: Hal-hal yang terjadi dalam aplikasi Anda, seperti tindakan pengguna, peristiwa sistem, atau error.
  • Properti pengguna: Atribut yang Anda tentukan untuk menggambarkan segmen basis pengguna, seperti preferensi bahasa atau lokasi geografis.

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

Sebelum memulai

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

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

  • Jika Anda menggunakan project Firebase yang sudah ada dan belum mengaktifkan Google Analytics, buka tab Integrasi di bagian > Setelan project untuk mengaktifkannya.

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

Menambahkan SDK Analytics ke aplikasi Anda

  1. Dengan Firebase Android BoM, deklarasikan dependensi untuk library Android Analytics di file Gradle modul (level aplikasi) Anda (biasanya app/build.gradle).

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:28.2.1')
    
        // Declare 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 Android Firebase yang kompatibel.

    (Alternatif) Deklarasikan dependensi library Firebase tanpa menggunakan BoM

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

    Perhatikan bahwa jika Anda menggunakan beberapa library Firebase di aplikasi Anda, sebaiknya gunakan BoM untuk mengelola versi library, yang memastikan bahwa semua versi kompatibel.

    dependencies {
        // Declare 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:19.0.0'
    }
    

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:28.2.1')
    
        // Declare 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 Android Firebase yang kompatibel.

    (Alternatif) Deklarasikan dependensi library Firebase tanpa menggunakan BoM

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

    Perhatikan bahwa jika Anda menggunakan beberapa library Firebase di aplikasi Anda, sebaiknya gunakan BoM untuk mengelola versi library, yang memastikan bahwa semua versi kompatibel.

    dependencies {
        // Declare 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:19.0.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. Inisialisasikan dalam metode onCreate():

    Java

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

    Kotlin+KTX

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

Memulai mencatat peristiwa ke dalam log

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

Peristiwa tertentu direkomendasikan untuk semua aplikasi, sedangkan peristiwa yang lain direkomendasikan untuk jenis atau vertical bisnis tertentu. Anda harus mengirimkan peristiwa yang disarankan beserta parameternya yang telah ditetapkan agar laporan Anda memiliki detail maksimum, serta agar fitur dan integrasi di masa mendatang dapat dimanfaatkan begitu tersedia. Bagian ini menunjukkan cara mencatat peristiwa yang telah ditentukan ke dalam log. Untuk mengetahui informasi lebih lanjut tentang cara mencatat peristiwa ke dalam log, baca artikel Mencatat peristiwa ke dalam log.

Kode berikut mencatat peristiwa SELECT_CONTENT ke dalam log 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 logging panjang untuk memantau pencatatan peristiwa ke dalam log oleh SDK guna membantu memastikan bahwa peristiwa dicatat ke dalam log dengan benar. Hal ini mencakup pencatatan peristiwa ke dalam log secara otomatis maupun manual.

Anda dapat mengaktifkan logging panjang 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 akan menampilkan peristiwa di logcat Android Studio, sehingga Anda dapat segera memastikan bahwa peristiwa memang benar dikirim.

Langkah berikutnya