了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

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ız için kullanım ve davranış verilerini toplar. SDK, iki temel bilgi türünü günlüğe kaydeder:

  • Olaylar: Kullanıcı eylemleri, sistem olayları veya hatalar gibi uygulamanızda olup bitenler.
  • 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 öznitelikler.

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

Sen başlamadan önce

  1. Henüz yapmadıysanız Apple projenize Firebase 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 projesi kullanıyorsanız, etkinleştirmek için Entegrasyonlar sekmesine > 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. (Önerilir) . 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ı kurmak ve yönetmek için Swift Paket Yöneticisi'ni kullanın.

  1. Xcode'da, uygulama projeniz açıkken File > Add Packages seçeneğine gidin.
  2. İstendiğinde, Firebase Apple platformları SDK deposunu ekleyin:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Analytics kitaplığını seçin.
  4. Analytics ile optimum bir deneyim için, Firebase projenizde Google Analytics'i etkinleştirmenizi ve Google Analytics için Firebase SDK'sını uygulamanıza eklemenizi öneririz. Kütüphaneyi IDFA koleksiyonu olmadan veya IDFA koleksiyonu ile seçebilirsiniz.
  5. Bittiğinde, Xcode otomatik olarak arka planda bağımlılıklarınızı çö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ısı olan IDFA hakkında daha fazla bilgi edinin.

Ardından, bazı yapılandırma adımlarını gerçekleştirin:

  1. UIApplicationDelegate uygulamanıza FirebaseCore modülünü ve uygulama temsilcinizin kullandığı diğer Firebase modüllerini içe 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 bir FirebaseApp paylaşılan örneği 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. Uygulama temsilcisi swizzling'i 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, uygulamanızı SKAdNetwork ile reklam ağı ilişkilendirmesi için Apple'a otomatik olarak 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şla

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 maksimum kullanılabilir ayrıntı sağlamak ve kullanıma sunuldukça gelecekteki özelliklerden ve entegrasyonlardan yararlanmak için önerilen etkinlikleri belirtilen 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ı günlüğe kaydetme.

Aşağıdaki örnek, 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ğ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",
])
ViewController.swift

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"
                                 }];
ViewController.m

Bu olayı 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... öğesini 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 Geçirilen Argümanlar bölümünde, -FIRAnalyticsDebugEnabled ekleyin.

Sonraki adımlar