Google Tag Manager’da veri katmanına uçtan uca rehber

Google Tag Manager (GTM), web sitesi analitiğini ve izlemesini bir üst seviyeye taşımak için harika bir araçtır. Veri katmanı (data layer) ise izlemeyi bir sonraki seviyeye taşımaya yardımcı olan özelliklerden biridir.

GTM veri katmanı, web sitenizdeki kullanıcı etkileşimleri hakkında ayrıntıları toplayan bir JavaScript nesnesidir. Yardımıyla, ürün görüntülemelerinden kullanıcının işletim sistemine kadar hemen hemen her türlü veriyi toplayabilirsiniz. GTM’de veri katmanlarını kullanmak, daha hedefli izleme etiketleri ve tetikleyiciler yapılandırmanızı sağlar; bu da kullanıcı davranışına dair daha zengin içgörüler sunar ve güçlü müşteri veri analizi için sağlam bir temel oluşturur.

Bu yüzden, Google Tag Manager’da veri katmanının uygulanması ve kullanımının birçok yönünü kapsayan kapsamlı bir rehber hazırladık. Veri katmanının ne olduğunu, kullanım senaryolarını, web sitesinde veri katmanı uygulamasını, Tag Manager’da nasıl veri katmanı oluşturacağınızı, kurulumu nasıl test edeceğinizi ve kurulumla ilgili yaygın hataları açıklayacağız.

Hadi başlayalım!

GTM veri katmanı, etiketlere veri aktarmak için kullanılan bir JavaScript nesnesidir. Olayları veya değişkenleri aktarmanıza ve belirli değişken değerlerine dayalı tetikleyiciler ayarlamanıza olanak tanır. Veri katmanı hem Google Tag Manager’da hem de gtag.js’de kullanılır.

Veri katmanı, web siteniz ile Google Tag Manager arasında bir aracıdır ve konteyneriniz için yapılandırılmış verileri depolayan bir merkez olarak işlev görür.

Aşağıdakileri yapmak istiyorsanız bir veri katmanı oluşturmanız gerekir:

• Güvenilir izleme kurmak. Veri katmanı olmadan, verileri doğrudan HTML DOM’dan çekersiniz (web sitenizdeki HTML öğelerini eklemek, almak, değiştirmek veya silmek için kullanılan standart) ve ardından verileri doğrudan GTM konteynerine gönderirsiniz. Sorun şu ki HTML DOM değişebilir, bu da etiketlerin tetiklenmesinin ve veri toplamanın durmasına yol açabilir.

Veri katmanı ile böyle bir sorunla karşılaşmazsınız, çünkü GTM konteyneri verileri sayfanın veri katmanından çeker; bu da HTML DOM’dan çok daha kararlıdır. Veri kaydı, yalnızca birisi sayfanın veri katmanını bozarsa durur.

• Belirli koşullarda etiket verisini zenginleştirmek. Diyelim ki, satın alma olayının değerine ilişkin veriyi yalnızca kullanıcı 50 dolardan fazla ödeme yaptıysa göndermek istiyorsunuz. Sayfanızdaki dağınık değişkenler, işlem detayları, sayfa kategorileri ve diğer sinyaller arasında arama yapmak yerine, ilgili değişkenler ve değerleriyle (bizim örneğimizde, satın alma değeri > 50 dolar) doldurulmuş bir veri katmanı kullanmak, etiketlerinizin ihtiyaç duyduğu anda gerekli verinin kolayca erişilebilir olmasını sağlamaya yardımcı olur.

Bu katmanda tam olarak hangi verileri saklamak istediğinizi belirtebilirsiniz. Veri katmanını oluşturmak ve izlenecek gerekli parametrelerle doldurmak için iki yöntem vardır; bunları bir sonraki bölümde inceleyeceğiz.

GTM, veri katmanından gerekli değerleri okur ve alır, ardından bunları Google Analytics, Google Ads, Facebook Pixel gibi analiz araçlarına gönderir.

Google Tag Manager’da dataLayer, “[]” ile belirtildiği gibi bir dizidir ve aşağıdaki kod örneğinde gösterildiği gibi “{}” ile temsil edilen bir nesne içerir:

Veri katmanı içindeki öğeler değişken olarak adlandırılır ve ‘anahtar’ : ‘değer’ çiftleri şeklinde biçimlendirilir (“{}” içinde yer alır).

GTM, kullanıcı bir web sitesindeki öğelerle etkileşime girdiğinde etiketleri tetiklemek için JavaScript olay dinleyicileri tarafından da kullanılan “event” adlı bir veri katmanı değişkeni kullanır. Yani, aşağıdaki örneğe göre, ‘event’ bir ‘anahtar’ ve ‘register’ ise bir ‘değer’dir.

Değişkenler için sözdizimi, olaylarla aynıdır. Aşağıdaki örnekte, izlemek için istenen ülkeyi alıyoruz – ‘country’ (‘variable_name’) ‘anahtar’dır ve ‘united states’ (‘variable_value’) ‘değer’dir.

Veri katmanı uygulaması için iki yöntem vardır: veri katmanı bildirimi (declaration) ve veri katmanı push. Her iki yöntemin nasıl kullanılacağını açıklayacağız, ancak doğrudan size en uygun olana geçebilirsiniz.

Kısaca, dataLayer.push kullanmanızı öneririz, çünkü daha popülerdir ve çoğu ihtiyacı karşılar. Ayrıca, bu yöntem kullanımı daha güvenlidir, çünkü Google Tag Manager’daki olayları bozmaz; oysa veri katmanı bildirimlerinin uygunsuz kurulumu kolayca sorunlara neden olabilir.

Bu yöntemi kullanmak için, veri katmanı kod parçası Google Tag Manager konteyner kod parçasının üstüne yerleştirilmelidir. Bu durumda, veri katmanı, Tag Manager başlatılmadan önce başlatılır.

Genel olarak, bu veri katmanı oluşturmak için popüler veya önerilen bir yol değildir, ancak GTM konteyneri yüklenmeden önce veri noktaları oluşturmak ve bu veri noktalarını etiket yönetimi için kullanmak istiyorsanız işe yarayacaktır.

‘variable_name’: ‘variable_value’ kısmını gerekli parametrelerle değiştirin ve kodu web sitesi sayfasında GTM kod parçasından önce yapıştırın.

Not: Nesnenin değerlerini dataLayer dizisine atamak için “=” operatörünü kullanın.

Push yöntemi, nesne öğelerini veri katmanına dinamik olarak ekler. Veri katmanı bildirimi yönteminin aksine, push verisiyle veri katmanı kod parçasını kodun herhangi bir yerine yerleştirebilirsiniz.

Biraz kafa karıştırıcı olabilir, ancak ‘dataLayer’ aynı zamanda window nesnesiyle etkileşime giren herhangi bir fonksiyon tarafından erişilebilen bir JavaScript değişkenidir. Bu nedenle, ‘dataLayer’ adlı başka bir yerel JavaScript dizisiyle çakışmaları önlemek için en iyi yol, ‘window.dataLayer’ önekini kullanmaktır.

Dolayısıyla, dataLayer.push yöntemi için aşağıdaki kodu kullanmanız gerekecek. ‘variable_name’ : ‘variable_value’ yerine, gereken parametreleri ekleyin.

Yukarıdaki kod bloğunda, mevcut bir dataLayer varsa dataLayer ona ayarlanır; aksi takdirde boş bir dizi olarak yeni bir dataLayer oluşturulur. || (VEYA) operatörü, bu koşullardan herhangi biri karşılandığında atamanın gerçekleşmesini sağlar.

Bu şekilde, dataLayer’ın üzerine yazabilecek birden fazla bildirim oluşturmaktan kaçınmış olursunuz.

Birçok eCommerce CMS’i için, standart eCommerce olayları için bir veri katmanı oluşturabilen eklentiler (Stape’in eklentileri dahil) bulunmaktadır. Bazı durumlarda bu yeterli olmayabilir. Örneğin, veri katmanı olaylarında ek olaylara veya ek verilere ihtiyacınız varsa. Ya da tamamen özelleştirilmiş bir platform kullanıyorsanız.

Bu durumda, ihtiyacınız olan yük (payload) ile veri katmanı olayları oluşturmak için geliştiricilerinizle iletişime geçmeniz gerekir. Bu, genellikle geliştiriciler için oldukça basit bir görevdir ve çok uzun sürmez, ancak sitenizin veya platformunuzun mimarisine bağlıdır.

Birkaç faydalı kural:

• Belgenin bir kopyasını oluşturun, ihtiyacınız olmayan olayları kaldırın ve/veya ihtiyacınız olan olayları ve örnek yükü ekleyin.
• Tüm olaylarda aynı veri formatını kullanın. GA4 formatını takip etmek en iyisidir.
• Eğer bariz bir olay değilse (örneğin görüntülenen ürün veya sepete ekleme), ne zaman tetiklenmesi gerektiğini ayrıntılı olarak açıklayın. Bu, sizinle geliştiriciler arasındaki gereksiz ileri geri yazışmaları önleyecektir.
• Kullanıcı verileri neredeyse tüm pazarlama platformlarında kullanılabilir; bu verinin veri katmanında bulunması önemlidir – kullanılması izleme sonuçlarınızı büyük ölçüde iyileştirecektir.
• Kullanıcının başka bir sayfaya yönlendirilmesinden önce gönderilen veri katmanı olaylarından kaçınmaya çalışın. Bu, bu verilerin kaybına yol açabilir, çünkü olaylar yönlendirmeden önce gerçekte gönderilmeyebilir. Örneğin, bir kullanıcı bir formu gönderdikten sonra bir Lead olayı göndermek istiyorsanız ve ardından kullanıcı teşekkür sayfasına yönlendiriliyorsa – en iyi uygulama, kullanıcı formu gerçekten gönderdiğinde değil, teşekkür sayfasında veri katmanında bu olayı göndermektir.
• Sitenizde zaten bazı veri katmanı olaylarınız varsa, yeni veri katmanı olayları için bazı özel isimler kullanmak ve eski olayları değiştirmemek daha iyidir, böylece süreçte mevcut izlemeyi etkilememiş olursunuz. Yani, veri katmanında zaten örneğin add_to_cart varsa, eskisini değiştirip ardından etiketleri yeni olaylara yeniden yapılandırmak yerine yeni bir add_to_cart_v2 olayı oluşturmak daha iyidir.
• Geliştiriciler bunu uyguladıktan sonra veri katmanını kontrol etmeyi unutmayın. Bazen yükteki küçük hatalar bile izleme sorunlarına neden olabilir.

1. Ürün/öğe verisi

• item_id – benzersiz ürün tanımlayıcısı (SKU veya veritabanı ID’si)
• item_name – ürün adı
• item_category – ürün kategorisi (iç içe geçebilir: item_category2, item_category3)
• item_brand – marka adı
• price – birim fiyatı
• quantity – birim sayısı

2. İşlem verisi

• transaction_id – benzersiz sipariş ID’si (yinelenen kaldırma için kritik)
• value – toplam işlem değeri
• currency – ISO 4217 para birimi kodu (örn. USD, EUR)
• tax – vergi tutarı
• shipping – kargo ücreti
• coupon – uygulanan kupon kodu

3. Kullanıcı verisi

• user_id – dahili kullanıcı tanımlayıcısı
• email – karması alınmış (hashed) kullanıcı e-postası (gelişmiş dönüşümler için)

4. Olaya özgü parametreler

Google Tag Manager’da veri katmanı dizinizden öğelere farklı şekillerde erişebilirsiniz. Google Tag Manager içindeki verilerden yararlanmak için, bir değişkene atayın veya bir olay tetikleyicisi olarak kullanın. Bu değişkenler veya olaylar daha sonra etiketlerinize, tetikleyicilerinize veya diğer değişkenlerinize dahil edilebilir.

Aşağıda, veri katmanının üç kullanım senaryosunu ve bunların GTM’de kurulumunu sunuyoruz:

• Veri noktaları olarak Veri Katmanı değişkenleri
• Olayları tetiklemek için Veri Katmanı
• Değişkenler ve olay tetikleyicileri ile Veri Katmanı değişkeni

Örnek olarak, turuncu tişörtlerin satın alma değerini alıyoruz.

1. Değişken yapılandırması için, GTM konteynerinde Variables → Kullanıcı Tanımlı Değişkenlerde “New” tıklayın.

2. Değişken türü olarak “Data Layer Variable” seçin.

3. Veri katmanı değişken adını ekleyin ve “Save” tıklayın.

Lütfen dikkat: bu alan büyük/küçük harfe duyarlıdır, bu nedenle adın sayfaya eklediğiniz koddaki değer adıyla eşleştiğinden emin olun. Bizim durumumuzda bu, ”purchase_value” dür.

Kod örneği olarak, kullanıcı kayıt için gerekli verileri doldurup “Register” tıkladığında “register” olayını tetikleyen dataLayer değişkenini alıyoruz.

1. Google Tag Manager Triggers’a gidin → “New” tıklayın.

2. “Custom Event” tetikleyici türünü seçin.

3. “Event name” alanına, bu alan büyük/küçük harfe duyarlı olduğundan koddaki değer adıyla aynı şekilde adı ekleyin. “Save” tıklayın.

Aşağıdaki veri katmanı değişkeni örneği, satın alma olaylarını tetikler ve satın alma bilgisi oluşturur.

Koddan gelen değişkenleri Google Tag Manager’da hem değişken hem de olay tetikleyicisi olarak kullanabilirsiniz. Değişkenler ve olaylar için önceki adımlardaki kurulum sürecini kontrol edin.

Veri katmanı, istemci taraflı GTM’de olduğu gibi sunucu taraflı Google Tag Manager’da mevcut değildir.

Ancak sGTM, web GTM’den gelen HTTP isteklerini kontrol eden Client adlı bir nesneye sahiptir. İstek belirli verileri içeriyorsa, Client, istek verilerini olay verisine dönüştürür. Etiketler de web GTM konteynerinden GTM sunucusuna veri göndermek için kullanılır.

Server GTM konteynerindeki veri noktalarını doldurmak için, webden server GTM’ye veri göndermek üzere kullanacağınız yöntemi seçmeniz gerekir; popüler olanlar arasında şunlar bulunur:

• Google Analytics 4
• Stape Data Tag

Bu yöntem, özellikle Google Ads veya Floodlight için sunucu taraflı izleme kuruyorsanız etkilidir, çünkü ikisi de yalnızca GA4 etiketlerine dayanır.

1. Web GTM’de yapılandırması “Google Analytics: GA4 Event” olan bir etiket oluşturun.

2. Bu veri için önceden tanımlanmış alanlar bulacaksınız ve her parametreye ayrı ayrı veri katmanı değişkenleri atayabilirsiniz.

Data Tag/Data Client kullanmanın temel avantajı, veri katmanını ve diğer ortak verileri otomatik olarak webden GTM sunucusuna göndermesidir.

1. 1.
   Web GTM konteynerinde yeni bir etiket oluşturun ve etiket yapılandırması olarak “Data Tag”i seçin.

Lütfen dikkat: GTM galerisine Data Client’ı eklemeniz gerekir.

2. Etiket yapılandırmasında, “Send common data” ve “Send all from DataLayer” seçeneklerinin iki onay kutusunu etkinleştirin.

Sistem, web GTM’deki verileri otomatik olarak ayrıştıracak ve mevcut tüm bilgileri server GTM’ye iletecektir.

Not: Aşağıda, veri göndermek için Google Tag’i nasıl kuracağınızı açıklıyoruz; zaten yapılandırılmış bir Google Tag’iniz varsa, yeni bir etiket oluşturmanıza gerek yoktur. Aşağıdaki adımları atlayın ve doğrudan özel boyut oluşturma bölümüne geçin.

Bu durumda, yalnızca “Shared event settings” bölümündeki veri katmanı kodundaki gibi parametreler eklemeniz gerekir.

1. GTM’nin “Tags” bölümünde “New”’a tıklayın ve etiket türü olarak “Google Tag”’ı seçin.

2. GA4 Measurement ID’nizi ekleyin ve “Shared event settings” bölümünde, kodunuza eklediğiniz parametreleri listeleyin.

3. Tetikleyici olarak “Page View – All Pages”’i seçin.

Standart bir parametre listesi vardır. Veri katmanı yardımıyla izlemek istediğiniz veri, Google Analytics’ten önerilen olaylar arasında yoksa, bunu GA4 hesabınıza manuel olarak özel boyut olarak eklemeniz gerekir. Eklendikten sonra GA4 raporlarında görünecektir.

1. Google Analytics hesabında, “Admin”’a → “Custom definitions”’a tıklayın.

2. “Create custom dimension”’a tıklayın ve gerekli parametreyi doldurun:

• Dimension name – raporlarda görmek istediğiniz ad.
• Scope – bir olay, kullanıcı veya öğe kapsamı seçin.
• Event parameter – veri katmanı kod parçasında belirtildiği şekilde değişkenin veya olayın adını ekleyin (lütfen dikkat, bu alandaki veri büyük/küçük harfe duyarlıdır).

“Save”’a tıklayın.

Google Tag Manager’ın değişkeni yakalayıp yakalamadığını kontrol etmek için, GTM’de normal hata ayıklamaya benzer birkaç basit adım atmanız gerekir.

1. “Preview”’a tıklayın ve hata ayıkladığınız web sitesinin URL’sini ekleyin.

2. “Variable” bölümü sekmesine geçin ve her şey çalışıyorsa, bu sekmede gereken veriyi göreceksiniz.

GTM’deki Hata Ayıklama Modu ile ilgili sorunlarınız varsa, rehberlerimize göz atın:

• Google Tag Manager önizleme modu neden çalışmıyor?
• Sunucu taraflı izleme yapılandırmasının hata ayıklanması ve izlenmesi için rehber

Google Analytics’in veriyi yakalayıp yakalamadığını kontrol etmek için, “Admin” → DebugView’e gidin.

Değişkenlerin veya olayların push edilemediğini görüyorsanız, muhtemelen nesne adları için uygun büyük/küçük harf kullanımını kullanmıyorsunuz veya tırnak işaretlerini atlamışsınızdır.

• “dataLayer”ın camel case’de olup olmadığını kontrol edin.

İyi örnek:

Kötü örnek:

• Tüm değişken adlarının tırnak içine alındığından emin olun.

İyi örnek:

Kötü örnek:

Web sitesinde gereken tüm konumlarda etiketleri tetikleyemiyorsanız, farklı sayfalardaki değişken adlarını kontrol edin.

En sık yapılan hata, farklı sayfalardaki değişken adlarında tutarsız büyük/küçük harf kullanımıdır, bu nedenle adları gözden geçirmeniz gerekir.

İyi örnek:

Kötü örnek:

GTM datalayer, GTM’nin önemli bir bileşenidir. Kullanıcıların web sitenizle olan etkileşimlerini yakalamamızı sağlarken, aynı zamanda etkileşim veya bağlamı hakkında ek veriler de sunar. Daha iyi bir veri yapısı oluşturmak istiyorsanız, veri katmanını kullanmak önemlidir.

Veri katmanı kavramını uygulamak oldukça zorludur ve karmaşık bir izleme altyapısı kurmak için büyük olasılıkla geliştiricilere ihtiyaç duyulacaktır.

İşte hızlı bir özet:

• Veri katmanını uygulamak için dataLayer.push yöntemini kullanmanızı öneririz.
• Veri katmanı uygulamasından sonra, veri katmanını veri noktaları, olay tetikleyicileri olarak veya her ikisi olarak kullanabilirsiniz.
• Sunucu taraflı izleme kullanıyorsanız, veri katmanının parametrelerini istemci taraflı GTM konteynerinden sunucu taraflı GTM konteynerine gönderin.
• Ayarı her zaman GTM Hata Ayıklama Modunda kontrol edin.
• Verileri GA4 raporlarında görmek için (bu aracı kullanıyorsanız) GA4'te özel boyutlar ekleyin.
• Veri katmanının arızalanmasına neden olan sık yapılan hatalardan kaçının.