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

Catat acara

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Panduan ini menunjukkan cara mencatat peristiwa di aplikasi Anda.

Peristiwa memberikan wawasan tentang apa yang terjadi di aplikasi Anda, seperti tindakan pengguna, peristiwa sistem, atau kesalahan.

Analytics secara otomatis mencatat beberapa peristiwa untuk Anda; Anda tidak perlu menambahkan kode apa pun untuk menerimanya. Jika aplikasi Anda perlu mengumpulkan data tambahan, Anda dapat mencatat hingga 500 jenis Peristiwa Analytics yang berbeda di aplikasi Anda. Tidak ada batasan pada total volume peristiwa yang dicatat oleh aplikasi Anda. Perhatikan bahwa nama peristiwa peka huruf besar-kecil dan mencatat dua peristiwa yang namanya berbeda hanya dalam kasus akan menghasilkan dua peristiwa yang berbeda.

Sebelum kamu memulai

Pastikan Anda telah menyiapkan proyek dan dapat mengakses Analytics seperti yang dijelaskan di Memulai Analytics .

Catat acara

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

Untuk membantu Anda memulai, SDK Analytics menentukan sejumlah peristiwa yang direkomendasikan yang umum di antara berbagai jenis aplikasi, termasuk aplikasi ritel dan e-niaga, perjalanan, dan game. Untuk mempelajari lebih lanjut tentang acara ini dan kapan menggunakannya, lihat Acara yang direkomendasikan .

Anda dapat menemukan detail penerapan untuk jenis peristiwa yang direkomendasikan di lokasi berikut:

Contoh berikut menunjukkan cara mencatat peristiwa SELECT_CONTENT :

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

Selain parameter yang ditentukan, Anda dapat menambahkan parameter berikut ke peristiwa apa pun:

  • Parameter khusus: Parameter khusus dapat digunakan sebagai dimensi atau metrik dalam laporan Analytics . Anda dapat menggunakan dimensi khusus untuk data parameter peristiwa non-numerik dan metrik khusus untuk data parameter apa pun yang direpresentasikan secara numerik dengan lebih baik. Setelah Anda mencatat parameter khusus menggunakan SDK, daftarkan dimensi atau metrik untuk memastikan parameter khusus tersebut muncul di laporan Analytics. Lakukan ini melalui: Analytics > Peristiwa > Kelola Definisi Kustom > Buat Dimensi Kustom

    Parameter khusus dapat digunakan dalam definisi audiens yang dapat diterapkan ke setiap laporan. Parameter kustom juga disertakan dalam data yang diekspor ke BigQuery jika aplikasi Anda ditautkan ke project BigQuery. Temukan contoh kueri dan banyak lagi di Google Analytics 4 BigQuery Export .

  • Parameter VALUE : VALUE adalah parameter tujuan umum yang berguna untuk mengumpulkan metrik utama yang berkaitan dengan suatu peristiwa. Contohnya termasuk pendapatan, jarak, waktu, dan poin.

Jika aplikasi Anda memiliki kebutuhan khusus yang tidak tercakup oleh jenis peristiwa yang direkomendasikan, Anda dapat mencatat log peristiwa khusus Anda sendiri seperti yang ditunjukkan dalam contoh ini:

Java

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Kotlin+KTX

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}

Setel parameter acara default

Anda dapat mencatat parameter di seluruh peristiwa menggunakan setDefaultEventParameters . Parameter default dikaitkan dengan semua peristiwa mendatang yang dicatat.

Seperti halnya parameter khusus, daftarkan parameter peristiwa default untuk memastikan parameter tersebut muncul di laporan Analytics.

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

Kotlin+KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Jika parameter ditentukan dalam metode logEvent() , nilai tersebut akan digunakan sebagai ganti default.

Untuk menghapus parameter default, panggil metode setDefaultEventParameters dengan parameter yang disetel ke null .

Lihat acara di log debug Android Studio

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.

Lihat acara di dasbor

Anda dapat melihat statistik gabungan tentang peristiwa Anda di dasbor Firebase console. Dasbor ini diperbarui secara berkala sepanjang hari. Untuk pengujian langsung, gunakan output logcat seperti yang dijelaskan di bagian sebelumnya.

Anda dapat mengakses data ini dari dasbor Acara di Firebase console. Dasbor ini menampilkan laporan peristiwa yang dibuat secara otomatis untuk setiap jenis peristiwa berbeda yang dicatat oleh aplikasi Anda.