Buat log kejadian

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

Google Analytics akan secara otomatis membuat log untuk peristiwa tertentu 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. Tidak ada batasan pada volume total peristiwa yang dicatat oleh aplikasi Anda ke dalam log. 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

Sebelum dapat menggunakan Google Analytics, Anda perlu:

• Mendaftarkan project Unity Anda dan mengonfigurasikannya untuk menggunakan Firebase.

  • Jika project Unity Anda telah menggunakan Firebase, berarti project tersebut telah terdaftar dan dikonfigurasi untuk Firebase.

  • Jika belum memiliki project Unity, Anda dapat mendownload aplikasi contoh.

• Menambahkan Firebase Unity SDK (khususnya, FirebaseAnalytics.unitypackage) ke project Unity Anda.

Temukan petunjuk detail seputar tugas penyiapan awal ini di artikel Menambahkan Firebase ke project Unity.

Perlu diperhatikan bahwa menambahkan Firebase ke project Unity Anda melibatkan tugas di Firebase console dan di project Unity yang terbuka (misalnya, Anda mendownload file konfigurasi Firebase dari konsol, lalu memindahkannya ke project Unity).

Membuat log peristiwa

Setelah menginisialisasi modul Firebase.Analytics.FirebaseAnalytics, Anda dapat menggunakannya untuk mencatat peristiwa ke dalam log dengan metode LogEvent().

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

Catatan: Untuk mendapatkan detail yang maksimal dalam laporan, buat log Peristiwa Analytics yang disarankan dan sesuai untuk aplikasi Anda, lengkap dengan parameter yang telah ditentukan. Hal ini juga memastikan bahwa Anda akan mendapatkan manfaat dari fitur Google Analytics terbaru saat tersedia.

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

• Peristiwa yang disarankan: lihat daftar konstanta Event.
• Parameter yang ditetapkan: lihat daftar konstanta Parameters.

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

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

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

• Parameter kustom: Parameter kustom tidak terwakili secara langsung dalam laporan Analytics Anda, tetapi dapat digunakan sebagai filter dalam definisi Audience yang dapat diterapkan pada setiap laporan. Parameter kustom juga tercakup dalam data yang yang diekspor ke BigQuery jika aplikasi Anda ditautkan ke project BigQuery.

• Parameter VALUE: VALUE adalah parameter bersifat umum yang berguna untuk mengumpulkan metrik utama yang terkait dengan Peristiwa Analytics. Contohnya meliputi pendapatan, jarak, waktu, dan poin.

Jika aplikasi Anda memiliki kebutuhan khusus yang tidak tercakup oleh jenis Peristiwa Analytics yang disarankan, Anda dapat membuat log Peristiwa Analytics khusus sendiri seperti yang ditunjukkan dalam contoh berikut:

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

Menampilkan peristiwa di output log

Android

Anda dapat mengaktifkan logging panjang di Android Studio Debug Log, untuk membantu memverifikasi bahwa log peristiwa dibuat dengan benar oleh SDK. Hal ini termasuk pembuatan log peristiwa 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 peristiwa di logcat Android Studio, sehingga membantu Anda untuk segera melakukan verifikasi bahwa peristiwa sedang dikirim.

iOS+

Peristiwa dimasukkan ke dalam log pada konsol, dan dapat dilihat saat menjalankan aplikasi melalui Xcode.

Melihat Peristiwa Analytics di dasbor

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

Untuk mengakses data ini di Firebase console:

1. Buka project Anda di Firebase console.
2. Pilih Analytics dari menu untuk melihat dasbor pelaporan Analytics.

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