Bu kılavuz, uygulamanızdaki olayları nasıl günlüğe kaydedeceğinizi gösterir.
Olaylar , kullanıcı eylemleri, sistem olayları veya hatalar gibi uygulamanızda neler olup bittiği hakkında bilgi sağlar.
Analytics, sizin için bazı olayları otomatik olarak günlüğe kaydeder; bunları almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın ek veri toplaması gerekiyorsa, uygulamanıza 500'e kadar farklı Analytics Etkinliği türü kaydedebilirsiniz. Uygulamanızın günlüğe kaydettiği olayların toplam hacminde bir sınır yoktur. Olay adlarının büyük/küçük harf duyarlı olduğunu ve adları yalnızca büyük/küçük harf farkı olan iki olayın günlüğe kaydedilmesinin iki farklı olayla sonuçlanacağını unutmayın.
tutucu90 l10n-yerSen başlamadan önce
Projenizi kurduğunuzdan ve Analytics'e Başlarken bölümünde açıklandığı gibi Analytics'e erişebildiğinizden emin olun.
Olayları günlüğe kaydet
FirebaseApp
örneğini yapılandırdıktan sonra, logEvent()
yöntemiyle olayları 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ürleri arasında yaygın olan bir dizi önerilen etkinliği tanımlar. Bu etkinlikler ve bunların ne zaman kullanılacağı hakkında daha fazla bilgi edinmek için Önerilen etkinlikler bölümüne bakın.
Uygulama ayrıntılarını Swift ve Objective-C için sabitler referansında bulabilirsiniz.
Aşağıdaki örnek, önerilen bir kFIRSelectContent
olayının nasıl günlüğe kaydedileceğini gösterir:
Süratli
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
Amaç-C
[FIRAnalytics logEventWithName:kFIREventSelectContent parameters:@{ kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title], kFIRParameterItemName:self.title, kFIRParameterContentType:@"image" }];
Belirtilen parametrelere ek olarak, herhangi bir olaya aşağıdaki parametreleri ekleyebilirsiniz:
Özel parametreler: Özel parametreler, Analytics raporlarında boyut veya metrik olarak kullanılabilir. Sayısal olmayan olay parametresi verileri için özel boyutları ve sayısal olarak daha iyi temsil edilen herhangi bir parametre verisi için ö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 şu yollarla yapın: Analizler > Etkinlikler > Özel Tanımları Yönetin > Özel Boyutlar Oluşturun
Her rapora uygulanabilecek kitle tanımlarında özel parametreler kullanılabilir. Uygulamanız bir BigQuery projesine bağlıysa, BigQuery'ye aktarılan verilere özel parametreler de dahil edilir. Google Analytics 4 BigQuery Export'ta örnek sorguları ve çok daha fazlasını bulun.
kFIRParameterValue
parametresi:kFIRParameterValue
, bir olayla ilgili bir anahtar metriği toplamak için yararlı olan genel amaçlı bir parametredir. Örnekler gelir, mesafe, zaman ve puanları içerir.
Uygulamanızın önerilen bir olay türü tarafından kapsanmayan özel ihtiyaçları varsa, bu örnekte gösterildiği gibi kendi özel olaylarınızı kaydedebilirsiniz:
Süratli
Analytics.logEvent("share_image", parameters: [ "name": name as NSObject, "full_text": text as NSObject, ])
Amaç-C
[FIRAnalytics logEventWithName:@"share_image" parameters:@{ @"name": name, @"full_text": text }];
Varsayılan olay parametrelerini ayarla
setDefaultEventParameters
kullanarak olaylar arasında parametreleri günlüğe kaydedebilirsiniz. Varsayılan parametreler, günlüğe kaydedilen tüm gelecekteki olaylarla 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.
Süratli
Analytics.setDefaultEventParameters([
"level_name": "Caverns01",
"level_difficulty": 4
])
Amaç-C
[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ış setDefaultEventParameters
yöntemini çağırın.
Olayları Xcode hata ayıklama konsolunda görüntüleyin
Olayların düzgün bir şekilde günlüğe kaydedildiğini doğrulamaya yardımcı olmak için olayların SDK tarafından günlüğe kaydedilmesini izlemek için ayrıntılı günlüğe kaydetmeyi etkinleştirebilirsiniz. Bu, hem otomatik hem de manuel olarak günlüğe kaydedilen olayları içerir.
Ayrıntılı günlük kaydını aşağıdaki gibi etkinleştirebilirsiniz:
- Xcode'da Ürün > Şema > Şemayı düzenle... 'yi seçin.
- Sol menüden Çalıştır'ı seçin.
- Argümanlar sekmesini seçin.
- Başlatma Sırasında Geçilen Bağımsız Değişkenler bölümünde,
-FIRAnalyticsDebugEnabled
ekleyin.
Uygulamanızı bir sonraki çalıştırışınızda, etkinlikleriniz Xcode hata ayıklama konsolunda görüntülenerek olayların gönderildiğini hemen doğrulamanıza yardımcı olur.
tutucu94 l10n-yerKontrol panelindeki olayları görüntüleyin
Etkinliklerinizle ilgili toplu istatistikleri Firebase konsol gösterge tablolarında görüntüleyebilirsiniz. Bu panolar gün boyunca periyodik olarak güncellenir. Anında test için önceki bölümde açıklandığı gibi logcat çıktısını kullanın.
Bu verilere Firebase konsolundaki Etkinlikler panosundan erişebilirsiniz. Bu gösterge panosu, uygulamanız tarafından günlüğe kaydedilen her farklı olay türü için otomatik olarak oluşturulan olay raporlarını gösterir.