Rehber

GA4 olay yapısı: Otomatik, önerilen ve özel olaylar

Otomatik toplanan, gelişmiş ölçüm, önerilen ve özel olaylar arasındaki fark. Hangi sırayla kullanılır, Türkçe ad sorun çıkarır mı, yapı nasıl doğrulanır?

Fratres Editör · 11 Kasım 2026

GA4 olay yapısı, Google Analytics 4'ün sitedeki her ölçümü bir olay (event) ve ona eklenen parametreler olarak kaydetme biçimidir. Olaylar dört gruba ayrılır: Kendiliğinden toplananlar, gelişmiş ölçümle açılanlar, adını ve parametresini Google'ın önceden tanımladığı önerilenler ve sizin tasarladığınız özel olaylar. Sağlıklı yapı önce hazır olanı kullanır, özel olayı en sona bırakır.

Olay ve parametre birlikte nasıl çalışır?

Olay, ne olduğunu söyler: Sayfa görüntülendi, form gönderildi, ürün sepete eklendi. Parametre ise bağlamı taşır: Hangi sayfa, hangi form, hangi ürün. Otomatik toplanan olaylar sayfasına göre web akışında her olayla birlikte dil, sayfa adresi, yönlendiren adres, sayfa başlığı ve ekran çözünürlüğü gibi parametreler kendiliğinden gider.

Sizin eklediğiniz parametreler toplanır ama raporda kendiliğinden görünmez. Onları özel boyut veya özel metrik olarak kaydetmeniz gerekir. Google kayıttan sonra raporlamanın 24-48 saat içinde başladığını yazıyor. Kapsam seçimi de önemlidir. Olay kapsamı tek bir etkileşimi, kullanıcı kapsamı kişinin özelliğini, öğe kapsamı e-ticaret olayındaki ürün satırını anlatır.

Sınırlar yapının çerçevesini çizer. Toplama sınırlarına göre bir olay en çok 25 parametre taşır, olay ve parametre adları 40 karakteri geçemez. Mülk başına 25 kullanıcı özelliği tanımlanabilir. Web akışlarında farklı olay adı sayısına sınır yok, uygulama akışlarında ise kullanıcı başına 500.

Hangi olaylar siz bir şey yapmadan gelir?

Otomatik toplanan olaylar

Google etiketi siteye yüklendiği anda bazı olaylar kendiliğinden oluşur. first_visit ilk ziyareti, session_start oturumun başlangıcını işaretler. user_engagement ise sayfa en az bir saniye odakta kaldığında gönderilir. Bu olayları siz kurmazsınız, ama adlarını özel olaylarınızda kullanamazsınız.

Gelişmiş ölçüm olayları

Gelişmiş ölçüm, veri akışı ayarlarından açılıp kapatılan bir grup olaydır. Davranışları ve sınırları şöyle:

page_view: Kapatılamaz. Sayfa yüklendiğinde ve tarayıcı geçmişi değiştiğinde gönderilir. Tek sayfa uygulamalarında geçmiş değişikliğini sayma ayarı ayrıca yönetilir.
scroll: Sayfanın %90 dikey derinliği ilk kez göründüğünde, sayfa başına bir kez gönderilir. Okuma derinliğini kademeli ölçmez.
click: Başka alan adına giden bağlantılar için gönderilir. Alanlar arası ölçüme eklenmiş alan adları sayılmaz.
view_search_results: Site içi arama, adresteki q, s, search, query veya keyword parametresinden anlaşılır. Sitenizin arama parametresi farklıysa ayarlardan eklenir.
video_start, video_progress, video_complete: Yalnız JavaScript API desteği açık YouTube gömmelerinde çalışır. İlerleme olayı sürenin %10, %25, %50 ve %75 noktalarında gider.
file_download: Belge, tablo, sunum, arşiv, video ve ses gibi yaygın uzantılara giden tıklamalarda gönderilir.
form_start, form_submit: Oturumdaki ilk form etkileşiminde ve gönderimde tetiklenir. Parametreleri raporda kullanmak için özel boyut gerekir.

Toplama sınırları sayfası, otomatik ve gelişmiş ölçüm olaylarının farklı olay adı sınırına sayılmadığını da belirtiyor.

Önerilen olay mı, özel olay mı?

Önerilen olayları neden önce kullanmalısınız?

Google'ın tanımına göre önerilen olaylar sizin uyguladığınız, ama adı ve parametreleri önceden belirlenmiş olaylardır. Hazır adı kullanmak, bugünkü ve gelecekteki rapor özelliklerinin bu veriyi tanımasını sağlar. Aynı eylemi kendi adınızla gönderirseniz o özelliklerden yararlanamazsınız.

Önerilen olaylar listesi dört gruba ayrılır:

Tüm mülkler: login, sign_up, search, share, select_content, generate_lead, purchase, refund.
Online satış: view_item_list, select_item, view_item, add_to_cart, view_cart, begin_checkout, add_shipping_info, add_payment_info, purchase.
Potansiyel müşteri: generate_lead, qualify_lead, disqualify_lead, working_lead, close_convert_lead, close_unconvert_lead. Google bu grubu çevrim içi ve çevrim dışı talep hunisinin tamamını ölçmek için öneriyor. Satış ekibinin CRM'de işaretlediği aşamalar da bu adlarla gönderilebilir.
Oyunlar: level_start, level_up, post_score, unlock_achievement gibi olaylar.

Önerilen olayın parametrelerini de değiştirmeden kullanın. Olay referansında purchase için transaction_id ve items zorunludur. value gönderiliyorsa currency de gönderilmelidir, yoksa gelir metrikleri doğru hesaplanmaz.

Özel olay ne zaman gerekir?

Yalnız hiçbir hazır olay ihtiyacı karşılamadığında. Google bunu açıkça öneriyor ve özel olayların standart raporların çoğunda görünmediğini hatırlatıyor. Bu olayları keşiflerde veya özel raporlarda incelersiniz.

Varsayımsal örnek: Bir yazılım şirketi, fiyat sayfasındaki plan karşılaştırma aracının kullanılıp kullanılmadığını bilmek istiyor. Önerilen listede buna karşılık yok. compare_plans adlı bir olay ve plan_type, page_type parametreleri yeterli olur. Her plan için ayrı olay adı açmak gerekmez, fark parametrede taşınır.

Adlandırma kurallarının özü şöyle:

Ad bir harfle başlar, yalnız harf, rakam ve alt çizgi içerir, boşluk içermez.
Adlar büyük küçük harfe duyarlıdır. my_event ile My_Event iki ayrı olaydır.
page_view, session_start, first_visit gibi ayrılmış adlar özel olay olarak kullanılamaz.
Parametre adları alt çizgi, firebase_, ga_, google_ veya gtag. ile başlayamaz.

Hatalı adı arayüzden düzeltmek mümkün, ama bu bir yama yöntemidir. Olay değiştirme özelliği en çok 50 olayı değiştirmeye ve 50 yeni olay türetmeye izin veriyor. Değişiklikler geçmiş veriye uygulanmıyor ve devreye girmesi bir saat veya daha uzun sürebiliyor. Kalıcı düzeltme etiketin kendisinde yapılır.

Türkçe olay adı sorun çıkarır mı?

Google'ın kural sayfası olay adlarında İngilizce dışındaki kelime ve harflerin kullanılabileceğini yazıyor. Yani teknik olarak form_gönderildi bir olay adı olabilir. Yine de iki nedenle İngilizce veya Türkçe karaktersiz ad seçmek daha güvenlidir.

Birincisi tutarlılık. Önerilen olaylar İngilizcedir. Satın alma purchase, form ise form_gonderildi olursa listeniz iki dilde okunur ve ekip içinde aynı eyleme iki ad verilme olasılığı artar.

İkincisi harf dönüşümü. MDN'nin belgesine göre Türkçe gibi bazı dillerde büyük küçük harf eşlemesi Unicode varsayılanından farklı sonuç verebilir. Belgedeki örnekte İstanbul kelimesi Türkçe ayarla küçültülünce sade bir istanbul, ABD İngilizcesi ayarıyla i harfinin üstüne ayrı bir nokta işareti eklenmiş bir biçim olarak çıkıyor. Ekranda aynı görünen bu iki yazım, bilgisayar için farklı karakter dizileridir. Kodda yerel ayara bağlı harf dönüşümü yapılıyorsa aynı ad iki ayrı olay olarak kaydedilebilir. GA4 adları büyük küçük harfe duyarlı olduğu için bu fark raporu böler.

Yapıyı adım adım kurmak

Gelişmiş ölçümü gözden geçirin. Hangi seçeneklerin açık olduğuna, site arama parametrenizin listede bulunup bulunmadığına bakın.
Eylemleri hazır adlarla eşleştirin. GA4 ölçüm planındaki her eylemi önce önerilen listeyle karşılaştırın.
Kalanları tasarlayın. Özel olayları kurala uygun, tek dilde ve tek biçimde adlandırın. Değişen bilgiyi addan çıkarıp parametreye taşıyın.
Parametreleri kaydedin. Raporda kullanılacak her parametre için doğru kapsamla özel boyut açın.
Önemli olanları işaretleyin. İş sonucunu gösteren az sayıda olayı anahtar etkinlik yapın.
Test edin. DebugView üzerinde her olayı tetikleyin, adı ve parametre değerlerini kontrol edin.
Belgeleyin. Olay adı, tetiklenme koşulu, parametreler ve sorumlu kişiyi tek listede tutun.

Sık yapılan hatalar

Çift form olayı. Gelişmiş ölçümün form_submit olayı açıkken Etiket Yöneticisi'nde aynı form için ikinci bir olay kurmak gönderimleri iki kez sayar. Birini seçin.
Çift sayfa görüntüleme. Tek sayfa uygulamasında geçmiş değişikliği ayarı açıkken elle de page_view göndermek.
Değeri ada gömmek. click_header_blue, click_footer_red gibi adlar yerine tek bir olay ve konum parametresi kullanın.
Hazır parametreyi yeniden adlandırmak. value yerine tutar, items yerine urunler göndermek, e-ticaret raporlarını boş bırakır.
Kişisel veriyi parametreye koymak. E-posta, telefon veya açık adres hiçbir parametrede yer almamalı.
Özel olayı standart raporda aramak. Görünmemesi hata değildir, keşif açmanız gerekir.

Yapının doğru çalıştığını nasıl ölçersiniz?

DebugView tek tek olayları gösterir, yapının sağlığını ise oranlar anlatır. Etkinlikler raporundan aylık şu kontrolleri yapın:

form_start ile form_submit oranı. Gönderim başlatmadan fazlaysa olaylardan biri yanlış tetikleniyordur.
Oturum başına page_view. Ani sıçrama çoğu zaman çift gönderimi gösterir.
purchase sayısı ile sipariş sistemi. Aradaki fark rıza ve engelleyicilerle açıklanabilir bir oranda kalmalı. Aynı transaction_id iki kez görünüyorsa tekilleştirme çalışmıyordur.
Boş parametre oranı. Kayıtlı bir boyutta değer sık sık boş geliyorsa parametre her durumda gönderilmiyordur.

Ham olay düzeyinde kontrol için GA4 BigQuery aktarımı en esnek yoldur. Olay yapısını raporlama ve karar süreçleriyle birlikte ele almak isteyenler için analitik çalışması bu kontrolleri düzenli bir takvime bağlar.

Yarın olay listenizi sayın

Etkinlikler raporunu açın ve son 30 günün olay adlarını bir tabloya aktarın. Her adın yanına türünü yazın: Otomatik, gelişmiş ölçüm, önerilen veya özel. Özel olarak işaretlediklerinizi önerilen listeyle bir kez daha karşılaştırın. Karşılığı olanlar için geçiş planı, büyük küçük harf veya dil farkıyla ikiye bölünmüş adlar için düzeltme notu çıkarın. Bu tablo, yeni olay eklemeden önce bakılacak ilk belge olur.