Google Analytics'i kullanmaya başlama

Bu hızlı başlangıç kılavuzu, Google Analytics'i uygulamanıza nasıl ekleyeceğinizi ve etkinlikleri günlüğe nasıl kaydetmeye başlayacağınızı gösterir.

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

  • Etkinlikler: Uygulamanızda olup bitenler (ör. kullanıcı işlemleri, sistem etkinlikleri veya hatalar)
  • Kullanıcı özellikleri: Dil tercihi veya coğrafi konum gibi kullanıcı tabanınızın segmentlerini tanımlamak için tanımladığınız özellikler.

Analytics bazı etkinlikleri ve kullanıcı özelliklerini otomatik olarak günlüğe kaydeder. Bunları etkinleştirmek için herhangi bir kod eklemeniz gerekmez.

Başlamadan önce

  1. Henüz yapmadıysanız Firebase'i Apple projenize ekleyin ve Firebase projenizde Google Analytics'in etkinleştirildiğinden emin olun:

    • Yeni bir Firebase projesi oluşturuyorsanız proje oluşturma iş akışı sırasında Google Analytics'i etkinleştirin.

    • Google Analytics'in etkinleştirilmediği mevcut bir Firebase projesini kullanıyorsanız > Proje ayarları sayfanızdaki Entegrasyonlar sekmesine giderek projeyi etkinleştirin.

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

  2. (Önerilen). Kitleler ve kampanya ilişkilendirmesi gibi ek özellikleri etkinleştirmek için projenize AdSupport çerçevesini ekleyin.

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, uygulamanız açıkken File > Add Packages'a (Dosya > Paket Ekle) gidin.
  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. Optimum Analytics deneyimi için Firebase projenizde Google Analytics'i etkinleştirmenizi ve Google Analytics için Firebase SDK'sını uygulamanıza eklemenizi öneririz. IDFA toplama olmayan veya IDFA toplamalı kitaplığı seçebilirsiniz.
  6. İşlem tamamlandığında Xcode, arka planda bağımlılıklarınızı otomatik olarak çözümlemeye ve indirmeye başlar.

Apple'ın Kullanıcı Gizliliği ve Veri Kullanımı ve Uygulama Takibi Şeffaflığı belgelerinde cihaz düzeyinde reklam kimliği olan IDFA hakkında daha fazla bilgi edinebilirsiniz.

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

  1. FirebaseCore modülünü UIApplicationDelegate uygulamanıza ve yetki verdiğiniz kullanıcının kullandığı diğer tüm Firebase modüllerini içe aktarın. Örneğin, Cloud Firestore ve Authentication'ı kullanmak için:

    Hızlı Kullanıcı Arayüzü

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

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Uygulama yetkilinizin application(_:didFinishLaunchingWithOptions:) yönteminde FirebaseApp paylaşılan bir örnek yapılandırın:

    Hızlı Kullanıcı Arayüzü

    // 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şturmanız ve UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor aracılığıyla App yapınıza eklemeniz gerekir. Uygulama yetkilendirmesi kaydırmayı da devre dışı bırakmanız gerekir. Daha fazla bilgi için SwiftUI talimatlarına bakın.

    Hızlı Kullanıcı Arayüzü

    @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

SDK, size kolaylık sağlamak amacıyla uygulamanızı SKAdNetwork ile reklam ağı ilişkilendirmesi için otomatik olarak Apple'a kaydettir. Bu özelliği devre dışı bırakmak istiyorsanız uygulamanızın info.plist dosyasında GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED değerini NO (Boole) olarak ayarlayın.

Etkinlikleri günlüğe kaydetmeye başla

FirebaseApp örneğini yapılandırdıktan sonra etkinlikleri logEvent() yöntemiyle günlüğe kaydetmeye başlayabilirsiniz.

Bazı etkinlikler tüm uygulamalar için önerilir, bazıları ise belirli işletme türleri veya sektörler için önerilir. Raporlarınızda maksimum sayıda kullanılabilir ayrıntı sağlamak ve kullanıma sunulacak özellikler ile entegrasyonlardan yararlanmak için, önerilen etkinlikleri belirlenen parametreleriyle birlikte göndermeniz gerekir. Bu bölümde, önceden tanımlanmış bir etkinliğin günlüğe kaydedilmesi gösterilmektedir. Etkinlikleri günlüğe kaydetme hakkında daha fazla bilgi için Etkinlikleri günlüğe kaydetme bölümüne bakın.

Aşağıdaki örnekte, bir kullanıcının uygulamanızdaki belirli bir öğeyi tıkladığını belirtmek için önerilen bir etkinliğin nasıl günlüğe kaydedileceği gösterilmektedir:

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 Ürün > Şema > Şemayı düzenle...'yi seçin.
  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 ekleyin.

Sonraki adımlar