Etkinlikleri günlüğe kaydetme

Etkinlikler, uygulamanızda neler olduğuna (ör. kullanıcı işlemleri, sistem etkinlikleri veya hatalar) dair bilgi verir.

Analytics sizin için bazı etkinlikleri otomatik olarak günlüğe kaydeder. Bu etkinlikleri almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın ek veriler toplaması gerekiyorsa uygulamanızda 500'e kadar farklı Analytics etkinlik türü günlüğe kaydedebilirsiniz. Uygulamanızın günlüğe kaydettiği etkinliklerin toplam hacmiyle ilgili bir sınır yoktur. Etkinlik adlarının büyük/küçük harfe duyarlı olduğunu ve adları yalnızca büyük/küçük harf kullanımı bakımından farklı iki etkinliğin kaydedilmesinin, iki farklı etkinliğin kaydedilmesine neden olacağını unutmayın.

Başlamadan önce

Projenizi ayarladığınızdan ve Analytics'ya Analytics'yı kullanmaya başlama bölümünde açıklandığı şekilde erişebildiğinizden emin olun.

Günlük etkinlikleri

FirebaseAnalytics örneği oluşturduktan sonra logEvent() yöntemini kullanarak etkinlikleri günlüğe kaydedebilirsiniz.

Başlamanıza yardımcı olmak için Analytics SDK, perakende ve e-ticaret, seyahat ve oyun uygulamaları dahil olmak üzere farklı uygulama türlerinde yaygın olarak kullanılan bir dizi önerilen etkinlik tanımlar. Bu etkinlikler ve ne zaman kullanılacakları hakkında daha fazla bilgi edinmek için Önerilen etkinlikler başlıklı makaleyi inceleyin.

Önerilen etkinlik türleriyle ilgili uygulama ayrıntılarını aşağıdaki yerlerde bulabilirsiniz:

• Önerilen etkinlikler: com.google.firebase.analytics.FirebaseAnalytics.Event sınıf referansına bakın.
• Belirlenen parametreler: com.google.firebase.analytics.FirebaseAnalytics.Param referansına bakın.

Aşağıdaki örnekte, bir SELECT_CONTENT etkinliğinin nasıl günlüğe kaydedileceği gösterilmektedir:

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

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

Belirlenen parametrelere ek olarak, aşağıdaki parametreleri herhangi bir etkinliğe ekleyebilirsiniz:

• Özel parametreler: Özel parametreler, Analytics raporlarında boyut veya metrik olarak kullanılabilir. Sayısal olmayan etkinlik parametresi verileri için özel boyutları, sayısal olarak daha iyi temsil edilen parametre verileri için ise özel metrikleri kullanabilirsiniz. SDK'yı kullanarak özel bir parametreyi kaydettikten sonra, bu özel parametrelerin Analytics raporlarında görünmesini sağlamak için boyutu veya metriği kaydedin. Bunu yapmak için Firebase konsolunda Analytics > Özel Tanımlar'a gidin.

  Özel parametreler, her rapora uygulanabilen kitle tanımlarında kullanılabilir. Uygulamanız bir BigQuery projesine bağlıysa özel parametreler de BigQuery'ye aktarılan verilere dahil edilir. Örnek sorguları ve daha fazlasını Google Analytics 4 BigQuery Export sayfasında bulabilirsiniz.

• VALUE parametresi: VALUE bir etkinlikle ilgili önemli bir metriği biriktirmek için yararlı olan genel amaçlı bir parametredir. Gelir, mesafe, süre ve puanlar buna örnek verilebilir.

Uygulamanızın, önerilen bir etkinlik türü tarafından karşılanmayan belirli ihtiyaçları varsa kendi özel etkinliklerinizi bu örnekte gösterildiği gibi günlüğe kaydedebilirsiniz:

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

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

setDefaultEventParameters kullanarak etkinlikler genelinde parametreleri günlüğe kaydedebilirsiniz. Varsayılan parametreler, günlüğe kaydedilen tüm gelecekteki etkinliklerle ilişkilendirilir.

Özel parametrelerde olduğu gibi, varsayılan etkinlik parametrelerini de Analytics raporlarında göründüklerinden emin olmak için kaydedin.

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

firebaseAnalytics.setDefaultEventParameters(parameters)

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

logEvent() yönteminde bir parametre belirtilmişse varsayılan değer yerine bu değer kullanılır.

Varsayılan bir parametreyi temizlemek için parametresi null olarak ayarlanmış setDefaultEventParameters yöntemini çağırın.

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

Olayların düzgün şekilde kaydedildiğini doğrulamaya yardımcı olmak için SDK tarafından olayların günlüğe kaydedilmesini izlemek üzere ayrıntılı günlüğü etkinleştirebilirsiniz. Otomatik olarak ve manuel olarak kaydedilen etkinlikler buna dahildir.

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, etkinliklerin gönderildiğini hemen doğrulamanıza yardımcı olarak etkinliklerinizi Android Studio logcat'te gösterir.

Etkinlikleri kontrol panelinde görüntüleme

Firebase konsolunda, etkinliklerinizle ilgili toplu istatistikleri Analytics > Etkinlikler kontrol panelinde görüntüleyebilirsiniz.

Bu kontrol paneliyle ilgili aşağıdaki noktaları göz önünde bulundurun:

• Kontrol panelinde, uygulamanız tarafından kaydedilen her farklı etkinlik türü için otomatik olarak oluşturulan etkinlik raporları gösterilir.

• Kontrol paneli gün boyunca düzenli aralıklarla güncellenir. Anında test için bu kılavuzun önceki bölümünde açıklandığı şekilde logcat çıkışını kullanın.