Google Tag Manager Kurulumu: Adım Adım Rehber

Google Tag Manager kurulumu neden ölçüm planıyla başlamalı?

Google Tag Manager kurulumu, birkaç kodu siteye yapıştırıp bırakacağınız bir işlem değil. Teknik olarak birkaç dakika içinde tamamlanabilir; fakat hangi veriyi, hangi koşulda ve hangi platforma göndereceğinizi önceden belirlemezseniz etiketler kısa sürede birbirine girer.

Ben destek biletlerinde en çok şu tabloyla karşılaşıyorum: WordPress sitesinde GA4 eklentisi, temaya eklenmiş Analytics kodu ve bir de Google Tag Manager üzerinden çalışan etiket bulunuyor. Sayfa görüntüleme iki, bazen üç kez sayılıyor. Site sahibi de “trafik arttı” diye seviniyor; raporların güvenilmez olduğunu fark ettiğinde iş daha da zorlaşıyor.

Şöyle anlatayım: GTM, veriyi kendisi ölçen bir Analytics ürünü değildir. Sitenizde gerçekleşen olayları yakalayan, bu olayları belirli araçlara gönderen ve kod değişikliklerini merkezi biçimde yönetmenizi sağlayan bir katmandır. GA4 veriyi raporlar; GTM ise etiketlerin ne zaman çalışacağını yönetir.

Kurulumdan önce küçük bir ölçüm planı hazırlayın:

Sayfa görüntüleme ve temel trafik kaynakları izlenecek mi?
Form gönderimi hangi olay olarak kaydedilecek?
WooCommerce siparişleri ve gelir bilgisi GA4’e aktarılacak mı?
Reklam dönüşümleri hangi platformlara gönderilecek?
Çerez izni verilmeden hangi etiketler duracak?

UTM etiketlerinin kampanya ölçümündeki yerini netleştirmek isterseniz UTM Parametreleri Nedir? Kampanya Takip Rehberi yazısına da bakabilirsiniz. GTM ile UTM aynı şey değildir: UTM kampanyanın kaynağını taşır, GTM bu veriyi kullanarak etiketleri çalıştırabilir.

Google Tag Manager hesabı ve kapsayıcı oluşturma

Hesap yapısı nasıl olmalı?

Google Tag Manager’da önce hesap, ardından kapsayıcı oluşturulur. Hesap genellikle şirketi veya kuruluşu temsil eder. Kapsayıcı ise bir web sitesi, Android uygulaması ya da iOS uygulaması için kullanılır.

Birden fazla siteyi tek hesapta tutabilirsiniz; ancak her site için ayrı kapsayıcı açmanız gerekir. Örneğin ornekfirma.com ve magaza.ornekfirma.com tamamen aynı ölçüm modeline sahip değilse bunları ayrı kapsayıcılarda yönetmek daha temizdir.

Google Tag Manager adresine Google hesabınızla giriş yapın.
Hesap oluştur seçeneğini seçin.
Şirket adını ve ülkeyi girin.
Kapsayıcı adını alan adıyla yazın.
Hedef platform olarak Web seçeneğini işaretleyin.

Hesap açıldığında size iki parçalı kurulum kodu gösterilir. İlk bölümün <head> içinde, ikinci bölümün açılış <body> etiketinden hemen sonra bulunması istenir. Kapsayıcı kimliği genellikle GTM-ABC1234 biçimindedir.

WordPress sitesine GTM kodunu ekleme

WordPress’te kodu eklemenin birden fazla yolu var. Ben önce temanın veya kullandığınız eklentinin güncelleme sonrasında kodu silip silmeyeceğine bakarım. Tema dosyasına doğrudan müdahale etmek hızlıdır ama tema değişince ya da güncellenince kurulum kaybolabilir.

Yöntem 1: Tema veya özel kod alanı

Güvenilir bir tema kullanıyorsanız, tema ayarlarında head ve body alanları olabilir. Bazı performans ve güvenlik eklentileri de özel HTML kodu eklemeye izin verir.

GTM’nin ilk kodunu <head> alanına, ikinci kodunu da <body> başlangıcına ekleyin. Kodları aynı alana arka arkaya yapıştırmayın. Özellikle noscript bölümünü yalnızca <body> içine koymak gerekir.

Yöntem 2: Çocuk tema kullanmak

Dosyaya müdahale etmeniz gerekiyorsa ana tema yerine çocuk tema tercih edin. Bir başka seçenek de WordPress’in uygun kancalarını kullanan küçük bir özel eklenti hazırlamaktır. Böylece kod, tasarım temasından bağımsız kalır.

Temel yerleşim mantığı şöyledir:

<!-- <head> içinde -->
<script>
(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
 j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-ABC1234');
</script>

<!-- <body> açılışından hemen sonra -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-ABC1234"
height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>

Buradaki GTM-ABC1234 değerini kendi kapsayıcı kimliğinizle değiştirin. Kodun içinde &l= ifadesini görmeniz normaldir; kullanılan veri katmanı adı dataLayer değilse GTM bunu URL parametresiyle belirtir.

Ben üçüncü taraf eklentiyi seçerken yalnızca “GTM ekler” açıklamasına bakmıyorum. Güncelleme geçmişi, izin yönetimi, çıktı biçimi ve gereksiz JavaScript üretip üretmediği daha belirleyici. Bir eklentiyle eklenen kodu tarayıcının kaynak kodunda mutlaka kontrol ederim.

Kurulumun çalıştığını nasıl doğrularım?

Kodu ekledikten sonra doğrudan GA4 raporuna bakmak iyi bir test değildir. Raporlarda gecikme olabilir ve yanlış kapsayıcı kimliği kullanırsanız sayfa yine açılır. Test için GTM çalışma alanındaki Önizleme düğmesini kullanın.

GTM’de doğru kapsayıcıyı açın.
Önizleme seçeneğine basın.
Site adresinizi girip bağlantıyı başlatın.
Açılan Tag Assistant penceresinde bağlantının kurulduğunu kontrol edin.
Sayfa görüntüleme, tıklama ve form gibi olayların zaman çizelgesine düşüp düşmediğine bakın.

Önizleme ekranında etiketin yalnızca var olması yeterli değil; doğru olayda ateşlenip ateşlenmediğini de kontrol edin. Bir etiketin Tags Fired bölümünde görünmesi çalıştığını, Tags Not Fired bölümünde görünmesi ise koşulun karşılanmadığını gösterir.

Tarayıcı geliştirici araçlarında Network sekmesini açıp collect, gtag veya kullandığınız ölçüm isteğini arayabilirsiniz. Terminalde sunucu tarafındaki DNS ve HTTP yanıtını kontrol etmek için şu komut da işime yarıyor:

curl -sI https://ornekalanadiniz.com/ | sed -n '1,12p'

Bu komut GTM’nin çalıştığını kanıtlamaz; yalnızca sayfaya erişimin ve temel HTTP yanıtının düzgün olduğunu gösterir. Asıl doğrulama tarayıcıdaki kaynak kodu, Tag Assistant ve ağ istekleri birlikte incelenerek yapılır.

İlk etiket: GA4 ölçüm kimliğini bağlamak

GA4 mülkünüz yoksa önce bir veri akışı oluşturmanız gerekir. GA4 yönetim ekranında Veri akışları bölümünden web akışını seçin. Burada G-XXXXXXXXXX biçiminde bir ölçüm kimliği göreceksiniz.

GTM içinde yeni bir etiket açın:

Etiket türü: Google etiketi veya hesabınızdaki güncel GA4 etiket türü
Google etiketi kimliği: GA4 ölçüm kimliğiniz
Tetikleyici: Initialization – All Pages ya da uygun tüm sayfalar tetikleyicisi

Ardından etikete açıklayıcı bir ad verin: GA4 - Google Tag - All Pages gibi. “Etiket 1” adı altı ay sonra ne yaptığını anlatmaz; adlandırma küçük görünür ama hata ayıklama sırasında zaman kazandırır.

Google etiketi ile temel sayfa görüntülemeleri gönderilir. Aynı GA4 kimliğini sitenizde ayrıca bir Analytics eklentisiyle çalıştırmayın. Benzer bir destek biletinde form butonuna yapılan her tıklama dönüşüm olarak sayılıyordu. Formun AJAX yanıtını incelediğimde etiketin yalnızca başarılı yanıt sonrasında çalışması gerektiğini gördüm; tetikleyiciyi başarı olayına bağlayınca eksik alanla yapılan denemeler dönüşümden çıktı.

GA4 tarafındaki kurulum ve rapor kontrolleri için GA4 Kurulumu: Web Sitenizi Adım Adım İzleyin yazısını da referans alabilirsiniz. GTM kurulumu ile GA4 mülk ayarları aynı süreç değildir; ikisini ayrı ayrı doğrulamak gerekir.

Olay ölçümü: tıklama, form ve özel etkinlikler

Bir telefon bağlantısını ölçmek

Telefon numarasına tıklanmasını ölçmek için önce bir özel etkinlik etiketi, sonra da bu etiketi çalıştıracak tetikleyici oluşturabilirsiniz. Tetikleyicide tıklanan bağlantının Click URL değerinin tel: ile başladığını belirlemek pratik bir yöntemdir.

Etiket içinde olay adını phone_click, parametreleri de örneğin link_text ve page_location olarak tanımlayın. Olay adlarında boşluk ve Türkçe karakter kullanmamak, raporları farklı araçlara taşırken işinizi kolaylaştırır.

Form gönderimlerinde dikkat edilmesi gereken nokta

Birçok form eklentisi gerçek gönderimden önce AJAX kullanır. Bu yüzden yalnızca “Form Submission” tetikleyicisine güvenmek bazı sitelerde yanlış sonuç verir. Başarılı gönderimden sonra ekrana gelen bir teşekkür mesajı, özel bir dataLayer olayı veya form eklentisinin sağladığı JavaScript olayı daha güvenilir olabilir.

Bir butona basılması ile formun gerçekten sunucuya ulaşması aynı şey değildir. Ben dönüşüm olarak buton tıklamasını değil, başarılı yanıtı ölçmeye çalışırım. Aksi halde zorunlu alanı boş bırakıp butona basan ziyaretçi bile dönüşüm sayılabilir.

dataLayer ile açık ve taşınabilir veri

Özel olayları dataLayer üzerinden göndermek, sınıf adı veya HTML yapısına bağımlılığı azaltır:

<script>
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
  event: 'lead_form_success',
  form_name: 'demo_request',
  form_id: 'contact-form'
});
</script>

GTM’de özel olay tetikleyicisinin olay adını lead_form_success olarak girin. form_name ve form_id değerlerini veri katmanı değişkenleriyle etikete aktarabilirsiniz. Böylece tasarım ekibi butonun sınıfını değiştirse bile ölçüm mantığı bozulmaz.

WooCommerce ölçümü ve veri doğruluğu

WooCommerce sitelerinde ürün görüntüleme, sepete ekleme, ödeme başlatma ve satın alma olayları izlenebilir. Ancak gelir, para birimi, ürün kimliği ve sipariş numarası yanlış gönderilirse raporlar yalnızca “olay sayısı” üretir; ticari karar vermeye yetmez.

Satın alma olayında özellikle transaction_id önemlidir. Aynı sipariş yenileme, ödeme dönüşü veya sayfa tekrar açılması nedeniyle iki kez gönderilirse gelir şişer. Sipariş numarasını benzersiz bir değer olarak gönderin ve teşekkür sayfasının tekrar yüklenmesi senaryosunu test edin.

WooCommerce için hazır bir dataLayer eklentisi kullanıyorsanız eklentinin ürettiği alanları önce önizleme ekranında inceleyin. Eklenti dokümantasyonundaki alan adları sitenizdeki gerçek veriyle aynı olmayabilir. Bu noktada varsayım yapmak yerine Tag Assistant içindeki Data Layer sekmesine bakıyorum.

Satın alma olayını reklam dönüşümü olarak işaretlemeden önce GA4 DebugView, gerçek zamanlı rapor ve sipariş yönetim ekranını karşılaştırın. Bir test siparişinin tutarı, para birimi ve sipariş kimliği üç yerde de eşleşmeli.

Çerez izni ve KVKK açısından GTM düzeni

GTM teknik bir araçtır; ziyaretçinin izni, verinin niteliği ve hangi sağlayıcıya aktarıldığı gibi hukuki kararları sizin yerinize vermez. Reklam ve analiz etiketlerinin hangi izin kategorisinden sonra çalışacağı, kullandığınız rıza yönetim platformu ve şirketinizin hukuki değerlendirmesiyle belirlenmelidir.

İzin verilmeden önce reklam etiketlerinin çalışması, ölçüm planınız teknik olarak kusursuz olsa bile sorun yaratabilir. Bu nedenle varsayılan izin durumlarını, güncelleme sinyallerini ve etiket koşullarını test edin. İzin banner’ı yalnızca ekranda görünüyorsa kurulum tamamlanmış sayılmaz; tarayıcı ağ isteklerinde beklenmeyen reklam çağrısı var mı diye bakın.

GTM çalışma alanında etiketleri amaçlarına göre adlandırmak faydalı olur:

Etiket grubu	Örnek ad	Kontrol noktası
Analiz	GA4 – Google Tag – All Pages	İzin durumu ve tekil yükleme
Reklam	Ads – Lead Conversion	Doğru dönüşüm ve izin sinyali
Ürün	GA4 – Purchase	Sipariş kimliği ve gelir
Özel olay	GA4 – Lead Form Success	Gerçek başarılı gönderim

Yayınlama, sürümleme ve geri dönüş

GTM’de yaptığınız değişiklikler çalışma alanında kalır; siteye yansıması için kapsayıcıyı yayınlamanız gerekir. Yayınlamadan önce açıklama yazın. “Form ölçümü eklendi, demo_request olayı kullanıldı” gibi bir not, birkaç hafta sonra yapılan değişikliği anlamanızı sağlar.

Önizleme ile etiketleri test edin.
GA4 DebugView veya ilgili hedef sistemde isteği doğrulayın.
Çalışma alanı değişikliklerini gözden geçirin.
Yayın sürümüne açık bir açıklama ekleyin.
Yayın sonrası gerçek sitede gizli pencereyle tekrar kontrol edin.

Yanlış bir etiket yayınlandıysa önceki sürüme geri dönmek mümkündür. Ben bunu, “nasıl olsa bir şey olmaz” rahatlığıyla değil, her ölçüm değişikliğinin üretim kodu olduğunu bilerek kullanıyorum. Etiket yöneticisi kod yazma ihtiyacını azaltır; test ve geri dönüş ihtiyacını ortadan kaldırmaz.

Sık görülen GTM hataları

Etiket çalışmıyor

Önce tetikleyicinin koşulunu, sonra etiketin bağlı olduğu değişkenleri kontrol edin. Yanlış kapsayıcıda önizleme yapmak, reklam engelleyici kullanmak veya izin verilmemesi de aynı belirtiyi oluşturabilir.

GA4 verisi iki kez geliyor

Sayfada ikinci bir GA4 kodu, iki ayrı GTM etiketi veya hem eklenti hem tema üzerinden yüklenen entegrasyonları arayın. Tarayıcının kaynak kodu ve Network sekmesi, bu soruda rapor ekranından daha hızlı ipucu verir.

Önizleme bağlantısı kurulmuyor

Önbellek eklentileri, güvenlik duvarları, üçüncü taraf çerez kısıtları ve Content Security Policy ayarları Tag Assistant bağlantısını etkileyebilir. Siteyi gizli pencerede deneyin; sunucu tarafında da güvenlik duvarı loglarında ilgili bağlantının engellenip engellenmediğine bakın.

Değişiklik sitede görünmüyor

Çalışma alanını yayınlamamış olabilirsiniz veya CDN ve sayfa önbelleği eski HTML’i döndürüyor olabilir. Önce GTM sürümünün yayınlandığını, sonra tarayıcıdaki kaynakta doğru kapsayıcı kimliğinin bulunduğunu kontrol edin.

Google Tag Manager kurulumu için pratik kontrol listesi

Her web sitesi için doğru kapsayıcı oluşturuldu mu?
GTM kodunun iki bölümü doğru yerlere eklendi mi?
Kaynak kodda aynı kapsayıcı veya GA4 etiketi birden fazla kez yükleniyor mu?
GA4 ölçüm kimliği doğru veri akışına mı ait?
Etiketler önizleme modunda doğru olaylarda çalışıyor mu?
Form ve sipariş ölçümü gerçekten başarılı işlemi mi temsil ediyor?
Çerez izni olmadan çalışmaması gereken etiketler duruyor mu?
Yayın sürümüne açıklama eklendi mi?
Özel olaylar DebugView ve gerçek raporlarla karşılaştırıldı mı?

GA4 verisini yorumladıktan sonra dönüşüm oranını işletme hedefleriyle birlikte değerlendirmek isterseniz E-Ticaret Dönüşüm Oranı Nasıl Artırılır? yazısındaki ölçüm ve kullanıcı davranışı bağlantısı işinize yarayabilir. Ölçüm kuruldu diye veri otomatik olarak anlamlı hale gelmez; yanlış tanımlanmış bir dönüşüm, hiç veri olmamasından daha yanıltıcı olabilir.

Benim uyguladığım sıra basit: önce olay adlarını ve başarı koşullarını yazarım, sonra dataLayer veya tetikleyici tasarımını kurarım, en son etiketi yayınlarım. İlk gün her şeyi izlemek yerine güvenilir birkaç olayı seçmek daha sağlıklı. GTM kapsayıcınız büyüdüğünde de aylık olarak kullanılmayan etiketleri, eski tetikleyicileri ve son yayın sürümlerini gözden geçirin.

Sık Sorulan Sorular

Google Tag Manager kurulumu için WordPress eklentisi kullanmalı mıyım?

Eklenti kullanabilirsiniz; fakat eklentinin kodu güncelleme sonrası koruduğunu, gereksiz script eklemediğini ve izin yönetimiyle uyumlu olduğunu kontrol edin. Tema dosyasına doğrudan ekleme yapıyorsanız çocuk tema veya özel eklenti kullanmak daha kalıcı bir yapı sağlar.

GTM ile Google Analytics aynı şey mi?

Hayır. Google Analytics verileri raporlayan ölçüm platformudur; Google Tag Manager ise etiketleri ve bunların çalışacağı koşulları yönetir. GTM üzerinden GA4, reklam dönüşüm ve farklı üçüncü taraf etiketleri çalıştırabilirsiniz.

GTM kodu siteyi yavaşlatır mı?

GTM kapsayıcı kodu genellikle asenkron yüklenir; fakat kapsayıcıya eklediğiniz her etiket ek JavaScript ve ağ isteği oluşturabilir. Kullanılmayan etiketleri kaldırın, tetikleyicileri daraltın ve performans testini gerçek mobil cihazlarda yapın.

Bir etiketin gerçekten çalıştığını nasıl anlarım?

GTM Önizleme ve Tag Assistant’ta etiketin doğru olayda tetiklendiğini kontrol edin. Ardından tarayıcının Network sekmesindeki isteği, ilgili platformun gerçek zamanlı veya hata ayıklama ekranıyla karşılaştırın.

Post Views: 10