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

Memulai Google Analytics

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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

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

  • Peristiwa: Apa yang terjadi di aplikasi Anda, seperti tindakan pengguna, peristiwa sistem, atau kesalahan.
  • Properti pengguna: Atribut yang Anda tetapkan untuk menjelaskan segmen basis pengguna Anda, seperti preferensi bahasa atau lokasi geografis.

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

Sebelum kamu memulai

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

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

    • Jika Anda menggunakan proyek Firebase yang tidak mengaktifkan Google Analytics, buka tab Integrasi di Anda > Setelan proyek untuk mengaktifkannya.

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

  2. (Disarankan) . Tambahkan kerangka AdSupport ke proyek Anda untuk mengaktifkan fitur tambahan seperti atribusi audiens dan kampanye.

Tambahkan SDK Analytics ke aplikasi Anda

Gunakan Swift Package Manager untuk menginstal dan mengelola dependensi Firebase.

  1. Di Xcode, dengan proyek aplikasi Anda terbuka, arahkan ke File > Add Packages .
  2. Saat diminta, tambahkan repositori SDK platform Apple Firebase:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Pilih perpustakaan Analytics.
  5. Untuk pengalaman yang optimal dengan Analytics, sebaiknya aktifkan Google Analytics di proyek Firebase Anda dan tambahkan Firebase SDK untuk Google Analytics ke aplikasi Anda. Anda dapat memilih perpustakaan tanpa koleksi IDFA atau dengan koleksi IDFA.
  6. Setelah selesai, Xcode akan secara otomatis mulai menyelesaikan dan mengunduh dependensi Anda di latar belakang.

Pelajari lebih lanjut tentang IDFA, pengidentifikasi iklan tingkat perangkat, dalam dokumentasi Transparansi Pelacakan Aplikasi dan Penggunaan Data dan Privasi Pengguna Apple.

Selanjutnya, lakukan beberapa langkah konfigurasi:

  1. Impor modul FirebaseCore di UIApplicationDelegate Anda, serta 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
    // ...
          

    Cepat

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

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

    SwiftUI

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

    Cepat

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Jika Anda menggunakan SwiftUI, Anda harus membuat delegasi aplikasi dan melampirkannya ke struktur App Anda melalui UIApplicationDelegateAdaptor atau NSApplicationDelegateAdaptor . Anda juga harus menonaktifkan swizzling delegasi aplikasi. Untuk informasi selengkapnya, lihat 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) Nonaktifkan pendaftaran atribusi jaringan iklan Apple

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

Mulai mencatat peristiwa

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

Acara tertentu direkomendasikan untuk semua aplikasi ; lainnya direkomendasikan untuk jenis atau vertikal bisnis tertentu. Anda harus mengirimkan peristiwa yang disarankan beserta parameter yang ditentukan, untuk memastikan detail maksimum yang tersedia dalam laporan Anda dan untuk mendapatkan manfaat dari fitur dan integrasi mendatang saat tersedia. Bagian ini menunjukkan pembuatan log peristiwa yang ditentukan sebelumnya, untuk informasi lebih lanjut tentang pembuatan log peristiwa, lihat Log peristiwa .

Contoh berikut menunjukkan cara membuat log peristiwa yang disarankan untuk menunjukkan bahwa pengguna telah mengklik elemen tertentu di aplikasi Anda:

Cepat

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 di konsol debug Xcode, aktifkan proses debug Analytics:

  1. Di Xcode, pilih Produk > Skema > Edit skema...
  2. Pilih Jalankan dari menu sebelah kiri.
  3. Pilih tab Argumen .
  4. Di bagian Arguments Passed On Launch , tambahkan -FIRAnalyticsDebugEnabled .

Langkah selanjutnya

,

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

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

  • Peristiwa: Apa yang terjadi di aplikasi Anda, seperti tindakan pengguna, peristiwa sistem, atau kesalahan.
  • Properti pengguna: Atribut yang Anda tetapkan untuk menjelaskan segmen basis pengguna Anda, seperti preferensi bahasa atau lokasi geografis.

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

Sebelum kamu memulai

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

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

    • Jika Anda menggunakan proyek Firebase yang tidak mengaktifkan Google Analytics, buka tab Integrasi di Anda > Setelan proyek untuk mengaktifkannya.

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

  2. (Disarankan) . Tambahkan kerangka AdSupport ke proyek Anda untuk mengaktifkan fitur tambahan seperti atribusi audiens dan kampanye.

Tambahkan SDK Analytics ke aplikasi Anda

Gunakan Swift Package Manager untuk menginstal dan mengelola dependensi Firebase.

  1. Di Xcode, dengan proyek aplikasi Anda terbuka, arahkan ke File > Add Packages .
  2. Saat diminta, tambahkan repositori SDK platform Apple Firebase:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Pilih perpustakaan Analytics.
  5. Untuk pengalaman yang optimal dengan Analytics, sebaiknya aktifkan Google Analytics di proyek Firebase Anda dan tambahkan Firebase SDK untuk Google Analytics ke aplikasi Anda. Anda dapat memilih perpustakaan tanpa koleksi IDFA atau dengan koleksi IDFA.
  6. Setelah selesai, Xcode akan secara otomatis mulai menyelesaikan dan mengunduh dependensi Anda di latar belakang.

Pelajari lebih lanjut tentang IDFA, pengidentifikasi iklan tingkat perangkat, dalam dokumentasi Transparansi Pelacakan Aplikasi dan Penggunaan Data dan Privasi Pengguna Apple.

Selanjutnya, lakukan beberapa langkah konfigurasi:

  1. Impor modul FirebaseCore di UIApplicationDelegate Anda, serta 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
    // ...
          

    Cepat

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

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

    SwiftUI

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

    Cepat

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Jika Anda menggunakan SwiftUI, Anda harus membuat delegasi aplikasi dan melampirkannya ke struktur App Anda melalui UIApplicationDelegateAdaptor atau NSApplicationDelegateAdaptor . Anda juga harus menonaktifkan swizzling delegasi aplikasi. Untuk informasi selengkapnya, lihat 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) Nonaktifkan pendaftaran atribusi jaringan iklan Apple

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

Mulai mencatat peristiwa

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

Acara tertentu direkomendasikan untuk semua aplikasi ; lainnya direkomendasikan untuk jenis atau vertikal bisnis tertentu. Anda harus mengirimkan peristiwa yang disarankan beserta parameter yang ditentukan, untuk memastikan detail maksimum yang tersedia dalam laporan Anda dan untuk mendapatkan manfaat dari fitur dan integrasi mendatang saat tersedia. Bagian ini menunjukkan pembuatan log peristiwa yang ditentukan sebelumnya, untuk informasi lebih lanjut tentang pembuatan log peristiwa, lihat Log peristiwa .

Contoh berikut menunjukkan cara membuat log peristiwa yang disarankan untuk menunjukkan bahwa pengguna telah mengklik elemen tertentu di aplikasi Anda:

Cepat

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 di konsol debug Xcode, aktifkan proses debug Analytics:

  1. Di Xcode, pilih Produk > Skema > Edit skema...
  2. Pilih Jalankan dari menu sebelah kiri.
  3. Pilih tab Argumen .
  4. Di bagian Arguments Passed On Launch , tambahkan -FIRAnalyticsDebugEnabled .

Langkah selanjutnya