Olayları günlüğe kaydet

Bu kılavuz, uygulamanızdaki etkinlikleri nasıl günlüğe kaydedeceğinizi gösterir.

Etkinlikler , kullanıcı eylemleri, sistem etkinlikleri veya hatalar gibi uygulamanızda olup bitenler hakkında bilgi sağlar.

Analytics bazı etkinlikleri sizin için otomatik olarak günlüğe kaydeder; bunları almak için herhangi bir kod eklemenize gerek yoktur. 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 etkinliklerin toplam hacminde herhangi bir sınırlama yoktur. Etkinlik adlarının büyük/küçük harfe duyarlı olduğunu ve adları farklı olan iki etkinliğin günlüğe kaydedilmesinin yalnızca büyük/küçük harf durumunda iki farklı olayla sonuçlanacağını unutmayın.

Sen başlamadan önce

Projenizi kurduğunuzdan ve Analytics'e Analytics'e Başlarken bölümünde açıklandığı şekilde erişebildiğinizden emin olun.

Olayları günlüğe kaydet

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

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

Uygulama ayrıntılarını Swift ve Objective-C sabitleri referansında bulabilirsiniz.

Aşağıdaki örnek, önerilen bir kFIRSelectContent olayının nasıl günlüğe kaydedileceğini gösterir:

Süratli

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

Amaç-C

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

Belirtilen parametrelere ek olarak herhangi bir etkinliğe aşağıdaki parametreleri ekleyebilirsiniz:

  • Özel parametreler: Özel parametreler, Analytics raporlarında boyut veya metrik olarak kullanılabilir. Sayısal olmayan olay parametresi verileri için özel boyutları ve sayısal olarak daha iyi temsil edilen herhangi bir parametre verisi için özel metrikleri kullanabilirsiniz. SDK'yı kullanarak özel bir parametreyi kaydettikten sonra, bu özel parametrelerin Analytics raporlarında görünmesini sağlamak için boyutu veya metriği kaydedin. Bunu şu şekilde yapın: Analizler > Etkinlikler > Özel Tanımları Yönetin > Özel Boyutlar Oluşturun

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

  • kFIRParameterValue parametresi: kFIRParameterValue bir olayla ilgili önemli bir ölçümün toplanmasında yararlı olan genel amaçlı bir parametredir. Örnekler arasında gelir, mesafe, süre ve puanlar yer alır.

Uygulamanızın önerilen olay türünün kapsamadığı özel ihtiyaçları varsa, kendi özel olaylarınızı bu örnekte gösterildiği gibi günlüğe kaydedebilirsiniz:

Süratli

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

Amaç-C

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

Varsayılan olay parametrelerini ayarlayın

setDefaultEventParameters kullanarak olaylara ilişkin parametreleri günlüğe kaydedebilirsiniz. Varsayılan parametreler günlüğe kaydedilen tüm gelecekteki olaylarla ilişkilidir.

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

Süratli

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

Amaç-C

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

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

Varsayılan bir parametreyi temizlemek için, parametre nil olarak ayarlıyken setDefaultEventParameters yöntemini çağırın.

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

Olayların düzgün şekilde günlüğe kaydedildiğinin doğrulanmasına yardımcı olmak amacıyla olayların SDK tarafından günlüğe kaydedilmesini izlemek için ayrıntılı günlüğe kaydetmeyi etkinleştirebilirsiniz. Buna hem otomatik hem de manuel olarak kaydedilen olaylar dahildir.

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

  1. Xcode'da Ürün > Şema > Şemayı düzenle... seçeneğini seçin.
  2. Soldaki menüden Çalıştır'ı seçin.
  3. Bağımsız Değişkenler sekmesini seçin.
  4. Başlatma Sırasında Aktarılan Bağımsız Değişkenler bölümüne -FIRAnalyticsVerboseLoggingEnabled ekleyin.

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

Kontrol panelindeki etkinlikleri görüntüleme

Etkinliklerinizle ilgili toplu istatistikleri Firebase konsolu kontrol panellerinde görüntüleyebilirsiniz. Bu kontrol panelleri gün boyunca periyodik olarak güncellenir. Anında test yapmak için önceki bölümde açıklandığı gibi logcat çıktısını kullanın.

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