Buka konsol

Mencatat peristiwa ke dalam log

Peristiwa memberikan laporan mengenai apa yang terjadi dalam aplikasi Anda, seperti tindakan pengguna, peristiwa sistem, atau error.

Analytics secara otomatis mencatat beberapa peristiwa ke dalam log 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 ke dalam log di aplikasi tersebut. Tidak ada batasan pada volume total peristiwa yang dicatat ke dalam log oleh aplikasi Anda. Perlu diperhatikan bahwa nama peristiwa peka huruf besar/kecil, sehingga logging dua peristiwa dengan nama yang sama tetapi susunan huruf kapitalnya berbeda akan menghasilkan dua peristiwa yang berbeda pula.

Sebelum memulai

Pastikan Anda telah menyiapkan project dan dapat mengakses Analytics seperti yang dijelaskan dalam Memulai dengan Analytics untuk Android.

Mencatat peristiwa ke dalam log

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

Untuk membantu Anda memulai, Analytics SDK menetapkan sejumlah peristiwa umum yang disarankan di antara berbagai jenis aplikasi, termasuk aplikasi retail dan ecommerce, perjalanan, serta game. Untuk mempelajari peristiwa ini lebih lanjut dan kapan menggunakannya, baca artikel Peristiwa dan properti di Pusat Bantuan Firebase.

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

Contoh berikut menunjukkan cara mencatat Peristiwa SELECT_CONTENT yang disarankan ke dalam log:

Java
Android

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
Android

val bundle = Bundle()
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id)
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name)
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle)

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

  • Parameter kustom: Parameter kustom dapat didaftarkan untuk pelaporan dalam laporan Analytics Anda. Parameter ini juga dapat digunakan sebagai filter dalam definisi audience yang dapat diterapkan pada setiap laporan. Parameter kustom juga tercakup dalam data yang diekspor ke BigQuery jika aplikasi Anda dihubungkan ke project BigQuery.

  • Parameter VALUE: VALUE adalah parameter bersifat umum yang berguna untuk mengumpulkan metrik kunci yang terkait dengan peristiwa. Contohnya termasuk pendapatan, jarak, waktu, dan poin.

Jika aplikasi Anda memiliki kebutuhan spesifik yang tidak tercakup dalam jenis peristiwa yang disarankan, Anda dapat mencatat peristiwa kustom sendiri ke dalam log seperti yang ditunjukkan dalam contoh berikut:

Java
Android

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

Kotlin
Android

val params = Bundle()
params.putString("image_name", name)
params.putString("full_text", text)
firebaseAnalytics.logEvent("share_image", params)

Melihat peristiwa dalam log debug Android Studio

Anda dapat mengaktifkan logging mendetail untuk memantau pencatatan peristiwa ke dalam log oleh SDK dan 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 mendetail 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 dapat segera dipastikan bahwa peristiwa sedang dikirim.

Melihat peristiwa di dasbor

Statistik gabungan terkait peristiwa Anda dapat dilihat di dasbor Firebase console. Dasbor ini diupdate secara berkala sepanjang hari. Untuk melakukan pengujian langsung, gunakan output logcat seperti yang dijelaskan di bagian sebelumnya.

Anda dapat mengakses data ini di Firebase console sebagai berikut:

  1. Di Firebase console, buka project Anda.
  2. Pilih Analytics dari menu untuk melihat dasbor pelaporan Analytics.

Tab Peristiwa menampilkan laporan peristiwa yang dibuat secara otomatis untuk setiap jenis peristiwa berbeda yang dicatat ke dalam log oleh aplikasi Anda. Baca lebih lanjut mengenai dasbor pelaporan Analytics di Pusat Bantuan Firebase.