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

Bir FirebaseAnalytics örneği oluşturduktan sonra bu örneği kullanarak şunun olduğu etkinlikler: logEvent() yöntemidir.

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.

Önerilen etkinlik türlerinin uygulama ayrıntılarını aşağıda bulabilirsiniz: yerler:

Aşağıdaki örnekte, bir SELECT_CONTENT etkinlik:

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")
}
MainActivity.kt

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);
MainActivity.java

Ö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. Şu tarihten sonra: 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 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.

  • VALUE parametresi: VALUE genel amaçlı bir parametredir Belirli bir konuyla ilgili temel metrikleri toplamak için unutmayın. Örnekler arasında gelir, mesafe, süre ve puan yer alır.

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:

Kotlin+KTX 

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

Java 

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

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, varsayılan etkinlik parametrelerini de Analytics raporlarında görünür.

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ö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 null olarak ayarlayın.

Android Studio hata ayıklama günlüğündeki etkinlikleri görüntüle

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ı bir dizi adb komutuyla 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ğrular.

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.