Web Analytics · Google Tag Manager
Web dataLayer Kurulumu
Bir tag yalnızca sayfanın gönderdiğini okuyabilir; bu yüzden gönderim, tag kurulmadan önce tanımlanır.
Bir tag manager, sitenin dataLayer'a göndermediği veriyi okuyamaz. Her payload'ı geliştiricinin ek açıklamaya ihtiyaç duymadan uygulayabileceği açıklıkta tanımlar, tag'ler bu veriye bağlanmadan önce çıktıyı doğrularız. Elinizde geliştiricilerin tek spesifikasyondan uygulayabildiği, tag'lerin zamanlamayı tahmin etmeden kullanabildiği bir dataLayer kalıyor.


Birlikte çalıştığımız 500'den fazla markadan birkaçı
Tüm referansları görNasıl yürütürüz?
Onaylı event listesini uygulanabilir dataLayer sözleşmesine dönüştürürüz
Önce uygulanabilir spesifikasyonu yazar, ardından gerçek çıktının bu sözleşmeye uyduğunu test ederiz. Spesifikasyon, uygulama desteği ve staging testi dört adımda tamamlanır.
Çalışma ilkelerimiz
- Her payload'ı uygulamaya hazır biçimde tanımlarız — Her event için obje yapısını, alan adlarını, veri tiplerini, zorunlu ve opsiyonel değerleri açıkça belirtiriz.
- Push zamanlamasını belirleriz — Her push'un sayfa yüklenmesi, navigasyon ve asenkron içerikle ilişkili zamanını tanımlarız. Çok erken gönderilen push, onu bekleyen tag tarafından kaçırılabilir.
- Sayfa yenilenmeyen akışları ayrıca ele alırız — Tam sayfa yenilemesi olmayan sitelerde sanal sayfa görüntülemelerinin ve state değişikliklerinin doğru push edilmesini sağlarız.
- Gerçek kodu spesifikasyonla karşılaştırırız — Yalnızca browser'daki dataLayer çıktısını değil, production'a alınmadan önce kodu ya da pull request'i de inceleriz.
Event listesini doğrulama
Ekibinizin üzerinde anlaştığı iş aksiyonları ve event adlarıyla başlarız. Bu aşamada yeni event adı üretmeyiz. Bir kişi, kapsama yeni event eklenmediğini doğrular.
Doğrulanmış event listesi


Teknik spesifikasyonu yazma
Her event için payload yapısını, zamanlamayı ve uç durumları geliştiricilerin doğrudan kullanabileceği bir dokümanda tanımlarız. Bir mühendis, spesifikasyonu gerçek sayfa davranışı ve zamanlamayla karşılaştırır.
dataLayer spesifikasyonu


Uygulamayı destekleme
Geliştirme sırasında soruları yanıtlar, production öncesinde kodun yazılı sözleşmeye uyup uymadığını inceleriz. Gerçek kodu yayın öncesinde bir uzman gözden geçirir.
Uygulama gözden geçirme notları


Staging'de test etme
Production'a geçmeden önce browser araçlarıyla dataLayer çıktısını yazılı spesifikasyonla karşılaştırırız. Bir kişi, sonucu gerçek browser araçlarında doğrular.
Staging test kaydı


dataLayer sözleşmesi, geliştiricinin tahmin yapmasına yer bırakmamalıdır
Otomasyon üzerinde anlaşılan event adlarını tracking planından çeker, alan adlarını ve tiplerini taslaklar, bir pull request'in spesifikasyondan saptığı yerleri işaretler ve canlı çıktıyı yazılanla karşılaştırır. Sınırı insan tutar: kurulum sırasında kapsama yeni event girmez, bir mühendis spesifikasyonu gerçek sayfa zamanlamasına karşı kontrol eder ve çıktıyı bir kişi tarayıcının kendi araçlarında okur.
Ne teslim ederiz?
dataLayer dokümantasyonu, uygulamayı yapan kişiye bağlı kalmamalıdır
Yeni geliştiricilerin de anlayıp sürdürebileceği teknik kayıtlar teslim ederiz.


Teknik spesifikasyon
dataLayer spesifikasyonu
Her event için payload yapısı ve zamanlamayı içeren, geliştiriciye doğrudan verilebilen teknik sözleşme.


Test notları
Staging test sonuçları
dataLayer production'a alınmadan önce yapılan kontrolleri ve doğrulanan sonuçları gösteren kayıt.


Kullanım kılavuzu
Bakım notları
Yeni sayfa şablonu, framework ya da checkout akışı eklendiğinde yeniden kontrol edilmesi gereken noktalar.
Şu olduğunda tamam sayarız: canlı dataLayer çıktısı ilgili her sayfa tipinde yazılı spesifikasyonla eşleştiğinde ve gönderim, ona bağlı herhangi bir tag okumak zorunda kalmadan önce gerçekleştiğinde.
Uyum ve hazırlık
Sitenin göndermediği veriyle tag tetiklenemez
Event'ler tanımlandıysa ancak geliştiricinin uygulayacağı payload, veri tipi ve zamanlama kuralları eksikse dataLayer sözleşmesini hazırlarız.
Şu durumlarda iyi bir seçim
- İş aksiyonları ve event adları üzerinde anlaştınız, ancak geliştiricinin uygulayabileceği teknik dataLayer spesifikasyonu henüz yazılmadı.
- Mevcut dataLayer push'larında alanlar eksik kalıyor ya da format ve zamanlama tutarsızlaşıyor, bu yüzden tag'ler aynı event'i güvenilir biçimde okuyamıyor.
- Front-end framework değişse bile ölçümleme davranışının korunmasını sağlayacak geliştirici sözleşmesine ihtiyacınız var.


Şu durumlarda başka bir çalışma daha doğru
- İş aksiyonları ve event adları henüz belirlenmediyse önce Ölçümleme Stratejisi ve Tracking Planı çalışması yapılmalıdır.
- dataLayer hazırsa ve ihtiyaç tag ile trigger kurulumuysa bu ayrı bir iştir. Çoğunlukla GA4 Event ve Dönüşüm Takibi kapsamında ele alınır.
Bunlardan biri sizin durumunuza daha yakınsa, buradan başlayın: Google Tag Manager Kurulumu ve Yönetimi çalışmalarının tümü
Şu olduğunda tamam sayarız: Event listesi tracking planıyla eşleşmiştir, ayrıca payload ve zamanlama kuralları yeni bir event eklemeden uygulanabilir durumdadır.
Ölçümleme sisteminizi kuran ekip
Zeo, bir iş kararını kurallara bağlı veri toplamaya ve sizin kontrol edebileceğiniz raporlamaya bağlayan ölçümleme sistemleri kuruyor. Burada gördüğünüz kişiler, bu sistemin sayfanın kapsadığı bölümünde çalışıyor.

Abdullah Tanıdır
Performance Marketing Team Lead

Samet Özsüleyman
SEO Manager

İlker Emir
Senior Performance Marketing Executive

Sevda Yurtvermez
Performance Marketing Team Lead

Ozan Ketenci
VP of Consulting & Strategy

Serap Yurtvermez
Performance Marketing Team Lead

İpek Ezer
Performance Marketing Executive

Deniz Çağın Demirci
Frontend Developer

Onur Durdağı
Performance Marketing Executive

Mirzamin Aghazada
UI/UX Designer

Yağmur Bayram
Sr. SEO Analyst
Kullandığımız araçlar
Bu işin arkasındaki araçlar
NotionGeliştiricinin ek soru sormadan üzerine inşa edebileceği, versiyonlanmış teknik özellik
Google Tag ManagerÖzellikteki key'lerin, geliştiricinin push'unu karşılaştırabileceğimiz Data Layer değişkenleri olarak kablolandığı yer
Google Tag AssistantSadece bir tag'in tetiklenip tetiklenmediğine değil, staging'de push edilen gerçek objeye bakıyor
Sonraki adım
Geliştiricilerin uygulayabileceği açık bir dataLayer sözleşmesi hazırlayın


Başlamadan önce
Görüşmeden önce sorulanlar
Front-end kodunu siz mi yazıyorsunuz?
Varsayılan çalışma biçiminde spesifikasyonu biz hazırlar ve kodu inceleriz, uygulamayı geliştiricileriniz yapar. Geliştirici kapasiteniz yoksa doğrudan uygulama seçeneğini ayrıca değerlendirebiliriz.
Event adları henüz belirlenmediyse ne yapılır?
Önce Ölçümleme Stratejisi ve Tracking Planı tamamlanmalıdır. dataLayer kurulumu, adı ve anlamı onaylanmış event'ler için teknik sözleşme oluşturur.
Tek sayfa uygulamalarda nasıl ilerliyorsunuz?
Rota değişikliklerini ayrı event olarak ele alır, ölçümleme açısından neyin sayfa sayılacağını belirler ve state değişikliklerinin tam sayfa yenilemesi olmadan nasıl push edileceğini tanımlarız.
Hangi geliştirici erişimleri gerekir?
Staging ortamına, kod tabanına ya da birlikte çalışabileceğimiz bir geliştiriciye ve çıktıyı doğrulamak için browser devtools'a erişim gerekir.





















































