Etkinlikleri günlüğe kaydetme

Etkinlikler; kullanıcı işlemleri, sistem etkinlikleri veya hatalar gibi uygulamanızda neler olduğuna dair bilgi sağlar.

Google Analytics bazı etkinlikleri sizin için otomatik olarak günlüğe kaydeder; bunları almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın ek veri toplaması gerekiyorsa uygulamanıza 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. 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ında farklı olan iki etkinliğin günlüğe iki farklı etkinlikle sonuçlandığını unutmayın.

Başlamadan önce

Google Analytics'i kullanabilmek için şunları yapmanız gerekir:

  • Unity projenizi kaydedin ve Firebase'i kullanacak şekilde yapılandırın.

    • Unity projeniz zaten Firebase'i kullanıyorsa Firebase için kaydedilmiş ve yapılandırılmış demektir.

    • Unity projeniz yoksa örnek bir uygulama indirebilirsiniz.

  • Unity projenize Firebase Unity SDK'yı (özellikle FirebaseAnalytics.unitypackage) ekleyin.

Firebase'i Unity projenize eklemenin hem Firebase konsolundaki hem de açık Unity projenizdeki görevleri içerdiğini unutmayın (örneğin, Firebase yapılandırma dosyalarını konsoldan indirir ve ardından bunları Unity projenize taşırsınız).

Etkinlikleri günlüğe kaydetme

Firebase.Analytics.FirebaseAnalytics modülünü başlattıktan sonra LogEvent() yöntemiyle etkinlikleri günlüğe kaydetmek için bu modülü kullanabilirsiniz.

Analytics SDK'sı, başlamanıza yardımcı olmak için perakende ve e-ticaret, seyahat ve oyun uygulamaları da dahil olmak üzere farklı uygulama türlerinde 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 Google Analytics Yardım Merkezi'ndeki Önerilen etkinlikler makalelerine göz atın.

Önerilen etkinliklerin uygulama ayrıntılarını aşağıdaki konumlarda bulabilirsiniz:

  • Önerilen etkinlikler: Event sabit değerlerinin listesini inceleyin.
  • Belirlenen parametreler: Parameters sabit değerlerinin listesine bakın.

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

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

Öngörülen parametrelere ek olarak, herhangi bir etkinliğe aşağıdaki parametreleri de ekleyebilirsiniz:

  • Özel parametreler: Özel parametreler doğrudan Analytics raporlarınızda temsil edilmez, ancak her rapora uygulanabilecek Kitle tanımlarında filtre olarak kullanılabilir. Uygulamanız bir BigQuery projesine bağlıysa özel parametreler BigQuery'ye aktarılan verilere de dahil edilir.

  • VALUE Parametresi: VALUE, bir Analytics etkinliğiyle ilgili temel metrikleri toplamak için faydalı olan genel amaçlı bir parametredir. Örneğin gelir, mesafe, zaman ve puan.

Uygulamanızın önerilen bir Analytics etkinliği türünün kapsamında olmayan belirli ihtiyaçları varsa aşağıdaki örnekte gösterildiği gibi kendi özel Analytics Etkinliklerinizi kaydedebilirsiniz:

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

Günlük çıktısındaki etkinlikleri görüntüleyin

Android

Etkinliklerin SDK tarafından düzgün bir şekilde günlüğe kaydedildiğini doğrulamaya yardımcı olması için Android Studio Hata Ayıklama Günlüğü'nde ayrıntılı günlük kaydını etkinleştirebilirsiniz. Otomatik ve manuel olarak kaydedilen etkinlikler de buna dahildir.

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ğrulamanıza yardımcı olur.

iOS ve üzeri

Etkinlikler konsola kaydedilir ve uygulama XCode üzerinden çalıştırılırken görüntülenebilir.

Analiz etkinliklerini kontrol panelinde görüntüleme

Analytics Etkinliklerinizle ilgili toplu istatistikleri Firebase konsolu kontrol panellerinde görebilirsiniz. Bu kontrol panelleri gün boyunca düzenli aralıklarla güncellenir. Anında test için önceki bölümde açıklandığı şekilde logcat çıkışını kullanın.

Firebase konsolunda bu verilere erişmek için:

  1. Firebase konsolunda projenizi açın.
  2. Analytics raporlama kontrol panelini görüntülemek için menüden Analytics'i seçin.

Etkinlikler sekmesi, uygulamanız tarafından günlüğe kaydedilen her bir Analytics etkinlik türü için otomatik olarak oluşturulan etkinlik raporlarını gösterir. Kontrol paneli ile ilgili daha fazla bilgi edinin.