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 membuat log 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 volume total peristiwa yang dicatat oleh aplikasi Anda. Perhatikan bahwa nama peristiwa peka terhadap 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 dalam Memulai Analytics .

Mencatat peristiwa

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

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

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

Contoh berikut menunjukkan cara mencatat peristiwa SELECT_CONTENT ke dalam log:

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

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 lebih baik direpresentasikan secara numerik. 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 pemirsa yang dapat diterapkan ke setiap laporan. Parameter khusus 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 .

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

Jika aplikasi Anda memiliki kebutuhan khusus yang tidak dicakup oleh jenis peristiwa yang disarankan, Anda dapat membuat log peristiwa khusus Anda sendiri seperti yang ditampilkan dalam contoh ini:

Kotlin+KTX

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

Java

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

Tetapkan parameter peristiwa default

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

Seperti parameter khusus, daftarkan parameter peristiwa default untuk memastikannya muncul di laporan Analytics.

Kotlin+KTX

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Java

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

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

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

Lihat peristiwa di log debug Android Studio

Anda dapat mengaktifkan logging panjang untuk memantau logging peristiwa oleh SDK untuk membantu memverifikasi bahwa peristiwa sedang dicatat dengan benar. Ini mencakup peristiwa yang dicatat secara otomatis dan 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 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 keluaran logcat seperti yang dijelaskan di bagian sebelumnya.

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