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

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 mengonfigurasi instance FirebaseApp , Anda dapat mulai 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 implementasi dalam referensi konstanta untuk Swift dan Objective-C .

Contoh berikut menunjukkan cara mencatat peristiwa kFIRSelectContent yang direkomendasikan:

Cepat

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Objective-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"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 .

  • kFIRParameterValue parameter: kFIRParameterValue 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 tercakup oleh jenis peristiwa yang direkomendasikan, Anda dapat mencatat log peristiwa khusus Anda sendiri seperti yang ditunjukkan dalam contoh ini:

Cepat

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"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 khusus tersebut muncul di laporan Analytics.

Cepat

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Objective-C

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

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 nil .

Lihat acara di konsol debug Xcode

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 logging verbose sebagai berikut:

  1. Di Xcode, pilih Produk > Skema > Edit skema...
  2. Pilih Jalankan dari menu sebelah kiri.
  3. Pilih tab Argumen .
  4. Di bagian Argumen yang Disampaikan Saat Peluncuran , tambahkan -FIRAnalyticsVerboseLoggingEnabled .

Saat berikutnya Anda menjalankan aplikasi, acara Anda akan ditampilkan di konsol debug Xcode, 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.