Bu kılavuz, uygulamanızdaki etkinlikleri nasıl günlüğe kaydedeceğinizi gösterir.
Olaylar , uygulamanızda kullanıcı eylemleri, sistem olayları veya hatalar gibi neler olup bittiğine dair içgörü sağlar.
Analytics bazı etkinlikleri sizin için otomatik olarak günlüğe kaydeder; bunları almak için herhangi bir kod eklemenize gerek yoktur. Uygulamanızın ek veri toplaması gerekiyorsa, uygulamanıza 500 adede kadar farklı Analytics Olay türü kaydedebilirsiniz. Uygulamanızın günlüğe kaydettiği toplam olay hacminde bir sınır yoktur. Olay adlarının büyük/küçük harfe duyarlı olduğunu ve adları yalnızca büyük/küçük harf farklı olan iki olayın günlüğe kaydedilmesinin iki farklı olayla sonuçlanacağını unutmayın.
Sen başlamadan önce
Projenizi kurduğunuzdan ve Analytics'e, Analytics'i Kullanmaya Başlarken açıklandığı şekilde erişebildiğinizden emin olun.
Günlük olayları
Bir FirebaseAnalytics
örneği oluşturduktan sonra, logEvent()
yöntemiyle olayları günlüğe kaydetmek için bunu kullanabilirsiniz.
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 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.
Önerilen olay türleri için uygulama ayrıntılarını aşağıdaki konumlarda bulabilirsiniz:
- Önerilen etkinlikler:
com.google.firebase.analytics.FirebaseAnalytics.Event
sınıfı referansına bakın. - Öngörülen parametreler:
com.google.firebase.analytics.FirebaseAnalytics.Param
referansına bakın.
Aşağıdaki örnek, bir SELECT_CONTENT
olayının nasıl günlüğe kaydedileceğini gösterir:
Kotlin+KTX
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) { param(FirebaseAnalytics.Param.ITEM_ID, id) param(FirebaseAnalytics.Param.ITEM_NAME, name) param(FirebaseAnalytics.Param.CONTENT_TYPE, "image") }
Java
Bundle bundle = new Bundle(); bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id); bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name); bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image"); mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
Öngörülen 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 olay parametre 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: Analytics > 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. Örnek sorguları ve çok daha fazlasını Google Analytics 4 BigQuery Export'ta bulabilirsiniz.
VALUE
parametresi:VALUE
, bir olayla ilgili temel bir 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ünün kapsamadığı özel ihtiyaçları varsa, bu örnekte gösterildiği gibi kendi özel olaylarınızı günlüğe kaydedebilirsiniz:
Kotlin+KTX
firebaseAnalytics.logEvent("share_image") { param("image_name", name) param("full_text", text) }
Java
Bundle params = new Bundle(); params.putString("image_name", name); params.putString("full_text", text); mFirebaseAnalytics.logEvent("share_image", params);
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, Analytics raporlarında görünmelerini sağlamak için varsayılan etkinlik parametrelerini kaydedin.
Kotlin+KTX
val parameters = Bundle().apply { this.putString("level_name", "Caverns01") this.putInt("level_difficulty", 4) } firebaseAnalytics.setDefaultEventParameters(parameters)
Java
Bundle parameters = new Bundle(); params.putString("level_name", "Caverns01"); params.putInt("level_difficulty", 4); mFirebaseAnalytics.setDefaultEventParameters(parameters);
logEvent()
yönteminde bir parametre belirtilirse, varsayılan değer yerine bu değer kullanılır.
Bir varsayılan parametreyi temizlemek için, parametre null
olarak ayarlanmış setDefaultEventParameters
yöntemini çağırın.
Android Studio hata ayıklama günlüğündeki olayları görüntüleyin
Olayların düzgün bir şekilde günlüğe kaydedildiğini doğrulamaya yardımcı olması için SDK tarafından olayların günlüğe kaydedilmesini izlemek için ayrıntılı günlük kaydını etkinleştirebilirsiniz. Bu, hem otomatik hem de manuel olarak günlüğe kaydedilen olayları içerir.
Bir dizi adb komutuyla ayrıntılı günlüğe kaydetmeyi etkinleştirebilirsiniz:
adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC
Bu komut, etkinliklerinizi Android Studio logcat'te görüntüleyerek, etkinliklerin gönderildiğini hemen doğrulamanıza yardımcı olur.
Panodaki etkinlikleri görüntüleyin
Etkinliklerinizle ilgili toplu istatistikleri Firebase konsol kontrol panellerinde görüntüleyebilirsiniz. Bu panolar gün boyunca periyodik olarak güncellenir. Hemen test etmek için önceki bölümde açıklandığı gibi logcat çıktısını kullanın.
Bu verilere, Firebase konsolundaki Etkinlikler panosundan erişebilirsiniz. Bu pano, uygulamanız tarafından günlüğe kaydedilen her farklı olay türü için otomatik olarak oluşturulan olay raporlarını gösterir.