Google 致力于为黑人社区推动种族平等。查看具体举措

Olayları günlüğe kaydet

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.

Analitik otomatik olarak bazı kaydeder olayları sizin için; bunları almak için herhangi bir kod eklemeniz gerekmez. Uygulama verileri toplamak gerekiyorsa, uygulamanızda 500 farklı Analytics Etkinlik türüne kadar giriş yapabilirsiniz. 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.

Sen başlamadan önce

Emin Projenizi kurdum ve anlatıldığı gibi Analytics erişebilmesi olun Analytics ile Başlayın .

Olayları günlüğe kaydet

Bir oluşturduktan sonra FirebaseAnalytics örneği, sizinle olayları günlüğe için kullanabilirsiniz logEvent() yöntemiyle.

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. Daha bu olaylar hakkında ve bunları kullanmak için zaman, göz öğrenmek Olaylar ve özellikleri Firebase Yardım Merkezi'ndeki makaleleri.

Önerilen etkinlik türleri için uygulama ayrıntılarını aşağıdaki konumlarda bulabilirsiniz:

Aşağıdaki örnek bir günlüğe nasıl gösterir SELECT_CONTENT olayı:

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);

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")
}

Belirtilen parametrelere ek olarak, herhangi bir olaya aşağıdaki parametreleri ekleyebilirsiniz:

  • Özel parametreler: Özel parametreler edilebilir kayıtlı Analytics raporlarında bildirdikleri için. Onlar da filtreler olarak kullanılabilen seyirci her raporun uygulanabilir tanımları. Özel parametreler de verilere dahil edilir BigQuery'e ihraç uygulama Bir BigQuery projesine bağlıysa.

  • VALUE parametresi: VALUE bir etkinliğe dair olduğu önemli bir metrik biriktirilmesi 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:

Java

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Kotlin+KTX

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}

Varsayılan olay parametrelerini ayarla

Sen kullanarak olayları karşısında parametreleri giriş yapabilirsiniz setDefaultEventParameters . Varsayılan parametreler, günlüğe kaydedilen tüm gelecekteki olaylarla ilişkilendirilir.

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

Kotlin+KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Bir parametre olarak belirtilmediği takdirde logEvent() yöntemiyle, bu değer varsayılan yerine kullanılır.

Varsayılan bir parametreyi silmek için, çağrı setDefaultEventParameters parametre seti ile yöntemini null .

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ı 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.

Bir dizi adb komutuyla ayrıntılı günlük kaydını 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, olaylarınızı Android Studio logcat'te görüntüler ve olayların gönderildiğini hemen doğrulamanıza yardımcı olur.

Kontrol 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.

Sen bu verilere erişebilir Olaylar Firebase konsolunda pano. 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.