Olayları günlüğe kaydet

Bu kılavuz, uygulamanızdaki olayları nasıl günlüğe kaydedeceğinizi gösterir.

tutucu85 l10n-yer

Olaylar , kullanıcı eylemleri, sistem olayları veya hatalar gibi uygulamanızda neler olup bittiği hakkında bilgi sağlar.

Analytics, sizin için bazı olayları 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'e kadar farklı Analytics Etkinliği türü kaydedebilirsiniz. Uygulamanızın günlüğe kaydettiği olayların toplam 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 farkı olan iki olayın günlüğe kaydedilmesinin iki farklı olayla sonuçlanacağını unutmayın.

tutucu90 l10n-yer

Sen başlamadan önce

Projenizi kurduğunuzdan ve Analytics'e Başlarken bölümünde açıklandığı gibi Analytics'e erişebildiğinizden emin olun.

Olayları günlüğe kaydet

firebase.analytics() örneğini yapılandırdıktan sonra, logEvent() yöntemiyle olayları günlüğe kaydetmeye başlayabilirsiniz. Google Analytics'e zaten aşina iseniz, bu yöntem gtag.js'deki event komutunu kullanmaya eşdeğerdir.

Başlamanıza yardımcı olmak için Analytics SDK, 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 Önerilen etkinlikler bölümüne bakın.

Not: Raporlarda maksimum ayrıntıyı elde etmek için, uygulamanız için anlamlı olan önerilen olayları ve bunların öngörülen parametrelerini günlüğe kaydedin. Bu ayrıca, kullanıma sunuldukça en yeni Google Analytics özelliklerinden yararlanmanızı sağlar.

gtag.js olay referansında birkaç olay ve parametreleri için uygulama ayrıntılarını bulabilirsiniz.

Aşağıdaki örnek, bir select_content olayının nasıl günlüğe kaydedileceğini gösterir:

Web version 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

Web version 8

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

Belirtilen parametrelere ek olarak, herhangi bir olaya aşağıdaki parametreleri ekleyebilirsiniz:

  • Özel parametreler: Özel parametreler, Analytics raporlarında boyut veya metrik olarak kullanılabilir. Sayısal olmayan olay parametresi verileri için özel boyutları ve sayısal olarak daha iyi temsil edilen herhangi bir parametre verisi için özel metrikleri kullanabilirsiniz. SDK'yı kullanarak özel bir parametreyi günlüğe kaydettikten sonra, bu özel parametrelerin Analytics raporlarında görünmesini sağlamak için boyutu veya metriği kaydedin. Bunu şu yollarla yapın: Analizler > Etkinlikler > Özel Tanımları Yönetin > Özel Boyutlar Oluşturun

    Her rapora uygulanabilecek kitle tanımlarında özel parametreler kullanılabilir. Uygulamanız bir BigQuery projesine bağlıysa, BigQuery'ye aktarılan verilere özel parametreler de dahil edilir. Google Analytics 4 BigQuery Export'ta örnek sorguları ve çok daha fazlasını bulun.

  • value parametresi: value , bir olayla ilgili 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 olay türü tarafından kapsanmayan özel ihtiyaçları varsa, kendi özel olaylarınızı kaydedebilirsiniz. Örneğin, bir oyun geliştiriyorsanız ve bir oyuncunun belirli bir hedefi ne zaman tamamladığını izlemek istiyorsanız, aşağıdaki örneğe benzer bir olay kaydedebilirsiniz:

Web version 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});

Web version 8

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});
tutucu94 l10n-yer

Kontrol panelindeki olayları görüntüleyin

Firebase konsol gösterge tablolarında etkinliklerinizle ilgili toplu istatistikleri görüntüleyebilirsiniz. Bu panolar gün boyunca periyodik olarak güncellenir. Anında test için önceki bölümde açıklandığı gibi logcat çıktısını kullanın.

Bu verilere Firebase konsolundaki Etkinlikler panosundan erişebilirsiniz. Bu gösterge panosu, uygulamanız tarafından günlüğe kaydedilen her farklı olay türü için otomatik olarak oluşturulan olay raporlarını gösterir.