Catch up on highlights from Firebase at Google I/O 2023. Learn more

Olayları günlüğe kaydet

Olaylar, uygulamanızda kullanıcı eylemleri, sistem olayları veya hatalar gibi neler olup bittiğine dair içgörü sağlar.

Google Analytics bazı etkinlikleri sizin için otomatik olarak günlüğe kaydeder; bunları almak için herhangi bir kod eklemenize gerek yoktur. Uygulamanızın ek veri toplaması gerekiyorsa, uygulamanızda 500 adede kadar farklı Analytics olayı türü kaydedebilirsiniz. Uygulamanızın günlüğe kaydettiği toplam olay hacminde bir sınır yoktur. Olay adlarının büyük/küçük harfe duyarlı olduğunu ve adları yalnızca büyük/küçük harf farklı olan iki olayın günlüğe kaydedilmesinin iki farklı olayla sonuçlanacağını unutmayın.

Sen başlamadan önce

Google Analytics'i kullanmadan önce yapmanız gerekenler:

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

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

    • Bir Unity projeniz yoksa örnek bir uygulama indirebilirsiniz.

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

Unity projenize Firebase eklemenin hem Firebase konsolunda hem de açık Unity projenizde görevler 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).

Günlük olayları

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

Başlamanıza yardımcı olmak için Analytics SDK'sı, 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. Bu etkinlikler ve bunların ne zaman kullanılacağı hakkında daha fazla bilgi edinmek için Firebase Yardım Merkezi'ndeki Etkinlikler ve özellikler makalelerine göz atın.

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

  • Önerilen olaylar: Event sabitleri listesine bakın.
  • Öngörülen parametreler: Parameters sabitleri listesine bakın.

Aşağıdaki örnek, önerilen bir SELECT_CONTENT Etkinliğinin nasıl günlüğe kaydedileceğini gösterir:

    // 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 ekleyebilirsiniz:

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

  • VALUE Parametresi: VALUE , bir Analytics Etkinliğine ilişkin temel bir metriği toplamak için yararlı olan genel amaçlı bir parametredir . Örnekler gelir, mesafe, zaman ve puanları içerir.

Uygulamanızın, önerilen bir Analytics Olay türünün kapsamadığı özel ihtiyaçları varsa, kendi özel Analytics Olaylarınızı bu örnekte gösterildiği gibi günlüğe kaydedebilirsiniz:

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

Olayları günlük çıktısında görüntüle

Android

Olayların 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. Bu, hem otomatik hem de manuel olarak günlüğe kaydedilen olayları içerir.

Bir dizi adb komutuyla ayrıntılı günlüğe kaydetmeyi 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+

Olaylar konsola kaydedilir ve uygulama XCode aracılığıyla çalıştırılırken görüntülenebilir.

Analitik olaylarını kontrol panelinde görüntüleyin

Analytics Etkinliklerinizle ilgili toplu istatistikleri Firebase konsol kontrol panellerinde görüntüleyebilirsiniz. Bu panolar gün boyunca periyodik olarak güncellenir. Hemen test etmek için önceki bölümde açıklandığı gibi logcat çıktısı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 farklı Analytics Etkinliği türü için otomatik olarak oluşturulan etkinlik raporlarını gösterir. Firebase Yardım Merkezi'nde Analytics raporlama kontrol paneli hakkında daha fazla bilgi edinin.