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
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
sayfanızdaki > Proje ayarları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.
(Ö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.
- Xcode'da, uygulamanız açıkken File > Add Packages'a (Dosya > Paket Ekle) gidin.
- İstendiğinde Firebase Apple platformlar SDK deposunu ekleyin:
- Analytics kitaplığını seçin.
-ObjC
işaretini, hedefinizin derleme ayarlarındaki Diğer Bağlayıcı İşaretleri bölümüne ekleyin.- 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.
- İşlem tamamlandığında Xcode, arka planda bağımlılıklarınızı otomatik olarak çözümlemeye ve indirmeye başlar.
https://github.com/firebase/firebase-ios-sdk.git
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:
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; // ...
- Uygulama yetkilinizin
application(_:didFinishLaunchingWithOptions:)
yöntemindeFirebaseApp
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];
- SwiftUI kullanıyorsanız bir uygulama temsilcisi oluşturmanız ve
UIApplicationDelegateAdaptor
veyaNSApplicationDelegateAdaptor
aracılığıylaApp
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
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
Objective-C
[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ıklama özelliğini etkinleştirin:
- Xcode'da Ürün > Şema > Şemayı düzenle...'yi seçin.
- Soldaki menüden Çalıştır'ı seçin.
- Bağımsız değişkenler sekmesini seçin.
- Lansmanda İletilen Bağımsız Değişkenler bölümüne
-FIRAnalyticsDebugEnabled
ekleyin.
Sonraki adımlar
- Tüm Analytics raporlarını anlayın.
- Etkinliklerinizi doğrulamak için DebugView'ı kullanın.
- Firebase konsolunda verilerinizi keşfedin.
- Etkinlikler ve kullanıcı özellikleri ile ilgili rehberleri keşfedin.
- Verilerinizi BigQuery'ye nasıl aktaracağınızı öğrenin.