Etkinlikleri günlüğe kaydetme

Bu kılavuzda, uygulamanızdaki etkinlikleri nasıl günlüğe kaydedeceğiniz gösterilmektedir.

Etkinlikler; kullanıcı işlemleri, sistem etkinlikleri veya hatalar gibi uygulamanızda neler olduğuna dair bilgi verir.

Analytics bazı etkinlikleri sizin için otomatik olarak günlüğe kaydeder. Bunları almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın ek veri toplaması gerekiyorsa, uygulamanıza 500'e kadar farklı Analytics Etkinliği türünü kaydedebilirsiniz. Uygulamanızın günlüğe kaydettiği toplam etkinlik hacmiyle ilgili bir sınır yoktur. Etkinlik adlarının büyük/küçük harfe duyarlı olduğunu ve adları yalnızca büyük/küçük harf kullanımı bakımından farklı olan iki etkinliğin günlüğe kaydedilmesinin iki farklı etkinlikle sonuçlandığını unutmayın.

Başlamadan önce

Projenizi oluşturduğunuzdan ve Analytics'i Kullanmaya Başlama bölümünde açıklandığı şekilde Analytics'e erişebildiğinizden emin olun.

Etkinlikleri günlüğe kaydetme

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

Analytics SDK'sı, başlamanıza yardımcı olmak için perakende ve e-ticaret, seyahat ve oyun uygulamaları da dahil olmak üzere farklı uygulama türlerinde yaygın olan bir dizi önerilen etkinliği tanımlar. Bu etkinlikler hakkında ve bunların ne zaman kullanılacağını öğrenmek için Önerilen etkinlikler bölümüne bakın.

Uygulama ayrıntılarını Swift ve Objective-C'nin sabit değeri referansında bulabilirsiniz.

Aşağıdaki örnekte, önerilen bir kFIRSelectContent etkinliğinin nasıl günlüğe kaydedileceği gösterilmektedir:

Swift

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

Objective-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

Öngörülen parametrelere ek olarak, herhangi bir etkinliğe aşağıdaki parametreleri de ekleyebilirsiniz:

  • Özel parametreler: Özel parametreler Analytics raporlarında boyut veya metrik olarak kullanılabilir. Sayısal olmayan etkinlik parametresi verileri için özel boyutları, sayısal olarak daha iyi temsil edilen parametre verileri için özel metrikleri kullanabilirsiniz. SDK'yı kullanarak bir özel parametre kaydettikten sonra, söz konusu özel parametrelerin Analytics raporlarında göründüğünden emin olmak için boyutu veya metriği kaydedin. Bunu şu şekilde yapabilirsiniz: Analytics > Etkinlikler > Özel Tanımları Yönet > Özel Boyutlar Oluştur

    Özel parametreler, her rapora uygulanabilecek kitle tanımlarında kullanılabilir. Uygulamanız bir BigQuery projesine bağlıysa özel parametreler BigQuery'ye aktarılan verilere de dahil edilir. Google Analytics 4 BigQuery Export'ta örnek sorguları ve çok daha fazlasını bulabilirsiniz.

  • kFIRParameterValue parametresi: kFIRParameterValue, bir etkinlikle ilgili temel metrikleri toplamak için faydalı olan genel amaçlı bir parametredir. Örnekler arasında gelir, mesafe, süre ve puan sayısı yer alır.

Uygulamanızın, önerilen bir etkinlik türünün kapsamadığı belirli ihtiyaçları varsa kendi özel etkinliklerinizi aşağıdaki örnekte gösterildiği gibi günlüğe kaydedebilirsiniz:

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])
PatternTabBarController.swift

Objective-C

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

Varsayılan etkinlik parametrelerini ayarlama

setDefaultEventParameters kullanarak parametreleri etkinlikler arasında günlüğe kaydedebilirsiniz. Varsayılan parametreler, günlüğe kaydedilecek tüm gelecekteki etkinliklerle ilişkilendirilir.

Özel parametrelerde olduğu gibi, bu özel parametrelerin Analytics raporlarında gösterilmesini sağlamak için varsayılan etkinlik parametrelerini kaydedin.

Swift 

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Objective-C 

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

logEvent() yönteminde bir parametre belirtilirse varsayılan yerine bu değer kullanılır.

Varsayılan bir parametreyi temizlemek için parametresi nil olarak ayarlanmış setDefaultEventParameters yöntemini çağırın.

Xcode hata ayıklama konsolunda etkinlikleri görüntüleyin

Etkinliklerin SDK tarafından günlüğe kaydedildiğini izlemek amacıyla, etkinliklerin düzgün şekilde günlüğe kaydedildiğini doğrulamaya yardımcı olması için ayrıntılı günlük kaydını etkinleştirebilirsiniz. Buna hem otomatik hem de manuel olarak kaydedilen etkinlikler dahildir.

Ayrıntılı günlük kaydını aşağıdaki şekilde etkinleştirebilirsiniz:

  1. Xcode'da Ürün > Şema > Şemayı düzenle...'yi seçin.
  2. Soldaki menüden Çalıştır'ı seçin.
  3. Bağımsız değişkenler sekmesini seçin.
  4. Lansmanda İletilen Bağımsız Değişkenler bölümüne -FIRAnalyticsVerboseLoggingEnabled ekleyin.

Uygulamanızı bir sonraki çalıştırmanızda, etkinlikleriniz Xcode hata ayıklama konsolunda görüntülenecek ve etkinliklerin gönderildiğini hemen doğrulamanıza yardımcı olacaktır.

Kontrol panelinde etkinlikleri görüntüleme

Etkinliklerinizle ilgili toplu istatistikleri Firebase konsolu kontrol panellerinde görebilirsiniz. Bu kontrol panelleri gün boyunca düzenli aralıklarla güncellenir. Anında test için önceki bölümde açıklandığı şekilde logcat çıkışını kullanın.

Bu verilere Firebase konsolundaki Etkinlikler kontrol panelinden erişebilirsiniz. Bu kontrol panelinde, uygulamanız tarafından günlüğe kaydedilen her farklı etkinlik türü için otomatik olarak oluşturulan etkinlik raporları gösterilir.