Etkinlikleri günlüğe kaydetme

Bu kılavuzda, uygulamanızdaki etkinliklerin nasıl günlüğe kaydedileceği açıklanmaktadır.

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. Bunları 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 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'ı kullanmaya başlama başlıklı makalede açıklandığı şekilde Analytics'a erişebildiğinizden emin olun.

Günlüğe kaydedilen etkinlikler

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

Başlamanıza yardımcı olmak için Analytics SDK, perakende ve e-ticaret, seyahat ve oyun uygulamaları dahil olmak üzere farklı uygulama türlerinde yaygın olan bir dizi önerilen etkinlik tanımlar. Bu etkinlikler ve ne zaman kullanılacakları 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 sabitler referansında bulabilirsiniz.

Aşağıdaki örnekte, bir recommended kFIRSelectContent etkinliğinin nasıl 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

Belirlenen parametrelere ek olarak, aşağıdaki parametreleri herhangi bir etkinliğe 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 ise ö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. Bu işlemi şu şekilde yapabilirsiniz: Analytics > Etkinlikler > Özel Tanımları Yönet > Özel Boyutlar Oluşturun

  Ö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 sayfasında bulabilirsiniz.

• kFIRParameterValue parametresi: kFIRParameterValue Bir etkinlikle ilgili önemli bir metriği biriktirmek için yararlı olan genel amaçlı bir parametredir. Gelir, mesafe, süre ve puan buna örnek verilebilir.

Uygulamanızın, önerilen bir etkinlik türüyle karşılanmayan belirli ihtiyaçları varsa kendi özel etkinliklerinizi bu örnekte gösterildiği gibi 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 etkinlikler genelinde parametreleri kaydedebilirsiniz. Varsayılan parametreler, günlüğe kaydedilen tüm gelecekteki etkinliklerle ilişkilendirilir.

Özel parametrelerde olduğu gibi, bu özel parametrelerin Analytics raporlarında görünmesini 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 belirtilmişse varsayılan değer yerine bu değer kullanılır.

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

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

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

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

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 -FIRAnalyticsVerboseLoggingEnabled ifadesini ekleyin.

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

Etkinlikleri kontrol panelinde görüntüleme

Etkinliklerinizle ilgili toplu istatistikleri Firebase konsolunun kontrol panellerinde görüntüleyebilirsiniz. Bu gösterge tabloları gün içinde düzenli aralıklarla güncellenir. Anında test etmek için, logcat çıkışlarını önceki bölümde açıklandığı şekilde 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.