Yazılarımız

OfisData

GA4 EVENT PARAMETRE TASARIMI YAPMAK

Turuncu sarı GA4 logosu büyük navy süslü parantez JSON kod kartı içinde event_name ve parameters anahtarları snake_case satırlar event parametre tasarım sembolü

GA4 event modeli güçlü ama o gücü serbest bırakmak için doğru parametre tasarımı gerek. Aynı kavramı bazen "form_id" bazen "formId" bazen "form-id" diye yazan ekipler raporda "ne anlamı var bu sayıların" diye dolaşır. İsimlendirme tutarsızlığı altın değerinde veriyi kullanılamaz hale getirir.

İyi event parametre tasarımı üç şeyi yapar: tutarlı isimlendirme kuralı, doğru veri tipi seçimi ve custom dimension/metric eşleştirmesi. Bu üçü olmadan GA4 zengin veri toplar ama analiz aşamasında kafa karışıklığı yaratır.

Aşağıda event parametre tasarımının prensiplerini, custom dimension kurulumunu ve isimlendirme standardını anlatıyoruz.

Event ve parametre nedir?

GA4'te her etkileşim bir event'tir. Her event 0+ parametre taşır. Örnek:

  • Event: page_view
  • Parametreler: page_location, page_title, page_referrer

Parametreler event'e bağlam katar. "Sayfa görüntülendi" yetmez; "hangi sayfa" sorusunun cevabı parametrede. Otomatik toplanan parametrelerin tam listesi ve karakter sınırları için analitik yardım kaynakları referans alınabilir.

İsimlendirme kuralları (Google standardı)

GA4 event ve parametre isimlerinde belirli kurallar var:

  • Sadece harf, rakam ve alt çizgi: video_play ✓, video-play
  • Harf ile başlamalı: 3d_model ✗, model_3d
  • 40 karakter sınırı (event): Çok uzun isimler kabul edilmez
  • 100 karakter sınırı (parametre): Parametre adları için
  • Case-sensitive değil: Purchase ile purchase farklı (GA4 büyük/küçük harf farkı yapar; karışıklık önlemek için snake_case standart)

İsimlendirme tutarlılığı

Pratikte tüm ekip tek bir standart kullanmalı:

snake_case (önerilen)

page_view
add_to_cart
form_submitted
button_clicked

Google standart event'leri snake_case. Aynı kuralı custom event'ler için de uygulayın; tutarlılık kritik.

İsim yapısı: action_object

Net pattern: ne yapıldı + neye yapıldı.

  • add_to_cart: Sepete eklendi (add + cart)
  • view_item: Ürün görüntülendi (view + item)
  • begin_checkout: Ödeme başlatıldı (begin + checkout)
  • complete_signup: Kayıt tamamlandı (complete + signup)

"item_added" yerine "add_to_cart" gibi tutarlı pattern; pasif değil aktif fiil.

Otomatik vs custom parametreler

GA4 her event'e otomatik bazı parametreler ekler:

  • page_location
  • page_title
  • page_referrer
  • language
  • screen_resolution
  • session_id
  • session_engaged

Custom parametreler bunların üstüne eklenir. Örnek custom parametreler:

  • form_id
  • product_category
  • video_progress
  • filter_value
  • error_type

Custom dimension ve custom metric

GA4 panelinde raporlamak için parametre tek başına yetmez; custom dimension olarak kayıt edilmesi gerek.

Custom dimension

Kategorik veri için. "Hangi form?", "Hangi kategori?", "Hangi seviye?" gibi.

Admin > Custom definitions > Create custom dimension. Parametre adıyla eşleştirilir; bir kez tanımlanınca raporda boyut olarak görünür.

Custom metric

Sayısal veri için. "Skor", "okuma süresi", "video süresi" gibi.

Admin > Custom definitions > Create custom metric.

Sınırlar

  • 50 event-scoped custom dimension
  • 25 user-scoped custom dimension
  • 50 custom metric

Ücretsiz GA4'te bu sınırlar geçerli. GA4 360'ta yükseltilir.

GA4 Admin Custom definitions Custom dimensions paneli ekran görüntüsü Dimension name Event parameter Scope tablosu event-scoped user-scoped satırlar form_id product_category video_title user_role subscription_tier

Event scope vs user scope

Event-scoped parametreler

Her event için ayrı değer. Örnek: "form_id" her form gönderimi event'inde farklı değer alabilir.

User-scoped parametreler

Kullanıcıya bağlı; tüm sessions'larda aynı kalır. Örnek: "user_role" (admin, member, guest), "subscription_tier" (free, premium).

user_properties ile set edilir:

gtag('set', 'user_properties', {
  'subscription_tier': 'premium',
  'signup_source': 'organic_search'
});

Parametre tasarım kuralları

1. Verbose değil compact

Parametre adı kısa ve net olsun.

  • category
  • which_category_is_this

2. Standartlaştırılmış değerler

Bir parametre 'mobile', 'Mobile', 'MOBILE', 'mob' gibi farklı değerler almamalı. Tüm ekip aynı standart değerleri kullanmalı:

  • device_type: mobile, tablet, desktop (sadece bu üç değer)
  • traffic_source: organic, paid, social, email (sabit liste)

3. ID'leri tutarlı

product_id veya item_id; SKU veya database ID. Tek tip seçin ve her event'te aynı şekilde gönderin.

4. PII (kişisel veri) göndermeyin

E-posta, isim, telefon, IP gibi kişisel veri GA4 parametresine konulmaz. KVKK ihlali; ayrıca GA4 PII içeren property'leri kalıcı silebilir. Hashleme veya kullanıcı ID kullanın.

Event tasarım dokümanı

Ekibinizin GA4 event listesini bir dokümanda tutması kritik. Yapı:

Event adıTetikleme zamanıParametrelerCustom dimension?
page_viewOtomatikpage_location, page_title
form_submitForm gönderildiğindeform_id, form_nameEvet
video_playVideo başlatıldığındavideo_title, video_durationEvet
scroll%90 scrollscroll_depthHayır (zaten ölçülüyor)

Bu doküman Notion, Confluence veya Google Sheets'te tutulur. Yeni event eklenmek istendiğinde önce dokümanda yer alır; sonra implementasyon yapılır.

Parametre debug etme

Yeni parametre eklendikten sonra:

  1. DebugView'da event tetiklenmesini izle
  2. Parametre adı ve değeri doğru görünüyor mu?
  3. Custom dimension olarak kayıtlı mı?
  4. 24 saat sonra Reports > Engagement > Events raporunda görünüyor mu?

Custom dimension verilerinin raporlarda görünmesi 24-48 saat sürer; sabırlı olun.

Dikkat Edilecek Tuzaklar

  1. Tutarsız isimlendirme. Aynı kavram farklı isimlerle; analiz imkansız
  2. Custom dimension kaydetmemek. Parametre toplanır ama raporlarda görünmez
  3. PII gönderme. KVKK ihlali ve property silinme riski
  4. Çok fazla event. Anlamlı olmayan onlarca event raporu kirletir
  5. Standart event'leri yeniden adlandırma. "purchase" varken "satin_alma" yazmak; e-ticaret raporları çalışmaz
  6. Test ortamı verisi production'a karışır. Internal traffic exclusion zorunlu
Event tasarım dokümanı şablon tablo Event name Trigger Parameters Custom dimension kolonlar page_view form_submit video_play scroll add_to_cart satırlar tutarlı snake_case isimlendirme

Atılması Gereken Adım

GA4 event parametre tasarımı modern web analitiğinin temel disiplini. snake_case isimlendirme, custom dimension kaydı ve scope seçimini panel üzerinde pratiğe çeviren Google Analytics eğitim programı ekip içinde tutarlı bir veri sözlüğü kurmayı kolaylaştırır.

Çıkarımlar

GA4 event parametre tasarımı; tutarlı isimlendirme (snake_case + action_object), custom dimension kaydı, scope seçimi (event vs user) ve standart değer listeleri ile yapılır. PII asla parametre olarak gönderilmez. Event tasarım dokümanı ekip içi tutarlılığı sağlar. Doğru tasarım GA4'ün gücünü ortaya çıkarır; tutarsızlık ise zengin veriyi kullanılamaz hale getirir.

 Vimaj