Buka konsol

Membuat log peristiwa

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.

Sebelum memulai

Jika ini pertama kalinya Anda menambahkan Analytics ke aplikasi, lakukan langkah-langkah berikut:

Hubungkan aplikasi Anda di Firebase console

  1. Instal Firebase SDK.
  2. Di Firebase console, tambahkan aplikasi Anda ke project Firebase.

Menambahkan Analytics ke aplikasi

  1. Tambahkan dependensi untuk Firebase ke Podfile Anda:
    pod 'Firebase/Analytics'
  2. Jalankan pod install dan buka file .xcworkspace yang dibuat.
  3. Impor modul Firebase di UIApplicationDelegate Anda:

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  4. Konfigurasikan instance bersama FirebaseApp, biasanya di metode application:didFinishLaunchingWithOptions: pada aplikasi Anda:

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];

Membuat log peristiwa

Setelah mengonfigurasi instance FirebaseApp, Anda dapat mulai mencatat peristiwa ke dalam log dengan metode logEventWithName().

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

Anda dapat menemukan informasi penerapan di lokasi berikut ini:

  • Peristiwa yang disarankan: lihat file header FIREventNames.h.
  • Parameter yang telah ditetapkan: lihat file header FIRParameterNames.h.

Contoh berikut menunjukkan cara mencatat peristiwa kFIRSelectContent yang disarankan ke dalam log:

Swift

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 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 kFIRParameterValue: kFIRParameterValue adalah parameter bertujuan umum yang berguna untuk mengumpulkan metrik utama yang berkaitan dengan peristiwa. Contohnya termasuk pendapatan, jarak, waktu, dan poin.

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

Swift

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
                                 }];

Melihat peristiwa dalam konsol debug Xcode

Anda dapat mengaktifkan pencatatan log yang mendetail untuk memantau pencatatan peristiwa ke dalam log oleh SDK, untuk membantu memverifikasi bahwa peristiwa sedang dicatat ke dalam log dengan benar. Hal ini meliputi peristiwa yang dicatat ke dalam log secara otomatis maupun manual.

Anda dapat mengaktifkan pencatatan ke dalam log secara mendetail sebagai berikut:

  1. Di Xcode, pilih Product > Scheme > Edit scheme...
  2. Pilih Run dari menu di sebelah kiri.
  3. Pilih tab Arguments.
  4. Di bagian Arguments Passed On Launch, tambahkan -FIRAnalyticsDebugEnabled.

Saat Anda menjalankan aplikasi kembali, peristiwa akan ditampilkan di konsol debug Xcode, sehingga membantu memverifikasi bahwa peristiwa tersebut sedang dikirim.

Melihat peristiwa di dasbor

Anda bisa melihat statistik gabungan tentang peristiwa Analytics di dasbor Firebase console. Dasbor ini diupdate secara berkala sepanjang hari. Untuk melakukan pengujian langsung, gunakan output konsol debug 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 Analytics berbeda yang dicatat ke dalam log oleh aplikasi Anda. Baca lebih lanjut mengenai dasbor pelaporan Analytics di Pusat Bantuan Firebase.