Etkinlikleri günlüğe kaydetme

Etkinlikler, uygulamanızda neler olup bittiğine (ör. kullanıcı işlemleri, sistem etkinlikleri veya hatalar) dair bilgi verir.

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

Başlamadan önce

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

Kampanya ilişkilendirme verilerini toplamak istiyorsanız AdSupport çerçevesini projenize eklediğinizden emin olun.

Günlük etkinlikleri

FirebaseApp örneğini yapılandırdıktan sonra logEvent() yöntemini kullanarak etkinlikleri 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ı dahil olmak üzere farklı uygulama türleri arasında 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, önerilen bir kFIRSelectContent etkinliğinin nasıl günlüğe kaydedileceği gösterilmektedir:

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

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

Belirlenen 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 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 parametre 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 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 toplamak için kullanışlı olan genel amaçlı bir parametredir. Gelir, mesafe, zaman ve puanlar buna örnek olarak verilebilir.

Uygulamanızın, önerilen etkinlik türleri tarafından karşılanmayan özel ihtiyaçları varsa aşağıdaki örnekte gösterildiği gibi kendi özel etkinliklerinizi kaydedebilirsiniz:

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

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

Varsayılan etkinlik parametrelerini ayarlama

setDefaultEventParameters kullanarak etkinlikler genelinde parametreleri günlüğe kaydedebilirsiniz. Varsayılan parametreler, günlüğe kaydedilen gelecekteki tüm etkinliklerle ilişkilendirilir.

Özel parametrelerde olduğu gibi, varsayılan etkinlik parametrelerini de kaydederek bu özel parametrelerin Analytics raporlarında görünmesini sağlayın.

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 düzgün şekilde günlüğe kaydedildiğini doğrulamak için SDK tarafından etkinliklerin günlüğe kaydedilmesini izlemek üzere ayrıntılı günlük kaydını etkinleştirebilirsiniz. Buna hem otomatik hem de manuel olarak günlüğe kaydedilen etkinlikler 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ırmanızda etkinlikleriniz Xcode hata ayıklama konsolunda gösterilir. Böylece etkinliklerin gönderildiğini hemen doğrulayabilirsiniz.

Kontrol panelinde etkinlikleri görüntüleme

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

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

• Kontrol panelinde, uygulamanız tarafından günlüğe 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.