Google Analytics'i kullanmaya başlama


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

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

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

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'nin etkinleştirildiğinden emin olun:

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

    • Google Analytics etkinleştirilmemiş mevcut bir Firebase projesi kullanıyorsanız 'ü etkinleştirmek için > Proje ayarları bölümündeki Entegrasyonlar sekmesine gidin.

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

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

Analytics SDK'sını uygulamanıza ekleme

Firebase bağımlılarını yüklemek ve yönetmek için Swift Package Manager'ı kullanın.

Firebase SDK'larını Apple projenize eklemenin farklı yolları (ör. doğrudan çerçeveleri içe aktarma ve CocoaPods kullanma) hakkında bilgi edinmek için
  1. Xcode'da, uygulamanız açıkken Dosya > Paket Ekle'ye gidin.
  2. İstendiğinde Firebase Apple platformları SDK deposunu ekleyin:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Analytics kitaplığını seçin.
  5. -ObjC işaretini, hedefinizin derleme ayarlarının Diğer Bağlantı Oluşturucu İşaretleri bölümüne ekleyin.
  6. Analytics ile en iyi deneyimi yaşamak için Firebase projenizde Google Analytics'i etkinleştirmenizi ve Google Analytics için Firebase SDK'sını uygulamanıza eklemenizi öneririz. IDFA koleksiyonu olmayan veya IDFA koleksiyonu olan kitaplığı seçebilirsiniz.
  7. İşlem tamamlandığında Xcode, arka planda bağımlılarınızı otomatik olarak çözümlemeye ve indirmeye başlar.

Cihaz düzeyinde reklam kimliği olan IDFA hakkında daha fazla bilgiyi Apple'ın Kullanıcı Gizliliği ve Veri Kullanımı ile Uygulama İzleme Şeffaflığı dokümanlarından edinebilirsiniz.

Ardından, bazı yapılandırma adımlarını uygulayın:

  1. FirebaseCore modülünü ve uygulama temsilcinizin kullandığı diğer tüm Firebase modüllerini UIApplicationDelegate dosyanıza aktarın. Ö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. Uygulama temsilcinizin application(_:didFinishLaunchingWithOptions:) yönteminde bir FirebaseApp shared instance yapılandırın:

    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şturmanız ve UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor aracılığıyla App yapınıza eklemeniz gerekir. Ayrıca uygulama temsilcisi değiştirme işlemini de devre dışı bırakmanız gerekir. 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ırakma

Size kolaylık sağlamak için SDK, SKAdNetwork ile reklam ağı ilişkilendirmesi için uygulamanızı Apple'a otomatik olarak kaydettirir. 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şlama

FirebaseApp örneğini yapılandırdıktan sonra logEvent() yöntemiyle etkinlikleri 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 düzeyde ayrıntı elde etmek ve kullanıma sunulan yeni özellikler ile entegrasyonlardan yararlanmak için önerilen etkinlikleri kendi belirlenen parametreleriyle 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 başlıklı makaleyi inceleyin.

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

Swift

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

Objective-C

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

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

  1. Xcode'da Ürün > Şema > Şemayı düzenle...'yi seçin.
  2. Sol menüden Çalıştır'ı seçin.
  3. Argumentler sekmesini seçin.
  4. Başlatmada İletilen Parametreler bölümünde -FIRAnalyticsDebugEnabled ekleyin.

Sonraki adımlar