Google Analytics'i kullanmaya başlama

Bu hızlı başlangıç kılavuzunda, Google Analytics'i uygulamanıza nasıl ekleyeceğiniz ve etkinlikleri günlüğe kaydetmeye başlar.

Google Analytics, uygulamanız için kullanım ve davranış verilerini toplar. SDK günlüğe iki temel bilgi türü kaydeder:

  • Etkinlikler: Uygulamanızda neler olup bittiği. Örneğin, kullanıcı işlemleri, sistem veya veya hataları anlamına gelir.
  • Kullanıcı özellikleri: Kullanıcılarınızın segmentlerini tanımlamak için tanımladığınız özellikler (ör. dil tercihi veya coğrafi konum)

Analytics bazı verileri otomatik olarak günlüğe kaydeder events ve kullanıcı özellikleri; bunları etkinleştirmek için kod eklemeniz gerekmez.

Başlamadan önce

  1. Henüz yapmadıysanız Firebase'i Apple projenize ekleyin. Firebase'de Google Analytics'in etkin olduğundan emin olun. proje:

    • Yeni bir Firebase projesi oluşturuyorsanız Google Analytics'i etkinleştirin müzakere tekniği de eklediniz.

    • Güncelleme içermeyen mevcut bir Firebase projesi kullanıyorsanız Google Analytics'i etkinleştirdiyseniz, Entegrasyonlar sekmenizin > Proje ayarları'nı tıklayın.

    Projenizde Google Analytics'i etkinleştirdiğinizde Firebase uygulamalarınız Google Analytics veri akışlarına bağlıdır.

  2. (Önerilen). Reklamınıza AdSupport çerçevesini Proje projesinde yer alan bazı ayarlar da var.

Analytics SDK'sını uygulamanıza ekleyin

Firebase bağımlılıklarını yükleyip yönetmek için Swift Package Manager'ı kullanın.

  1. Xcode'da, uygulama projeniz açıkken Dosya > Paket Ekle'yi tıklayın.
  2. İstendiğinde Firebase Apple platformlar SDK deposunu ekleyin:
    3.   https://github.com/firebase/firebase-ios-sdk.git
    .
  3. Analytics kitaplığını seçin.
  4. -ObjC işaretini, hedefinizin derleme ayarlarındaki Diğer Bağlayıcı İşaretleri bölümüne ekleyin.
  5. En iyi Analytics deneyimi için Google Analytics'i etkinleştirme Firebase projenize ekleyin ve uygulamanıza Google Analytics için Firebase SDK'sını ekleyin. Şunları yapabilirsiniz: IDFA koleksiyonu olmayan veya IDFA koleksiyonu olan kitaplığı seçin.
  6. İşlemi tamamladığınızda, Xcode otomatik olarak arka planda tutmalarını sağlar.

Cihaz düzeyinde reklam kimliği olan IDFA hakkında daha fazla bilgiyi Apple'da bulabilirsiniz. Kullanıcı Gizliliği ve Veri Kullanımı ve Uygulama izleme şeffaflığı belgelerinden faydalanabilirsiniz.

Sonra, bazı yapılandırma adımlarını uygulayın:

  1. FirebaseCore modülünü UIApplicationDelegate ve diğer Yetki verdiğiniz uygulamanın kullandığı Firebase modülleri. Örneğin, Cloud Firestore ve Authentication'ı kullanmak için:

    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. Şunu yapılandır: FirebaseApp paylaşılan örneğinizin application(_:didFinishLaunchingWithOptions:) yöntemi:

    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. SwiftUI kullanıyorsanız bir uygulama temsilcisi oluşturup bunu eklemeniz gerekir App struct'ınıza UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor. Uygulama yetkisi kaydırmayı da devre dışı bırakmanız gerekir. Örneğin, daha fazla bilgi için SwiftUI talimatlarına bakın.

    SwiftUI

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}


(İsteğe bağlı) Apple reklam ağı ilişkilendirme kaydını devre dışı bırakın

Size kolaylık sağlamak için SDK, otomatik olarak kayıtlar ile reklam ağı ilişkilendirmesi için uygulamanızı Apple ile SKAdNetwork. Bu özelliği devre dışı bırakmak istiyorsanız GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED - NO (Boole) inç uygulamanızın info.plist dosyasına göz atın.

Etkinlikleri günlüğe kaydetmeye başla

FirebaseApp örneğini yapılandırdıktan sonra günlüğe kaydetmeye başlayabilirsiniz şunun olduğu etkinlikler: logEvent() yöntemidir.

Belirli etkinlikler tüm uygulamalar için önerilir; belirli işletme türleri veya sektörler için diğer öneriler önerilir. Göndermeniz gereken belgeler Böylece, önerilen etkinlikleri kendi belirlenen parametreleriyle birlikte kullanarak en yüksek düzeyde kullanılabilir ayrıntılara yer vermek ve gelecekte sunacağınız özelliklerden Google Analytics 360'ta kullanıma sunulur. Bu bölümde, önceden tanımlanmış bir etkinliktir. Etkinlikleri günlüğe kaydetme bölümüne göz atın.

Aşağıdaki örnekte, kullanıcı, uygulamanızdaki belirli bir öğeyi tıkladı:

Swift

Not: Bu Firebase ürünü, macOS hedefinde kullanılamıyor. 
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

Objective-C

Not: Bu Firebase ürünü, macOS hedefinde kullanılamıyor. 
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

Bu etkinliği Xcode hata ayıklama konsolunda görüntülemek için Analytics hata ayıklama özelliğini etkinleştirin:

  1. Xcode'da Product > Şema > Şemayı düzenle...
  2. Soldaki menüden Çalıştır'ı seçin.
  3. Bağımsız değişkenler sekmesini seçin.
  4. Lansmanda İletilen Bağımsız Değişkenler bölümüne -FIRAnalyticsDebugEnabled.

Sonraki adımlar