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

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

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

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, 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. Ş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)
}

Java

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

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