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ı işlemleri otomatik olarak günlüğe kaydeder sizin için düzenlenen etkinlikler; yapma almak için kod eklemeniz gerekir. Uygulamanızın, verilerine göre, uygulamanızda 500 farklı Analytics Etkinlik 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 uygulamasına şurada açıklandığı: Analytics 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 tanımlar 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", ])
Objective-C
[FIRAnalytics logEventWithName:kFIREventSelectContent parameters:@{ kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title], kFIRParameterItemName:self.title, kFIRParameterContentType:@"image" }];
Öngörülen parametrelere ek olarak, aşağıdaki parametreleri de ekleyebilirsiniz kullanabilirsiniz:
Özel parametreler: Özel parametreler boyutlar veya metrikler Analytics raporda. 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, ])
Objective-C
[FIRAnalytics logEventWithName:@"share_image" parameters:@{ @"name": name, @"full_text": text }];
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:
- Xcode'da Product > Şema > Şemayı düzenle...
- Soldaki menüden Çalıştır'ı seçin.
- Bağımsız değişkenler sekmesini seçin.
- 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 konsol kontrol paneli. 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 Firebase erişebilirsiniz. Bu kontrol panelinde etkinlik raporları gösterilir. her etkinlik türü için otomatik olarak oluşturulur. en iyi şekilde yararlanabilirsiniz.