Memulai Google Analytics

Panduan memulai ini menunjukkan cara menambahkan Google Analytics ke aplikasi Anda dan mulai mencatat peristiwa ke dalam log.

Google Analytics mengumpulkan data penggunaan dan perilaku untuk aplikasi Anda. SDK mencatat dua jenis informasi utama ke dalam log:

  • Peristiwa: Hal-hal yang terjadi dalam aplikasi Anda, seperti tindakan pengguna, peristiwa sistem, atau error.
  • Properti pengguna: Atribut yang Anda tentukan untuk mendeskripsikan segmen basis pengguna, seperti preferensi bahasa atau lokasi geografis.

Analytics secara otomatis mencatat beberapa peristiwa dan properti pengguna ke dalam log. Anda tidak perlu menambahkan kode apa pun untuk mengaktifkannya.

Sebelum memulai

  1. Jika belum melakukannya, tambahkan Firebase ke project Apple Anda dan pastikan bahwa Google Analytics sudah diaktifkan di project Firebase Anda:

    • Jika Anda membuat project Firebase baru, aktifkan Google Analytics selama alur kerja pembuatan project.

    • Jika Anda menggunakan project Firebase yang sudah ada dan belum mengaktifkan Google Analytics, buka tab Integrations di bagian > Project settings untuk mengaktifkannya.

    Saat Anda mengaktifkan Google Analytics di project, aplikasi Firebase Anda akan ditautkan ke aliran data Google Analytics.

  2. (Direkomendasikan). Tambahkan framework AdSupport ke project Anda untuk mengaktifkan fitur tambahan, seperti atribusi kampanye dan audience.

Menambahkan Analytics SDK ke aplikasi

Gunakan Swift Package Manager untuk menginstal dan mengelola dependensi Firebase.

  1. Di Xcode, dengan project aplikasi Anda dalam keadaan terbuka, buka File > Add Packages.
  2. Saat diminta, tambahkan repositori SDK platform Apple Firebase:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Pilih library Analytics.
  5. Untuk mengoptimalkan penggunaan Analytics, sebaiknya aktifkan Google Analytics di project Firebase Anda dan tambahkan Firebase SDK untuk Google Analytics ke aplikasi Anda. Anda dapat memilih library tanpa atau dengan pengumpulan IDFA.
  6. Setelah selesai, Xcode akan otomatis mulai me-resolve dan mendownload dependensi Anda di latar belakang.

Pelajari lebih lanjut IDFA, ID iklan tingkat perangkat, dalam dokumentasi Privasi Pengguna dan Penggunaan Data dan App Tracking Transparency Apple.

Selanjutnya, lakukan beberapa langkah konfigurasi:

  1. Impor modul FirebaseCore dalam UIApplicationDelegate Anda, serta semua modul Firebase lainnya yang digunakan oleh delegasi aplikasi Anda. Misalnya, untuk menggunakan Cloud Firestore dan Authentication:

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Swift

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Konfigurasikan instance bersama FirebaseApp di metode application(_:didFinishLaunchingWithOptions:) delegasi aplikasi Anda:

    SwiftUI

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

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Jika menggunakan SwiftUI, Anda harus membuat delegasi aplikasi dan menambahkannya ke struct App melalui UIApplicationDelegateAdaptor atau NSApplicationDelegateAdaptor. Anda juga harus menonaktifkan swizzling delegasi aplikasi. Untuk mengetahui informasi lebih lanjut, baca petunjuk SwiftUI.

    SwiftUI

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          


(Opsional) Menonaktifkan pendaftaran atribusi jaringan iklan Apple

Untuk memudahkan Anda, SDK ini otomatis mendaftarkan aplikasi Anda ke Apple untuk atribusi jaringan iklan dengan SKAdNetwork. Jika ingin menonaktifkan fitur ini, tetapkan nilai GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED ke NO (Boolean) di file info.plist aplikasi Anda.

Mulai mencatat peristiwa ke dalam log

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

Peristiwa tertentu direkomendasikan untuk semua aplikasi, sedangkan peristiwa yang lain direkomendasikan untuk jenis atau vertical bisnis tertentu. Anda sebaiknya mengirimkan peristiwa yang disarankan beserta parameternya yang telah ditetapkan agar laporan Anda memiliki detail maksimum, serta agar fitur dan integrasi di masa mendatang dapat dimanfaatkan begitu tersedia. Bagian ini menunjukkan cara mencatat peristiwa yang telah ditentukan ke dalam log. Untuk mengetahui informasi lebih lanjut tentang cara mencatat peristiwa ke dalam log, baca artikel Mencatat peristiwa ke dalam log.

Contoh berikut menunjukkan cara mencatat peristiwa yang direkomendasikan ke dalam log untuk menandakan bahwa pengguna telah mengklik elemen tertentu di aplikasi Anda:

Swift

Catatan: Produk Firebase ini tidak tersedia di target macOS.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Objective-C

Catatan: Produk Firebase ini tidak tersedia di target macOS.
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

Untuk melihat peristiwa ini dalam konsol debug Xcode, aktifkan proses debug Analytics:

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

Langkah berikutnya