Mobil uygulamada dataLayer karşılığı: Firebase event yapısı

Web tarafında ölçüm kurmuş bir geliştirici uygulamaya geçtiğinde ilk sorduğu soru genellikle şu oluyor: uygulamada dataLayer'a nasıl push ediyoruz.

Cevap kısa: etmiyoruz. Uygulamada dataLayer diye bir yapı yok. Yerine geçen şey var ama aynı şey değil, ve farkı bilmeden yazılan şema altı ay sonra raporda karşılığı olmayan olaylar olarak geri geliyor.

Bu yazı iki yapıyı yan yana koyuyor: neyin karşılığı ne, hangi kurallar geçerli ve kuralı çiğnediğinizde bunu nereden göreceğiniz.

Web'de dataLayer ne yapıyordu

Hatırlatma niyetine tek paragraf. Web'de dataLayer sayfada duran bir dizidir. Siteniz ona bir nesne iter, GTM diziyi dinler, gelen nesneyi okur ve tag'lerini tetikler. Verinin biçimi tamamen size aittir: istediğiniz anahtarı, istediğiniz derinlikte iç içe nesneyle gönderebilirsiniz.

window.dataLayer.push({
  event: 'purchase',
  transaction_id: 'ORD-8841',
  value: 254.90,
  currency: 'TRY',
  items: [{ item_id: 'SKU-4471', price: 249.90, quantity: 1 }]
})

Bu esneklik web'de rahatlık, uygulamada mümkün değil.

Uygulamada karşılığı: logEvent

Uygulamada olayı bir diziye itmiyorsunuz, Firebase SDK'sının logEvent metodunu çağırıyorsunuz. SDK olayı alır, kendi kurallarına göre doğrular ve Analytics'e kendisi gönderir.

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
    param(FirebaseAnalytics.Param.CURRENCY, "TRY")
    param(FirebaseAnalytics.Param.VALUE, 254.90)
    param(FirebaseAnalytics.Param.ITEMS, arrayOf(itemAyakkabi))
}

Swift tarafında aynı olay:

Analytics.logEvent(AnalyticsEventPurchase, parameters: [
  AnalyticsParameterCurrency: "TRY",
  AnalyticsParameterValue: 254.90,
  AnalyticsParameterItems: [ayakkabi]
])

İki kod da aynı işi yapıyor ama web'deki push ile aralarında üç yapısal fark var.

Birinci fark: olay adı nesnenin içinde bir anahtar değil, metodun ilk argümanı. Web'de event anahtarını unutursanız GTM tetiklenmez; uygulamada olay adını vermemek gibi bir ihtimal yok.

İkinci fark: parametreler tipli. Web'de her şeyi string gönderebilirsiniz, uygulamada String, Long ve Double ayrı ayrı belirtilir. Fiyatı string gönderirseniz olay gider, ama gelir raporu boş kalır.

Üçüncü fark: serbest iç içe yapı yok. Web'de istediğiniz derinlikte nesne gönderebilirsiniz. Firebase'de yalnızca e-ticaret için items dizisi destekleniyor, onun dışında düz bir anahtar-değer listesi gönderiyorsunuz.

Kurallar sayılabilir ve hepsi sert

Web'de bir anahtar adının uzunluğunu kimse denetlemez. Firebase'de her sınır tanımlı ve aşıldığında sessizce kırpma değil, veri kaybı oluyor.

Dikkat çeken iki tanesi var.

Parametre değeri 100 karakter. Ürün adını, arama sorgusunu veya ekran başlığını parametre olarak gönderiyorsanız uzun olanlar tamamen düşer. Kırpılıp gönderilmez, hiç gönderilmez.

Kullanıcı özelliği değeri 36 karakter. Bu çok dar bir alan ve oraya e-posta veya kimlik yazmaya çalışan kurulumlar burada takılıyor. Zaten yazmamak gerekiyor, ama teknik sınır da izin vermiyor.

Rezerve önekler

Üç önek Firebase'e ait ve kullanılamaz: firebase_, google_, ga_.

Bu, tahmin edilebilir bir kural gibi görünüyor ama pratikte google_ads_id veya ga_session gibi adlar yazan kurulumlar görüyoruz. O parametreler sessizce reddedilmiyor, aşağıdaki mekanizmayla işaretleniyor.

Kuralı çiğnediğinizde Firebase size söylüyor

Bu bölüm yazının asıl sebebi, çünkü çoğu ekip bu mekanizmayı bilmiyor ve şema hatalarını aylar sonra fark ediyor.

Firebase geçersiz bir olay veya parametre aldığında sessiz kalmıyor. error adında bir olay basıyor ve içine ne olduğunu yazıyor: firebase_error parametresinde hata kodu, firebase_error_value parametresinde soruna yol açan ad.

Sık karşılaşılan kodlar ve anlamları:

Bu kontrolü ilk kez yapan hesaplarda genellikle bir şey çıkıyor. Kötü haber gibi görünüyor ama tersi doğru: hata görünür olduğu anda düzeltilebilir hale geliyor.

E-ticaret dizisi tek istisna

Serbest iç içe yapı yok dedik, bir istisnası var: e-ticaret olaylarında ürün listesi. Kotlin tarafında ürünler Bundle dizisi olarak, Swift tarafında sözlük dizisi olarak gönderiliyor.

val itemAyakkabi = Bundle().apply {
    putString(FirebaseAnalytics.Param.ITEM_ID, "SKU-4471")
    putString(FirebaseAnalytics.Param.ITEM_NAME, "Kosu ayakkabisi")
    putString(FirebaseAnalytics.Param.ITEM_CATEGORY, "ayakkabi")
    putDouble(FirebaseAnalytics.Param.PRICE, 249.90)
    putLong(FirebaseAnalytics.Param.QUANTITY, 1)
}

Ürün seviyesinde 27 özel parametreye kadar alan var, yani ürün kırılımını genişletmek mümkün. item_id değerinin Merchant Center feed'indeki item_id ile aynı olması gerektiğini hatırlatalım: aynı değilse feed'e bağlı kampanya tipleri ürün seviyesinde eşleşmez.

Şema tasarımında tek kural

Sınırlara bakınca çıkan sonuç şu: az sayıda olay adı, çok sayıda parametre.

Uygulamanın her düğmesine ayrı bir olay adı vermek 500 sınırını zorlar, raporu okunmaz hale getirir ve Ads tarafında dönüşüm eşlemesini karmaşıklaştırır. Aynı bilgi tek bir olay adı ve ayırt edici bir parametreyle çok daha iyi taşınır.

Alttaki satır standart raporlarda görünür, üstteki üç satır özel olay olarak kalır ve çoğu raporda hiç çıkmaz.

Doğrulama

2error olayı basılıyor mu?GA4

Nerede

Analytics'te Olaylar raporu, arama kutusuna error yazın.

Doğru cevap

error olayı listede hiç yok.

Yanlışsa

Sayısı sıfırdan büyükse firebase_error_value kırılımını ekleyin, hangi ad yüzünden olduğu orada yazıyor.

3Parametre değerleri doğru tipte mi?GA4

Nerede

Analytics'te ilgili olayın detayı, value ve currency parametreleri.

Doğru cevap

Gelir toplamı sıfırdan büyük ve mağaza raporundaki büyüklüğe yakın.

Yanlışsa

Gelir sıfır görünüyorsa değer metin olarak gönderiliyor olabilir. Kod tarafında Double kullanıldığını doğrulayın.

Sonuç

dataLayer esnektir, logEvent kuralcıdır. Web'de çalışan bir şemayı uygulamaya olduğu gibi taşımak, sınırlara takılan ve raporda karşılığı olmayan bir kurulum üretiyor.

İyi haber şu: Firebase kural çiğnendiğinde susmuyor. error olayı ve firebase_error parametresi zaten hesabınızda duruyor, yalnızca kimse oraya bakmıyor. Şemayı kurmadan önce sınırları bilin, kurduktan sonra o tek raporu kontrol edin.

Olayların GTM tarafında nasıl yönetildiği ve container'ın iOS ile Android'e nasıl kurulduğu ayrı bir konu: onu GTM ile iOS ve Android'de olay takibi rehberinde adım adım yazdık.