Google Analytics'i kullanmaya başlama


Bu hızlı başlangıç kılavuzunda, uygulamanıza Google Analytics nasıl ekleyeceğiniz ve etkinlikleri nasıl günlüğe 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: Uygulamanızda neler olduğu (ör. kullanıcı işlemleri, sistem etkinlikleri veya hatalar).
  • 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 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'in 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 etkinleştirmek için > Proje ayarları bölümünün Entegrasyonlar sekmesine gidin.

    Projenizde Google Analytics'i etkinleştirdiğinizde Firebase uygulamalarınız Google Analytics veri akışlarına bağlanır.

  2. (Önerilen) Kitleler ve kampanya ilişkilendirme gibi ek özellikleri etkinleştirmek için AdSupport çerçevesini projenize ekleyin.

Uygulamanıza Analytics SDK'sını ekleyin.

Firebase bağımlılarını yükleyip yönetmek için Swift Package Manager'ı kullanın.

  1. Xcode'da, uygulamanız açıkken File > Add Packages (Dosya > Paket Ekle) seçeneğine 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 en iyi deneyimi elde etmek için Firebase projenizde Google Analytics'ı 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 otomatik olarak arka planda bağımlılarınızı çözümlemeye ve 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 İ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 App yapınızda UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor aracılığıyla 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 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öntemiyle etkinlikleri günlüğe kaydetmeye başlayabilirsiniz.

Bazı etkinlikler tüm uygulamalar için önerilirken bazıları belirli işletme türleri veya sektörler için önerilir. Raporlarınızda maksimum düzeyde ayrıntı sağlamak 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 günlüğe kaydedileceği gösterilmektedir. Etkinliklerin günlüğe kaydedilmesi 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

Not: Bu Firebase ürünü macOS hedefinde kullanılamaz. 
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

Objective-C

Not: Bu Firebase ürünü macOS hedefinde kullanılamaz. 
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

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