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 nasıl kaydetmeye başlayacağınız gösterilmektedir.

Google Analytics, uygulamanızla ilgili kullanım ve davranış verilerini toplar. SDK, iki temel bilgi türünü kaydeder:

  • Etkinlikler: Kullanıcı işlemleri, sistem etkinlikleri veya hatalar gibi uygulamanızda neler olup bittiği.
  • Kullanıcı özellikleri: Kullanıcı tabanınızın segmentlerini tanımlamak için belirlediğiniz özellikler (ö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 kod eklemeniz gerekmez.

Başlamadan önce

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

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

    • Google Analytics'in etkinleştirilmediği mevcut bir Firebase projesi kullanıyorsanız Ayarlar > Entegrasyonlar sekmesinden etkinleştirebilirsiniz.

    Projenizde Google Analytics özelliğini 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.

  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. -ObjC işaretini hedefinizin derleme ayarlarının Other Linker Flags (Diğer Bağlayıcı İşaretleri) bölümüne ekleyin.
  5. Analytics ile optimum deneyim için Firebase projenizde Google Analytics'yi etkinleştirmenizi ve uygulamanıza Google Analytics için Firebase SDK'sını eklemenizi öneririz. IDFA toplama özelliği olmayan veya IDFA toplama özelliği olan kitaplığı seçebilirsiniz. Firebase SDK'sında Google Analytics için modüllerin en son düzenlenmesi ile ilgili SSS bölümümüzü inceleyin.
  6. İşlem tamamlandığında Xcode, bağımlılıklarınızı otomatik olarak çözümlemeye ve arka planda indirmeye başlar.

Cihaz düzeyinde reklam tanımlayıcısı olan IDFA hakkında daha fazla bilgiyi Apple'ın User Privacy and Data Use (Kullanıcı Gizliliği ve Veri Kullanımı) ve App Tracking Transparency (Uygulama Takibinde Şeffaflık) belgelerinde bulabilirsiniz.

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

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

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Uygulama temsilcinizin FirebaseApp application(_:didFinishLaunchingWithOptions:) yönteminde paylaşılan bir örnek 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şturup aracılığıyla UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor kullanarak App yapınıza eklemeniz gerekir. Ayrıca, uygulama temsilcisi karıştırmayı da devre dışı bırakmanız gerekir. 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ırakma

SDK, kolaylık sağlamak için uygulamanızı SKAdNetwork ile reklam ağı ilişkilendirmesi için Apple'a otomatik olarak kaydettirir. 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.

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 önerilirken diğerleri belirli işletme türleri veya sektörler için önerilir. Raporlarınızda maksimum düzeyde ayrıntı elde etmek 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 nasıl kaydedileceği gösterilmektedir. Etkinliklerin kaydedilmesi hakkında daha fazla bilgi için Etkinlikleri kaydetme başlıklı makaleyi inceleyin.

Aşağıdaki örnekte, 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ıklamayı 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