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

Mencatat peristiwa ke dalam log

Panduan ini menunjukkan cara mencatat peristiwa ke dalam log pada aplikasi Anda.

Peristiwa memberikan data terkait hal yang terjadi dalam aplikasi Anda, seperti tindakan pengguna, peristiwa sistem, atau error.

Analytics otomatis mencatat sejumlah peristiwa ke dalam log. Anda tidak perlu menambahkan kode apa pun untuk menerimanya. Jika aplikasi perlu mengumpulkan data tambahan, Anda dapat mencatat hingga 500 jenis Peristiwa Analytics yang berbeda ke dalam log di aplikasi. Tidak ada batasan volume total peristiwa yang dicatat oleh aplikasi ke dalam log. Perlu diperhatikan bahwa nama peristiwa peka huruf besar/kecil, sehingga pencatatan dua peristiwa ke dalam log 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 artikel Memulai Analytics.

Mencatat peristiwa ke dalam log

Setelah mengonfigurasi instance firebase.analytics(), Anda dapat mulai mencatat peristiwa ke dalam log dengan metode logEvent(). Jika Anda sudah terbiasa dengan Google Analytics, metode ini sama dengan menggunakan perintah event di gtag.js.

Untuk membantu Anda memulai, Analytics SDK menetapkan sejumlah peristiwa yang disarankan yang biasa dipakai berbagai jenis aplikasi, termasuk aplikasi retail dan e-commerce, perjalanan, dan game. Untuk mempelajari peristiwa ini lebih lanjut dan waktu penggunaannya, baca artikel Peristiwa dan properti di Pusat Bantuan Firebase.

Catatan: Untuk mendapatkan informasi sedetail mungkin dalam laporan, lakukan pencatatan log untuk peristiwa yang disarankan dan sesuai untuk aplikasi Anda beserta parameternya yang ditetapkan. Tindakan ini juga akan memastikan bahwa Anda bisa menikmati fitur Google Analytics terbaru saat tersedia.

Anda dapat menemukan detail penerapan untuk beberapa peristiwa dan parameternya di referensi peristiwa gtag.js.

Contoh berikut menunjukkan cara mencatat peristiwa select_content ke dalam log:

Web versi 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

Web versi 8

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

Selain parameter yang 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 ditautkan ke project BigQuery.
  • Parameter value: value adalah parameter bersifat umum yang berguna untuk mengumpulkan metrik kunci yang berkaitan dengan peristiwa. Contohnya meliputi pendapatan, jarak, waktu, dan poin.

Jika aplikasi Anda memiliki kebutuhan spesifik yang tidak tercakup dalam jenis peristiwa yang disarankan, Anda dapat mencatat peristiwa kustom Anda sendiri ke dalam log. Misalnya, jika mengembangkan game dan ingin melacak saat pemain menyelesaikan sasaran tertentu, Anda dapat mencatat peristiwa ke dalam log seperti contoh berikut:

Web versi 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});

Web versi 8

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

Melihat peristiwa di dasbor

Statistik gabungan terkait peristiwa Anda dapat dilihat 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 Peristiwa di Firebase console. Dasbor ini menunjukkan laporan peristiwa yang dibuat secara otomatis untuk setiap jenis peristiwa berbeda yang dicatat ke dalam log oleh aplikasi Anda.