Olayları günlüğe kaydet

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

Olaylar, kullanıcı eylemleri, sistem olayları veya hatalar gibi uygulamanızda neler olup bittiği hakkında bilgi sağlar.

Analitik otomatik olarak bazı kaydeder olayları sizin için; bunları almak için herhangi bir kod eklemeniz gerekmez. Uygulama verileri toplamak gerekiyorsa, uygulamanızda 500 farklı Analytics Etkinlik türüne kadar giriş yapabilirsiniz. Uygulamanızın günlüğe kaydettiği olayların toplam hacminde bir sınır yoktur. Olay adlarının büyük/küçük harf duyarlı olduğunu ve adları yalnızca büyük/küçük harf farkı olan iki olayın günlüğe kaydedilmesinin iki farklı olayla sonuçlanacağını unutmayın.

Sen başlamadan önce

Emin Projenizi kurdum ve anlatıldığı gibi Analytics erişebilmesi olun Analytics ile Başlayın .

Olayları günlüğe kaydet

Eğer yapılandırdıktan sonra FirebaseApp örneği, sizinle olayları günlüğe başlayabilir logEvent() yöntemiyle.

Başlamanıza yardımcı olmak için Analytics SDK, perakende ve e-ticaret, seyahat ve oyun uygulamaları dahil olmak üzere farklı uygulama türleri arasında yaygın olan bir dizi önerilen etkinliği tanımlar. Bu olaylar ve bunların ne zaman kullanılacağı hakkında daha fazla bilgi edinmek için Firebase Yardım Merkezi'ndeki [Etkinlikler ve özellikler][önerilen-events-hc] makalelerine göz atın.

Aşağıdakiler için sabitleri referans uygulama ayrıntıları bulabilirsiniz Swift ve Objective-C .

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

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 olaya aşağıdaki parametreleri ekleyebilirsiniz:

  • Özel parametreler: Özel parametreler edilebilir kayıtlı Analytics raporlarında bildirdikleri için. Onlar da filtreler olarak kullanılabilen seyirci her raporun uygulanabilir tanımları. Özel parametreler de verilere dahil edilir BigQuery'e ihraç uygulama Bir BigQuery projesine bağlıysa.

  • kFIRParameterValue parametresi: kFIRParameterValue bir etkinliğe dair olduğu önemli bir metrik biriktirilmesi için yararlı olan genel amaçlı bir parametredir. Örnekler gelir, mesafe, zaman ve puanları içerir.

Uygulamanızın önerilen bir olay türü tarafından kapsanmayan özel ihtiyaçları varsa, bu örnekte gösterildiği gibi kendi özel olaylarınızı 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 ayarla

Sen kullanarak olayları karşısında parametreleri giriş yapabilirsiniz setDefaultEventParameters . Varsayılan parametreler, günlüğe kaydedilen tüm gelecekteki olaylarla ilişkilendirilir.

Süratli

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

Amaç-C

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

Bir parametre olarak belirtilmediği takdirde logEvent() yöntemiyle, bu değer varsayılan yerine kullanılır.

Varsayılan bir parametreyi silmek için, çağrı setDefaultEventParameters parametre seti ile yöntemini nil .

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

Olayların düzgün bir şekilde günlüğe kaydedildiğini doğrulamaya yardımcı olmak için olayların SDK tarafından günlüğe kaydedilmesini izlemek için ayrıntılı günlüğe kaydetmeyi etkinleştirebilirsiniz. Bu, hem otomatik hem de manuel olarak günlüğe kaydedilen olayları içerir.

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

  1. Xcode olarak, Ürün> Şeması> Edit düzenini seçin ...
  2. Sol menüden Çalıştır seçin.
  3. Argümanlar sekmesini seçin.
  4. Başlatma bölümünde On geçti Argümanlar olarak, eklenti -FIRAnalyticsDebugEnabled .

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

Kontrol panelindeki olayları görüntüleyin

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

Sen bu verilere erişebilir Olaylar Firebase konsolunda pano. Bu gösterge panosu, uygulamanız tarafından günlüğe kaydedilen her farklı olay türü için otomatik olarak oluşturulan olay raporlarını gösterir.