Etkinlikleri günlüğe kaydetme

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

Etkinlikler, uygulamanızda neler olduğuna dair analizler sağlar (ör. kullanıcı işlemleri, sistem etkinlikleri veya hatalar).

Analytics bazı etkinlikleri sizin için otomatik olarak kaydeder. Bu etkinlikleri almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın başka veriler de toplaması gerekiyorsa uygulamanıza 500 farklı türde Analytics Etkinlik türü kaydedebilirsiniz. Uygulamanızın kaydettiği etkinliklerin toplam hacminin 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ı iki etkinliğin kaydedilmesinin, iki farklı etkinliğin kaydedilmesine neden olacağını unutmayın.

Başlamadan önce

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

Günlük etkinlikleri

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ı ne zaman kullanacağınız hakkında daha fazla bilgi edinmek için Önerilen etkinlikler başlıklı makaleyi inceleyin.

Uygulama ayrıntılarını Swift ve Objective-C için sabit referanslarında bulabilirsiniz.

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

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

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

Önerilen parametrelere ek olarak, tüm etkinliklere aşağıdaki parametreleri 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 tüm parametre verileri için özel metrikleri kullanabilirsiniz. SDK'yı kullanarak bir özel parametreyi günlüğe kaydettikten sonra, bu özel parametrelerin Analytics raporlarında görünmesini sağlamak için boyutu veya metriği kaydedin. Bunu şuradan yapabilirsiniz: Analytics > Etkinlikler > Özel Tanımlamaları Yönet > Özel Boyut 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. Örnek sorguları ve daha fazlasını Google Analytics 4 BigQuery Export'ta bulabilirsiniz.

• kFIRParameterValue parametresi: kFIRParameterValue, bir etkinlikle ilgili önemli bir metriği toplamak için yararlı 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ü tarafından karşılanmayan belirli ihtiyaçları varsa bu örnekte gösterildiği gibi kendi özel etkinliklerinizi günlüğe kaydedebilirsiniz:

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

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

Varsayılan etkinlik parametrelerini ayarlama

setDefaultEventParameters kullanarak parametreleri etkinliklere kaydedebilirsiniz. Varsayılan parametreler, günlüğe kaydedilen gelecekteki tüm 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.

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

[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 ayarlanmış şekilde setDefaultEventParameters yöntemini çağırın.

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

Etkinliklerin SDK tarafından günlüğe kaydedilmesini izlemek için ayrıntılı günlük kaydını etkinleştirerek etkinliklerin doğru şekilde günlüğe kaydedildiğini doğrulayabilirsiniz. Hem otomatik olarak hem de manuel olarak kaydedilen etkinlikler buna dahildir.

Ayrıntılı günlük kaydını şu şekilde etkinleştirebilirsiniz:

1. Xcode'da Ürün > Şema > Şemayı düzenle...'yi seçin.
2. Sol menüden Çalıştır'ı seçin.
3. Argumentler sekmesini seçin.
4. Başlatmada İletilen Parametreler bölümünde -FIRAnalyticsVerboseLoggingEnabled ekleyin.

Uygulamanızı bir sonraki sefer çalıştırdığınızda etkinlikleriniz Xcode hata ayıklama konsolunda gösterilir. Bu sayede, etkinliklerin gönderildiğini hemen doğrulayabilirsiniz.

Etkinlikleri kontrol panelinde görüntüleme

Etkinliklerinizle ilgili toplu istatistikleri Firebase konsolu kontrol panellerinde görüntüleyebilirsiniz. Bu gösterge tabloları gün içinde 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 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.