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
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.
(Ö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.
- Xcode'da, uygulama projeniz açıkken File > Add Packages seçeneğine gidin.
- İstendiğinde, Firebase Apple platformları SDK deposunu ekleyin:
- Analytics kitaplığını seçin.
- 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.
- Bittiğinde, Xcode otomatik olarak arka planda bağımlılıklarınızı çözmeye ve indirmeye başlayacaktır.
https://github.com/firebase/firebase-ios-sdk
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:
-
UIApplicationDelegate
uygulamanızaFirebaseCore
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; // ...
- Uygulama temsilcinizin
application(_:didFinishLaunchingWithOptions:)
yönteminde birFirebaseApp
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];
- SwiftUI kullanıyorsanız, bir uygulama temsilcisi oluşturmalı ve bunu
UIApplicationDelegateAdaptor
veyaNSApplicationDelegateAdaptor
aracılığıylaApp
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
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
Amaç-C
[FIRAnalytics logEventWithName:kFIREventSelectContent parameters:@{ kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title], kFIRParameterItemName:self.title, kFIRParameterContentType:@"image" }];
Bu olayı Xcode hata ayıklama konsolunda görüntülemek için Analytics hata ayıklamasını etkinleştirin:
- Xcode'da Ürün > Şema > Şemayı düzenle... öğesini seçin.
- Soldaki menüden Çalıştır'ı seçin.
- Bağımsız Değişkenler sekmesini seçin.
- Başlatma Sırasında Geçirilen Argümanlar bölümünde,
-FIRAnalyticsDebugEnabled
ekleyin.
Sonraki adımlar
- Olaylarınızı doğrulamak için DebugView'ı kullanın.
- Verilerinizi Firebase konsolunda keşfedin.
- Olaylar ve kullanıcı özellikleriyle ilgili kılavuzları keşfedin.
- Verilerinizi BigQuery'ye nasıl aktaracağınızı öğrenin .