Bu kılavuzda, uygulamanızdaki etkinlikleri nasıl günlüğe kaydedeceğiniz gösterilmektedir.
Etkinlikler, uygulamanızda neler olduğuna dair analizler sağlar (ör. kullanıcı işlemleri, sistem etkinlikleri veya hatalar).
Analytics bazı etkinlikleri sizin için otomatik olarak kaydeder. Bu etkinlikleri almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın başka veriler de toplaması gerekiyorsa uygulamanıza 500 farklı türde Analytics Etkinlik türü kaydedebilirsiniz. Uygulamanızın kaydettiği etkinliklerin toplam hacminin 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 oluşturduğunuzdan ve Analytics'i kullanmaya başlama bölümünde açıklandığı şekilde Analytics'e erişebildiğinizden emin olun.
Günlük etkinlikleri
firebase.analytics() örneğini yapılandırdıktan sonra logEvent() yöntemiyle etkinlikleri günlüğe kaydetmeye başlayabilirsiniz. Google Analytics ile zaten aşina iseniz bu yöntem, gtag.js'de event komutunu kullanmaya eşdeğerdir.
Başlamanıza yardımcı olmak için Analytics SDK'sı, perakende ve e-ticaret, seyahat ve oyun uygulamaları da dahil olmak üzere farklı uygulama türleri arasında yaygın olan çeşitli önerilen etkinlikler tanımlar. Bu etkinlikler hakkında ve bunları ne zaman kullanacağınız hakkında daha fazla bilgi edinmek için Önerilen etkinlikler başlıklı makaleyi inceleyin.
Not: Raporlarda maksimum düzeyde ayrıntı elde etmek için uygulamanız için anlamlı olan önerilen etkinlikleri ve bunların belirlenmiş parametrelerini günlüğe kaydedin. Ayrıca, kullanıma sunulduğu andan itibaren en yeni Google Analytics özelliklerinden yararlanabilirsiniz.
Çeşitli etkinlikler ve parametreleriyle ilgili uygulama ayrıntılarını gtag.js etkinlik referansında bulabilirsiniz.
Aşağıdaki örnekte, bir select_content etkinliğinin nasıl günlüğe kaydedileceği gösterilmektedir:
Web
import { getAnalytics, logEvent } from "firebase/analytics";
const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
content_type: 'image',
content_id: 'P12453'
});
Web
analytics.logEvent('select_content', {
content_type: 'image',
content_id: 'P12453',
items: [{ name: 'Kittens' }]
});
Önerilen parametrelere ek olarak, tüm etkinliklere aşağıdaki parametreleri 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 tüm parametre verileri için özel metrikleri kullanabilirsiniz. SDK'yı kullanarak bir özel 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 şuradan yapabilirsiniz: Analytics > Etkinlikler > Özel Tanımlamaları Yönet > Özel Boyut Oluştur
Özel parametreler, her rapora uygulanabilecek kitle tanımlarında kullanılabilir. Uygulamanız bir BigQuery projesine bağlıysa özel parametreler, BigQuery'ye aktarılan verilere de dahil edilir. Örnek sorguları ve daha fazlasını Google Analytics 4 BigQuery Export'ta bulabilirsiniz.
valueparametresi:value, bir etkinlikle ilgili önemli bir metriği toplamak için yararlı olan genel amaçlı bir parametredir. Gelir, mesafe, süre ve puanlar buna örnek verilebilir.
Uygulamanızda, önerilen bir etkinlik türü tarafından karşılanmayan belirli ihtiyaçlar varsa kendi özel etkinliklerinizi günlüğe 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 etkinlik günlüğe kaydedebilirsiniz:
Web
import { getAnalytics, logEvent } from "firebase/analytics";
const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});
Web
analytics.logEvent('goal_completion', { name: 'lever_puzzle'});
Etkinlikleri kontrol panelinde görüntüleme
Etkinliklerinizle ilgili toplu istatistikleri Firebase konsolu kontrol panellerinde görüntüleyebilirsiniz. Bu gösterge tabloları gün içinde düzenli aralıklarla güncellenir. Anında test etmek için, logcat çıkışlarını önceki bölümde açıklandığı şekilde kullanın.
Bu verilere Firebase konsolundaki Etkinlikler kontrol panelinden erişebilirsiniz. Bu kontrol paneli, uygulamanız tarafından günlüğe kaydedilen her farklı etkinlik türü için otomatik olarak oluşturulan etkinlik raporlarını gösterir.