Google Analytics'i kullanmaya başlama

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

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

  • Etkinlikler: Kullanıcı eylemleri, sistem etkinlikleri veya hatalar gibi uygulamanızda olup bitenler.
  • Kullanıcı özellikleri: Dil tercihi veya coğrafi konum gibi kullanıcı tabanınızın bölümlerini 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 eklemenize gerek yoktur.

Sen başlamadan önce

  1. Henüz yapmadıysanız Apple projenize Firebase'i 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 etkin olmadığı mevcut bir Firebase projesini kullanıyorsanız uygulamanızın Entegrasyonlar sekmesine gidin. etkinleştirmek için > Proje ayarları'na gidin.

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

  2. (Tavsiye edilen) . Hedef kitleler ve kampanya ilişkilendirme 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üklemek ve yönetmek için Swift Paket Yöneticisini kullanın.

  1. Xcode'da uygulama projeniz 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 bayrağını hedefinizin derleme ayarlarının Diğer Bağlayıcı Bayrakları bölümüne ekleyin.
  6. 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 koleksiyonu olmayan veya IDFA koleksiyonu olan kütüphaneyi seçebilirsiniz.
  7. Bitirdiğinizde Xcode, bağımlılıklarınızı arka planda otomatik olarak çözmeye ve indirmeye başlayacaktır.

Apple'ın Kullanıcı Gizliliği ve Veri Kullanımı ve Uygulama İzleme Şeffaflığı belgelerinde cihaz düzeyinde reklam tanımlayıcı olan IDFA hakkında daha fazla bilgi edinin.

Daha sonra bazı yapılandırma adımlarını gerçekleştirin:

  1. FirebaseCore modülünü UIApplicationDelegate ve uygulama temsilcinizin kullandığı diğer Firebase modüllerine aktarın. Örneğin, Cloud Firestore ve Authentication'ı kullanmak için:

    SwiftUI

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

    Süratli

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Amaç-C

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

    SwiftUI

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

    Süratli

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

    Amaç-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. SwiftUI kullanıyorsanız, bir uygulama temsilcisi oluşturmalı ve bunu UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor aracılığıyla App yapınıza eklemelisiniz. Ayrıca uygulama temsilcisinin swizzling özelliğini de devre dışı bırakmalısınız. 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, SKAdNetwork ile reklam ağı ilişkilendirmesi için uygulamanızı otomatik olarak Apple'a kaydeder . 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 (Boolean) olarak ayarlayın.

Olayları günlüğe kaydetmeye başlayın

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

Tüm uygulamalar için belirli etkinlikler önerilir ; diğerleri belirli iş türleri veya sektörler için önerilir. Raporlarınızda mümkün olan maksimum ayrıntıyı sağlamak ve gelecekte kullanıma sunulacak özelliklerden ve entegrasyonlardan yararlanmak için, önerilen etkinlikleri önceden belirlenmiş parametrelerle birlikte göndermelisiniz. Bu bölümde önceden tanımlanmış bir olayın günlüğe kaydedilmesi gösterilmektedir; olayların günlüğe kaydedilmesi hakkında daha fazla bilgi için bkz . Olayların günlüğe kaydedilmesi .

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

Süratli

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

Amaç-C

Not: Bu Firebase ürünü macOS hedefinde mevcut değildir.
[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... seçeneğini seçin.
  2. Soldaki menüden Çalıştır'ı seçin.
  3. Bağımsız Değişkenler sekmesini seçin.
  4. Başlatma Sırasında Aktarılan Bağımsız Değişkenler bölümüne -FIRAnalyticsDebugEnabled ekleyin.

Sonraki adımlar