Bu hızlı başlangıç kılavuzunda, Google Analytics hizmetini uygulamanıza nasıl ekleyeceğiniz ve etkinlikleri günlüğe kaydetmeye başlar.
Google Analytics, uygulamanız için kullanım ve davranış verilerini toplar. SDK günlüğe iki tür bilgi kaydeder:
- Etkinlikler: Uygulamanızda neler olup bittiği. Örneğin, kullanıcı işlemleri, sistem veya veya hataları anlamına gelir.
- Kullanıcı özellikleri: Kullanıcılarınızın segmentlerini tanımlamak için tanımladığınız özellikler (ör. dil tercihi veya coğrafi konum)
Analytics, bazı işlemleri otomatik olarak günlüğe kaydeder events ve kullanıcı özellikleri; bunları etkinleştirmek için kod eklemeniz gerekmez.
Başlamadan önce
Henüz yapmadıysanız Firebase'i Apple projenize ekleyin. ve Firebase'de Google Analytics özelliğinin etkin olduğundan emin olun. proje:
Yeni bir Firebase projesi oluşturuyorsanız Google Analytics özelliğini etkinleştirin müzakere tekniği de eklediniz.
Güncelleme içermeyen mevcut bir Firebase projesi kullanıyorsanız Google Analytics etkin, şuraya gidin: Entegrasyonlar (
'nı tıklayın. ) > Proje ayarları
Projenizde Google Analytics eklentisini etkinleştirdiğinizde Firebase uygulamalarınız Google Analytics veri akışına bağlı.
(Önerilen). Reklamınıza AdSupport çerçevesini Proje projesinde yer alan birçok farklı veri türü vardır.
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, uygulama projeniz açıkken Dosya > Paket Ekle'yi tıklayın.
- İ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.- En iyi Analytics deneyimi için şunları öneririz: Google Analytics özelliğini etkinleştirme Firebase projenize ekleyin ve uygulamanıza Google Analytics için Firebase SDK'sını ekleyin. Şunları yapabilirsiniz: IDFA koleksiyonu olmayan veya IDFA koleksiyonu olan kitaplığı seçin.
- İşlemi tamamladığınızda, Xcode otomatik olarak arka planda tutmalarını sağlar.
https://github.com/firebase/firebase-ios-sdk.git
Cihaz düzeyinde reklam kimliği olan IDFA hakkında daha fazla bilgiyi Apple'da bulabilirsiniz. Kullanıcı Gizliliği ve Veri Kullanımı ve Uygulama izleme şeffaflığı belgelerinden faydalanabilirsiniz.
Sonra, bazı yapılandırma adımlarını uygulayın:
FirebaseCore
modülünüUIApplicationDelegate
ve diğer Yetki verdiğiniz uygulamanın kullandığı Firebase modülleri. Örneğin, Cloud Firestore ve Authentication özelliklerini 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; // ...
- Şunu yapılandır:
FirebaseApp
paylaşılan örneğinizinapplication(_:didFinishLaunchingWithOptions:)
yöntemi: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];
- SwiftUI kullanıyorsanız bir uygulama temsilcisi oluşturmanız ve bunu eklemeniz gerekir
App
struct'ınızaUIApplicationDelegateAdaptor
veyaNSApplicationDelegateAdaptor
. Uygulama yetkisi kaydırmayı da devre dışı bırakmanız gerekir. Örneğin, 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, otomatik olarak
kayıtlar
ile reklam ağı ilişkilendirmesi için uygulamanızı Apple ile
SKAdNetwork.
Bu özelliği devre dışı bırakmak istiyorsanız
GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
- NO
(Boole) inç
uygulamanızın info.plist dosyasına göz atın.
Etkinlikleri günlüğe kaydetmeye başla
FirebaseApp
örneğini yapılandırdıktan sonra günlüğe kaydetmeye başlayabilirsiniz
şunun olduğu etkinlikler:
logEvent()
yöntemidir.
Belirli etkinlikler tüm uygulamalar için önerilir; belirli işletme türleri veya sektörler için diğer öneriler önerilir. Göndermeniz gereken belgeler Böylece, önerilen etkinlikleri kendi belirlenen parametreleriyle birlikte kullanarak en yüksek düzeyde kullanılabilir ayrıntılara yer vermek ve gelecekte sunacağınız özelliklerden Google Analytics 360'ta kullanıma sunulur. Bu bölümde, önceden tanımlanmış bir etkinliktir. Etkinlikleri günlüğe kaydetme bölümüne göz atın.
Aşağıdaki örnekte, kullanıcı, uygulamanızdaki belirli bir öğeyi tıkladı:
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 Product > Şema > Şemayı düzenle...
- 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
.
Sonraki adımlar
- Tüm Analytics raporlarını anlayın.
- Etkinliklerinizi doğrulamak için DebugView'ı kullanın.
- Firebase konsolunda verilerinizi inceleyin.
- Etkinlikler ve özelliklerini ekleyin.
- Verilerinizi BigQuery'ye nasıl aktaracağınızı öğrenin.