iOS+ için Google Analytics'i kullanmaya başlama

Platform seçin: iOS+ Android Web Flutter Unity C++


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

Google Analytics, uygulamanız için kullanım ve davranış verilerini toplar. SDK, iki temel bilgi türünü günlüğe kaydeder:

  • Etkinlikler: Kullanıcı işlemleri, sistem etkinlikleri veya hatalar gibi uygulamanızda neler olduğu.
  • Kullanıcı özellikleri: Kullanıcı tabanınızın segmentlerini tanımlamak için belirlediğiniz özelliklerdir (ör. dil tercihi veya coğrafi konum).

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

  1. Henüz yapmadıysanız Firebase'i Apple projenize ekleyin ve Firebase projenizde Google Analytics özelliğinin etkinleştirildiğinden emin olun:

    • Yeni bir Firebase projesi oluşturuyorsanız proje oluşturma iş akışı sırasında Google Analytics hizmetini etkinleştirin.

    • Google Analytics etkinleştirilmemiş mevcut bir Firebase projesi kullanıyorsanız Ayarlar > Entegrasyonlar sekmesinde etkinleştirebilirsiniz.

    Projenizde Google Analytics hizmetini 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ı yüklemek ve yönetmek için Swift Package Manager'ı kullanın.

Firebase SDK'larını Apple projenize eklemenin farklı yollarını öğrenmek için
  1. Xcode'da uygulama projeniz açıkken File > Add Packages'a (Dosya > Paket Ekle) gidin.
  2. İstendiğinde Firebase Apple platformları SDK deposunu ekleyin:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Analytics kitaplığını seçin.
  4. Hedefinizin derleme ayarlarının Other Linker Flags (Diğer Bağlayıcı İşaretleri) bölümüne -ObjC işaretini ekleyin.
  5. Analytics ile en iyi deneyimi yaşamak için Firebase projenizde Google Analytics etkinleştirmenizi ve Google Analytics için Firebase SDK'sını uygulamanıza eklemenizi öneririz. IDFA toplama özelliği olan veya olmayan kitaplığı seçebilirsiniz. Firebase SDK'sı için Google Analytics'daki en son modül organizasyonu ile ilgili SSS sayfamıza göz atın.
  6. İşlem tamamlandığında Xcode, arka planda bağımlılıklarınızı otomatik olarak çözmeye ve indirmeye başlar.

Cihaz düzeyinde reklam kimliği olan IDFA hakkında daha fazla bilgiyi Apple'ın Kullanıcı Gizliliği ve Veri Kullanımı ve Uygulama İzleme Şeffaflığı belgelerinde bulabilirsiniz.

Ardından, bazı yapılandırma adımlarını uygulayın:

  1. FirebaseCore modülünü UIApplicationDelegate dosyanıza 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
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

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

    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];
  3. SwiftUI kullanıyorsanız bir uygulama temsilcisi oluşturmanız ve bunu UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor aracılığıyla App yapınıza eklemeniz gerekir. Ayrıca, uygulama temsilcisi swizzling'ini de devre dışı bırakmanız gerekir. Daha fazla bilgi için SwiftUI talimatlarını inceleyin.

    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ırakma

SDK, kolaylık sağlamak amacıyla 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 (Boole) olarak ayarlayın.

Etkinlikleri günlüğe kaydetmeye başlama

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

Belirli etkinlikler tüm uygulamalar için önerilir. Diğerleri ise belirli işletme türleri veya sektörler için önerilir. Raporlarınızda mümkün olan en ayrıntılı bilgileri edinmek ve kullanıma sunulacak özellikler ile entegrasyonlardan yararlanmak için, önerilen etkinlikleri kendi belirlenen parametreleriyle 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 başlıklı makaleyi inceleyin.

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 kaydedileceği gösterilmektedir:

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

Bu etkinliği Xcode hata ayıklama konsolunda görüntülemek için Analytics hata ayıklamasını etkinleştirin:

  1. Xcode'da Product (Ürün) > Scheme (Şema) > Edit scheme (Şemayı düzenle)... seçeneğini belirleyin.
  2. Soldaki menüden Run'ı (Çalıştır) seçin.
  3. Arguments (Bağımsız değişkenler) sekmesini seçin.
  4. Arguments Passed On Launch (Başlatmada İletilen Parametreler) bölümüne -FIRAnalyticsDebugEnabled ifadesini ekleyin.

Sonraki adımlar