- Konu sahibi
- #1
GA4 olay parametresi nedir?
GA4 olay parametresi, bir olay gerçekleştiğinde o olayın ayrıntılarını Google Analytics 4'e gönderen anahtar-değer bilgisidir. Olay, "form_gonderildi" gibi eylemin kendisini belirtirken parametre, bu eylemin hangi formda, hangi sayfada veya hangi değerle gerçekleştiğini açıklar. Örneğin
form_gonderildi olayı, form_adi=iletisim ve sayfa_turu=hizmet parametreleriyle gönderilebilir.Nasıl çalışır?
Bir olay gönderilirken parametre adı ve değeri birlikte taşınır. Parametre adı raporlarda kullanılacak anlamlı bir anahtar, değer ise o olaya ait bilgidir. Aynı parametre farklı olaylarda kullanılabilir; ancak anlamı her olayda tutarlı olmalıdır.
Örneğin bir ürün görüntülendiğinde:
Kod:
event_name: urun_goruntulendi
urun_id: A-104
urun_kategorisi: ayakkabi
liste_konumu: ana_sayfaBu blok kavramsal alan listesidir; doğrudan çalıştırılan JavaScript değildir. Burada
urun_goruntulendi özel olayın adı, diğer üç alan ise olay parametreleridir. Parametre, tek başına yeni bir olay oluşturmaz; var olan olayın bağlamını zenginleştirir.GA4'ün bazı standart olaylarında beklenen parametreler bulunur. Örneğin satın alma olayında işlem kimliği, para birimi ve değer gibi alanlar kullanılabilir. Bu alanların doğru olay adı ve beklenen parametre adıyla gönderilmesi, GA4'ün ilgili veriyi doğru yorumlaması açısından önemlidir. Kendi belirlediğiniz parametreler ise özel parametrelerdir. Örnekteki Türkçe özel olay otomatik olarak GA4 e-ticaret raporunu doldurmaz; ürün görüntüleme raporu için önerilen
view_item ve onun items gibi beklenen alanları kullanılmalıdır.Somut örnek ve doğru karar
Bir iletişim formunun gönderildiğini ölçmek istediğinizi varsayalım. Sadece
form_gonderildi olayını göndermek, kaç gönderim olduğunu gösterir. Kullanıcıların hangi formu gönderdiğini ayırt etmek istiyorsanız buna form_adi parametresini eklersiniz. Formun bulunduğu sayfa türünü de karşılaştırmak istiyorsanız sayfa_turu ayrı bir parametre olabilir.Parametre seçerken şu ayrımı kullanın:
| İhtiyaç | Uygun yapı | Örnek |
|---|---|---|
| Kullanıcının yaptığı eylem | Olay adı | form_gonderildi |
| Eylemin ayrıntısı | Olay parametresi | form_adi=iletisim |
| Kullanıcıya ait ve oturumlar arasında anlamlı özellik | Kullanıcı özelliği | uyelik_turu=premium |
| Sayısal olarak toplanacak veya ölçülecek değer | Uygun sayısal parametre ve gerektiğinde özel metrik | siparis_tutari=1250 |
Parametre, kullanıcı özelliğiyle karıştırılmamalıdır. Örneğin
buton_rengi, bir tıklama olayının ayrıntısıysa olay parametresidir. Kullanıcının üyelik türü ise birçok olayda geçerli olabileceğinden kullanıcı özelliği olarak daha uygun olabilir.Etikete gönderim parçası
Google etiketi ve uygun ölçüm hedefi önceden yüklenmişse, izin/ölçüm yapılandırmanız kapsamında uygulamanın gerçek başarılı form yanıtından sonra şu parça kullanılabilir:
Kod:
gtag('event', 'form_gonderildi', {
form_adi: 'iletisim',
sayfa_turu: 'hizmet'
});Bu parça formu göndermez veya başarısını doğrulamaz. Yalnız düğme tıklamasına bağlanırsa doğrulama hatası veren denemeleri de başarılı gönderim sanabilirsiniz. E-posta, telefon, ad veya serbest mesaj içeriğini parametreye koymayın.
Uygulama ve kontrol adımları
- Ölçmek istediğiniz eylemi tek ve açık bir olay adıyla belirleyin. Örneğin
form_gonderildiolayını, formun gerçekten başarıyla gönderildiği anda tetikleyin. - Olayı açıklamak için yalnızca gerekli parametreleri seçin.
form_adigibi sabit anlamı olan, raporlarda karşılaştırılabilir adlar kullanın. - Parametre adlarını tüm gönderimlerde aynı yazın.
form_adiileformAdiaynı ad değildir; yazım standardını baştan belirleyin. - Olayı web etiketi, Google Etiket Yöneticisi veya kullandığınız ölçüm entegrasyonu üzerinden gönderin. Değer türünü de amacına uygun seçin; sayısal analiz yapılacak değerleri metin olarak göndermeyin.
- GA4'ün hata ayıklama görünümünde olayın geldiğini ve parametre değerinin beklediğiniz gibi olduğunu kontrol edin. Olay görünmüyorsa tetikleyici veya ölçüm kimliği; olay görünüyor fakat parametre yoksa parametre eşlemesi incelenmelidir.
- Özel parametreyi raporlarda boyut ya da metrik olarak kullanacaksanız GA4 yönetim alanında ilgili özel tanımı oluşturun. Tanım oluşturulmamış bir parametrenin gönderilmiş olması, onun otomatik olarak her raporda seçilebilir olacağı anlamına gelmez.
DebugView’da doğru olay ve
form_adi=iletisim görülmesi ölçüm verisinin alındığını gösterir; formun arka uçta gerçekten kaydedildiğini tek başına kanıtlamaz. Olay görünüyor ancak bu alan boşsa kodda veya etiket yapılandırmasında parametre anahtarı yanlış olabilir. Parametre yalnız bazı olaylarda geliyorsa tetikleyicinin farklı sayfa ya da form akışlarında aynı veriyi üretip üretmediğini kontrol edin.Sık yapılan hatalar
En yaygın hata, her ayrıntıyı ayrı bir olay adı yapmak ve parametre kullanmamaktır.
iletisim_formu, teklif_formu ve destek_formu gibi çok sayıda olay yerine, iş akışı uygunsa form_gonderildi olayını form_adi parametresiyle göndermek daha düzenli analiz sağlar.Diğer bir hata, aynı anlam için farklı parametre adları kullanmaktır. Ayrıca parametreye kişisel veri koymak, gereksiz uzun veya değişken metinler göndermek ve sayısal tutarları metin biçiminde aktarmak raporlama kalitesini bozabilir. Olay ve parametre adlarını küçük bir ölçüm planında önceden tanımlamak, bu sorunları azaltır.
Sık sorulan sorular
Bir olay parametresi raporda hemen görünür mü?
Gönderimin hata ayıklama ekranında görünmesiyle standart raporlarda kullanılabilir olması aynı şey değildir. Özel parametreyi rapor boyutu veya metriği olarak kullanmak için GA4 içinde uygun özel tanımı ayrıca oluşturmanız gerekebilir.
Aynı parametreyi birden fazla olayda kullanabilir miyim?
Evet; ancak parametrenin anlamı ve değeri olaylar arasında tutarlı olmalıdır. Örneğin
sayfa_turu her olayda aynı sınıflandırmayı ifade etmeli, bir olayda kategori diğerinde kampanya adı olarak kullanılmamalıdır.Parametre ile olay arasındaki fark nedir?
Olay, gerçekleşen eylemi tanımlar; parametre ise bu eylemin ayrıntısını taşır.
urun_goruntulendi eylem, urun_id=A-104 ise o eyleme ait ayrıntıdır.