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 bilgi verir (ör. kullanıcı işlemleri, sistem etkinliklerini veya hataları içerir.

Analytics bazı verileri otomatik olarak günlüğe kaydeder size özel etkinlikler; yapma almak için kod eklemeniz gerekir. Uygulamanızın, uygulamanızda 500'e kadar farklı Analytics Etkinliği türünü kaydedebilirsiniz. Uygulamanızın günlüğe kaydettiği toplam etkinlik hacmiyle ilgili bir sınır yoktur. Etkinliğin adları büyük/küçük harfe duyarlıdır ve adları yalnızca büyük harf kullanımı iki farklı olaya neden olur.

Başlamadan önce

Projenizi oluşturduğunuzdan ve Analytics'e şurada açıklandığı: Analytics'i Kullanmaya Başlama.

Etkinlikleri günlüğe kaydetme

FirebaseApp örneğini yapılandırdıktan sonra günlüğe kaydetmeye başlayabilirsiniz şunun olduğu etkinlikler: logEvent() yöntemini kullanabilirsiniz.

Analytics SDK'sı başlamanıza yardımcı olmak için bir dizi Farklı uygulama türlerinde yaygın olan önerilen etkinlikler perakende ve e-ticaret, seyahat ve oyun uygulamaları. Daha fazla bilgi edinmek için hakkında ve bunların ne zaman kullanılacağını öğrenmek için Önerilen etkinlikler bölümüne göz atın.

Uygulama ayrıntılarını şuna ait sabit değerler referansında bulabilirsiniz: Swift ve Hedef-C.

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

Swift

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

Objective-C

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

Öngörülen parametrelere ek olarak, aşağıdaki parametreleri de ekleyebilirsiniz kullanabilirsiniz:

  • Özel parametreler: Özel parametreler boyutlar veya metrikler Analytics raporlarındaki. Sayısal olmayan etkinlik parametresi verileri için özel boyutları kullanabilirsiniz. herhangi bir parametre verisi için özel metrikler sayısal olarak daha iyi temsil edilir. Bir kez SDK'yı kullanarak özel bir parametre kaydettiyseniz, boyutu kaydettiğinizde veya bu özel parametrelerin Analytics'te görüntülenmesini sağlamak için raporlar. Bunu şu şekilde yapın: Analytics > Etkinlikler > Özel Tanımları Yönetin > Özel Boyutlar oluşturma

    Özel parametreler kitle her rapora uygulanabilecek çeşitli tanımları içerir. Özel parametreler de verilere dahil edilir BigQuery'ye aktarıldı BigQuery'ye aktarmanızı öneririz. Örnek sorguları ve çok daha fazlasını bulma Google Analytics 4 BigQuery Export başlıklı makaleyi inceleyin.

  • kFIRParameterValue parametresi: kFIRParameterValue temel metrik toplamak için yararlı olan genel amaçlı bir parametredir düşünmesi gerekir. Örneğin gelir, mesafe, süre ve puan.

Uygulamanızın, önerilen bir programın kapsamına girmeyen belirli ihtiyaçları varsa Kendi özel etkinliklerinizi aşağıdaki örnekte gösterildiği gibi günlüğe kaydedebilirsiniz:

Swift

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

Objective-C

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

Varsayılan etkinlik parametrelerini ayarlama

Etkinlikler genelinde parametreleri günlüğe kaydetmek için setDefaultEventParameters. Varsayılan parametreler, günlüğe kaydedilecek tüm gelecekteki etkinliklerle ilişkilendirilir.

Özel parametrelerde olduğu gibi, aşağıdakilerin sağlandığından emin olmak için varsayılan etkinlik parametrelerini kaydedin: Özel parametreler Analytics raporlarında görünür.

Swift 

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

Objective-C 

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

logEvent() yöntemini seçtiğinizde, varsayılan değer yerine bu değer kullanılır.

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

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

SDK tarafından etkinliklerin günlüğe kaydedilmesine yardımcı olmak amacıyla ayrıntılı günlük kaydını etkinleştirebilirsiniz. etkinliklerin düzgün şekilde günlüğe kaydedildiğini doğrulayın. Bu, hem otomatik hem de ve manuel olarak günlüğe kaydedilen etkinlikler.

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

  1. Xcode'da Product > Şema > Şemayı düzenle...
  2. Soldaki menüden Çalıştır'ı seçin.
  3. Bağımsız değişkenler sekmesini seçin.
  4. Lansmanda İletilen Bağımsız Değişkenler bölümüne -FIRAnalyticsVerboseLoggingEnabled.

Uygulamanızı bir sonraki çalıştırmanızda, etkinlikleriniz Xcode hata ayıklama işleminde gösterilir konsolu, etkinliklerin gönderildiğini hemen doğrulamanıza yardımcı olur.

Kontrol panelinde etkinlikleri görüntüleme

Etkinliklerinizle ilgili toplu istatistikleri şuradan görüntüleyebilirsiniz: Firebase konsolu kontrol panelleri. Bu kontrol panelleri düzenli aralıklarla güncellenir Gün boyu. Anında test için logcat çıkışını aşağıda açıklandığı şekilde kullanın geri dönüp bakarsınız.

Bu verilere şuradan erişebilirsiniz: Etkinlikler kontrol paneline gidin. Bu kontrol panelinde etkinlik raporları gösterilir. her etkinlik türü için otomatik olarak oluşturulur. en iyi şekilde yararlanabilirsiniz.