Etkinlikleri günlüğe kaydetme

Platform seçin: iOS+ Android Web Flutter Unity C++


Etkinlikler, kullanıcı işlemleri, sistem etkinlikleri veya hatalar gibi uygulamanızda neler olup bittiğine dair analizler almanızı sağlar.

Analytics sizin için bazı etkinlikleri otomatik olarak günlüğe kaydeder. Bu etkinlikleri almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın ek veriler toplaması gerekiyorsa uygulamanızda 500'e kadar farklı AnalyticsEtkinlik türü kaydedebilirsiniz. Uygulamanızın kaydettiği etkinliklerin toplam 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ı iki etkinliğin kaydedilmesinin, iki ayrı etkinliğin kaydedilmesine neden olacağını unutmayın.

Başlamadan önce

Projenizi ayarladığınızdan ve Analytics'ya Analytics'yı kullanmaya başlama bölümünde açıklandığı şekilde erişebildiğinizden emin olun.

Kampanya ilişkilendirme verilerini toplamak istiyorsanız projenize AdSupport çerçevesini eklediğ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.

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 olarak kullanılan 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, önerilen bir kFIRSelectContent etkinliğinin nasıl kaydedileceği gösterilmektedir:

Swift

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

Objective-C

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

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. Bunu yapmak için Firebase konsolunda Analytics > Özel Tanımlar'a gidin.

    Özel parametreler, her rapora uygulanabilen kitle tanımlarında kullanılabilir. Uygulamanız bir BigQuery projesine bağlıysa özel parametreler de BigQuery'ye aktarılan verilere 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ü tarafından karşılanmayan belirli ihtiyaçları varsa kendi özel etkinliklerinizi bu örnekte gösterildiği gibi günlüğe kaydedebilirsiniz:

Swift

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

Objective-C

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

Varsayılan etkinlik parametrelerini ayarlama

setDefaultEventParameters kullanarak etkinlikler genelinde parametreleri günlüğe 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.

Swift 

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

Objective-C 

[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

Olayların düzgün şekilde kaydedildiğini doğrulamaya yardımcı olmak için SDK tarafından olayların günlüğe kaydedilmesini izlemek üzere ayrıntılı günlüğü etkinleştirebilirsiniz. Otomatik olarak ve manuel olarak kaydedilen etkinlikler buna dahildir.

Ayrıntılı günlük kaydını aşağıdaki ş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

Firebase konsolunda, etkinliklerinizle ilgili toplu istatistikleri Analytics > Etkinlikler kontrol panelinde görüntüleyebilirsiniz.

Bu kontrol paneliyle ilgili aşağıdaki noktaları göz önünde bulundurun:

  • Kontrol panelinde, uygulamanız tarafından kaydedilen her farklı etkinlik türü için otomatik olarak oluşturulan etkinlik raporları gösterilir.

  • Kontrol paneli gün boyunca düzenli aralıklarla güncellenir. Anında test için bu kılavuzun önceki bölümünde açıklandığı gibi Xcode hata ayıklama konsolu çıkışını kullanın.