Blog · 27 Ekim 2026

Google Tag Manager Nedir? Etiket, Tetikleyici ve Değişken Mantığı

Google Tag Manager (GTM), web sitenize ölçüm ve pazarlama kodlarını (etiketleri) sitenin kaynak koduna her seferinde dokunmadan ekleyip yönetmenizi sağlayan ücretsiz bir Google aracıdır. Siteye bir kez GTM kapsayıcı kodu yerleştirilir; sonrasında Google Analytics 4, Google Ads dönüşümü veya reklam pikselleri gibi kodlar GTM arayüzünden eklenir, hangi durumda çalışacakları tetikleyicilerle belirlenir. Kısacası GTM, sitenizdeki tüm izleme kodları için tek bir kontrol paneli görevi görür.

Bu rehberde GTM'in temel yapı taşlarını, kurulum kodunun nereye ekleneceğini, GA4 etiketinin nasıl kurulacağını, dataLayer ile özel olay göndermeyi, önizleme ve yayınlama adımlarını ve en sık yapılan hataları uygulamalı olarak ele alıyoruz.

Google Tag Manager neden kullanılır?

GTM olmadan her yeni izleme kodu, geliştiricinin sitenin şablonlarını düzenlemesi ve yeni bir sürüm yayınlaması anlamına gelir. Bir form gönderimini, telefon tıklamasını veya dosya indirmeyi ölçmek istediğinizde bu döngü tekrar eder. GTM bu iş yükünü pazarlama ve analiz ekibine taşır; kod tarafında yalnızca bir kez kurulum yapılır.

Başlıca faydaları şunlardır:

GTM'in kendisi veri toplamaz ve rapor üretmez. Veriyi toplayan ve raporlayan araçlar GA4, Google Ads veya diğer platformlardır; GTM yalnızca onların kodlarını doğru zamanda çalıştıran dağıtım katmanıdır. Bu ayrımı anlamak, kurulumda yapılan hataların büyük kısmını önler. GA4 tarafının nasıl çalıştığını Google Analytics nedir rehberimizde ayrıntılı anlattık.

GTM'in yapı taşları: hesap, container, etiket, tetikleyici, değişken

GTM'i anlamanın en kısa yolu beş kavramı birbirinden ayırmaktır. Aşağıdaki tablo bu kavramları ve aralarındaki ilişkiyi özetler.

KavramNe işe yarar?Örnek
Hesap (Account)En üst düzey kapsayıcıdır; genellikle bir şirket veya marka için açılır."Örnek Mobilya A.Ş."
Container (Kapsayıcı)Bir web sitesi veya uygulama için tüm etiket, tetikleyici ve değişkenleri barındırır. GTM-XXXXXXX biçiminde bir kimliği vardır."ornekmobilya.com - Web"
Etiket (Tag)Çalıştırılacak kod parçasıdır; veriyi bir platforma gönderir.GA4 Google etiketi, GA4 olay etiketi, Google Ads dönüşüm etiketi
Tetikleyici (Trigger)Etiketin hangi koşulda çalışacağını belirler.Tüm sayfa görüntülemeleri, belirli bir butona tıklama, form gönderimi
Değişken (Variable)Tetikleyici koşullarında veya etiket alanlarında kullanılan dinamik değerdir.Sayfa URL'si, tıklanan bağlantının adresi, dataLayer'dan gelen ürün fiyatı

Etiket

Etiket, "ne yapılacak" sorusunun cevabıdır. GTM içinde Google ürünleri için hazır etiket şablonları bulunur; bunların dışında topluluk şablon galerisinden şablon eklenebilir veya özel HTML etiketiyle herhangi bir script çalıştırılabilir. Özel HTML etiketleri esnektir ama güvenlik ve performans açısından dikkat ister; mümkün olduğunda hazır şablonu tercih etmek daha sağlıklıdır.

Tetikleyici

Tetikleyici, "ne zaman yapılacak" sorusunun cevabıdır. Her etiketin en az bir tetikleyicisi olmalıdır; aksi halde etiket hiç çalışmaz. Sık kullanılan tetikleyici türleri şunlardır:

Tetikleyiciler "tüm olaylar" veya "bazı olaylar" şeklinde çalışabilir. "Bazı olaylar" seçildiğinde değişkenlerle koşul yazılır: örneğin "Click URL içerir wa.me" koşulu yalnızca WhatsApp bağlantısı tıklamalarını yakalar. Ayrıca bir etiketin belirli durumlarda çalışmasını engellemek için istisna (engelleme) tetikleyicisi tanımlanabilir.

Değişken

Değişkenler, tetikleyici koşullarını ve etiketlere gönderilen değerleri dinamik hale getirir. İki türü vardır:

Pratik bir alışkanlık olarak GA4 ölçüm kimliğini bir sabit değişkende tutmak işinizi kolaylaştırır. Kimlik değişirse tek bir yerden güncellersiniz.

Adım adım GTM kurulumu

  1. tagmanager.google.com adresine Google hesabınızla giriş yapın.
  2. Yeni bir hesap oluşturun: hesap adı ve ülke bilgisini girin.
  3. Container adı olarak alan adınızı yazın ve hedef platform olarak "Web" seçin.
  4. Hizmet şartlarını kabul edin. Ekranda iki parçalı kurulum kodu görünür.
  5. Kodun birinci parçasını sitenizin tüm sayfalarında <head> etiketinin mümkün olduğunca üst kısmına ekleyin.
  6. İkinci parçayı (noscript) açılış <body> etiketinin hemen sonrasına ekleyin.
  7. Kurulumu doğrulayın (aşağıda ayrı bir başlıkta anlatıyoruz).

Kurulum kodu: head ve body

GTM'in verdiği kod iki parçadan oluşur. Birinci parça, GTM kütüphanesini asenkron olarak yükleyen JavaScript kodudur ve <head> içinde yer alır. Yapısı kabaca şöyledir (kendi kodunuzu GTM arayüzünden kopyalayın, buradaki kimlik örnektir):

<!-- Google Tag Manager -->
<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-XXXXXXX');</script>
<!-- End Google Tag Manager -->

İkinci parça, JavaScript'i kapalı tarayıcılar için bir iframe içerir ve <body> açılışının hemen ardından gelir:

<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXXX"
height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>

WordPress gibi içerik yönetim sistemlerinde kodu tema dosyalarına elle eklemek yerine bir eklenti veya temanın "header/footer kodu" alanı kullanılabilir. Next.js gibi çerçevelerde ise kodu ortak yerleşim (layout) bileşenine eklemek, tüm sayfalarda tek seferde yüklenmesini sağlar. Hangi yöntemi seçerseniz seçin, kodun yalnızca bir kez yüklendiğinden emin olun.

GA4 etiketini GTM ile kurmak

GA4'ü GTM üzerinden kurmanın temel mantığı iki katmanlıdır: önce tüm sayfalarda çalışan bir Google etiketi (yapılandırma etiketi), sonra ihtiyaç duyduğunuz olaylar için ayrı GA4 olay etiketleri.

  1. GA4 mülkünüzde Yönetici bölümünden veri akışını açın ve ölçüm kimliğini (G- ile başlayan kod) kopyalayın.
  2. GTM'de Etiketler bölümünde yeni etiket oluşturun ve etiket türü olarak Google etiketini seçin.
  3. Etiket kimliği alanına ölçüm kimliğini yapıştırın (veya sabit değişkeninizi seçin).
  4. Tetikleyici olarak "Initialization - All Pages" veya "All Pages" seçin. Başlatma tetikleyicisi, etiketin diğer etiketlerden önce çalışmasını sağladığı için genellikle tercih edilir.
  5. Etiketi anlaşılır bir adla kaydedin, örneğin "GA4 - Google Etiketi".

Bu kurulumla GA4 sayfa görüntülemelerini ve gelişmiş ölçüm etkinse kaydırma, giden bağlantı tıklaması gibi bazı olayları otomatik toplar. Önemli bir uyarı: sitede GA4'ün gtag.js kodu da doğrudan kuruluysa ve aynı ölçüm kimliğini GTM'den de yüklüyorsanız sayfa görüntülemeleri iki kez sayılır. İki yöntemden yalnızca birini kullanın.

GA4 olay etiketi örneği

Bir iletişim formunun başarıyla gönderilmesini ölçmek istediğinizi varsayalım. Yeni bir etiket oluşturup türü olarak GA4 olayını seçin, ölçüm kimliğini girin ve olay adı olarak generate_lead yazın. GA4'ün önerilen olay adlarını kullanmak raporlarda daha tutarlı sonuç verir. Olay parametreleri bölümüne form_name gibi ek bilgiler ekleyebilirsiniz. Tetikleyiciyi ise bir sonraki bölümde anlatılan dataLayer özel olayına bağlayın.

dataLayer ile olay göndermek

dataLayer, sitenizin GTM'e bilgi aktardığı JavaScript dizisidir. GTM kurulum kodu bu diziyi otomatik oluşturur. Siteniz önemli bir an yaşandığında (form gönderildi, sepete ürün eklendi, üyelik tamamlandı) bu diziye bir nesne gönderir; GTM bu nesneyi okuyup tetikleyicileri değerlendirir.

Örneğin form başarıyla gönderildikten sonra çalışan kod şu kadar kısadır:

window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
  event: 'form_gonderildi',
  form_name: 'iletisim'
});

GTM tarafında yapılması gerekenler:

  1. Tetikleyiciler bölümünde yeni bir tetikleyici oluşturun, türü "Özel Etkinlik" olsun ve etkinlik adına form_gonderildi yazın. Ad büyük-küçük harfe duyarlıdır; koddaki adla birebir aynı olmalıdır.
  2. Değişkenler bölümünde "Veri Katmanı Değişkeni" türünde yeni bir değişken oluşturun ve değişken adı olarak form_name girin.
  3. GA4 olay etiketinizde tetikleyici olarak bu özel etkinliği seçin, parametre değerine de oluşturduğunuz dataLayer değişkenini bağlayın.

dataLayer yaklaşımı, tıklama veya form tetikleyicilerine göre çok daha dayanıklıdır. Tasarım değişip butonun sınıf adı veya metni farklılaştığında tıklama tetikleyicisi sessizce bozulabilir; dataLayer olayı ise geliştirici kodu kaldırmadığı sürece çalışmaya devam eder. Özellikle JavaScript ile gönderilen formlarda ve tek sayfa uygulamalarında bu yöntemi tercih edin.

Önizleme ve hata ayıklama

GTM'de yaptığınız hiçbir değişiklik, yayınlanana kadar ziyaretçileri etkilemez. Yayınlamadan önce mutlaka önizleme modunu kullanın:

  1. Çalışma alanının sağ üst köşesindeki "Önizle" düğmesine tıklayın.
  2. Açılan Tag Assistant ekranında sitenizin adresini girip bağlanın. Site yeni bir sekmede hata ayıklama moduyla açılır.
  3. Sitede test etmek istediğiniz işlemi yapın: sayfayı gezin, butona tıklayın, formu gönderin.
  4. Tag Assistant ekranında sol taraftaki olay akışında her olayı seçin ve "Tetiklenen Etiketler" ile "Tetiklenmeyen Etiketler" listesine bakın.
  5. Bir etiket tetiklenmediyse üzerine tıklayıp tetikleyici koşullarının hangisinin karşılanmadığını inceleyin. Değişkenler sekmesi, o anda değişkenlerin hangi değeri aldığını gösterir.

GA4 tarafında da DebugView raporu, önizleme modunda gönderilen olayları neredeyse gerçek zamanlı gösterir. Olay GTM'de tetiklenmiş ama DebugView'da görünmüyorsa sorun genellikle ölçüm kimliğinde, tarayıcı eklentisi engelinde veya çerez onay ayarındadır.

Sürüm oluşturma ve yayınlama

Önizlemede her şey doğru çalışıyorsa "Gönder" düğmesiyle değişiklikleri yayınlayabilirsiniz. Bu adımda dikkat edilmesi gerekenler:

GTM kodunun sitede kurulu olduğunu doğrulamak

Kurulum yapıldı demek, kodun gerçekten her sayfada doğru çalıştığı anlamına gelmez. Şu yöntemlerle doğrulayın:

Çok sayfalı sitelerde bu kontrolü elle yapmak zahmetlidir. SEO Analytics, bağlı sitelerde GTM ve GA4 kurulumunu otomatik denetler; container kimliğini, eksik veya çift yüklenen kodları raporlar.

Kurulum kontrol listesi

KontrolDoğru durum
Head koduTüm sayfalarda, head içinde üst sıralarda, tek kez
Body (noscript) koduAçılış body etiketinin hemen ardından
Container kimliğiDoğru siteye ait container, test container'ı değil
GA4 Google etiketiBaşlatma veya tüm sayfalar tetikleyicisiyle çalışıyor
Çift ölçümSitede ayrıca doğrudan gtag.js ile aynı GA4 kimliği yok
Dönüşüm olaylarıdataLayer özel olaylarıyla tetikleniyor, önizlemede test edildi
Çerez onayıEtiketler onay durumuna göre davranıyor
Sürüm notuHer yayının anlamlı bir adı ve açıklaması var
ErişimYayınlama yetkisi yalnızca sorumlu kişilerde

Yaygın hatalar ve çözümleri

1. Değişikliği yayınlamayı unutmak

Önizlemede çalışan bir etiket, "Gönder" ile yayınlanmadıkça canlı sitede çalışmaz. Çalışma alanının üst kısmında yayınlanmamış değişiklik sayısı görünür; bu sayı sıfır değilse canlıdaki durum sizin gördüğünüzden farklıdır.

2. Çift sayım

GA4'ün hem doğrudan gtag.js ile hem de GTM üzerinden yüklenmesi, sayfa görüntülemelerin ve olayların iki kat görünmesine yol açar. Aynı şekilde GTM kodunun hem temada hem eklentide eklenmesi de container'ın iki kez yüklenmesine neden olur. Hemen çıkma oranının şüpheli derecede düşük olması bu sorunun yaygın bir işaretidir.

3. Yanlış tetikleyici seçimi

Form gönderim tetikleyicisi her formda güvenilir çalışmaz; doğrulama hatası alan bir form da "gönderildi" sayılabilir veya JavaScript ile gönderilen form hiç yakalanmayabilir. Mümkünse geliştiriciden başarı anında dataLayer olayı göndermesini isteyin ya da teşekkür sayfası görüntülemesini tetikleyici olarak kullanın.

4. Yerleşik değişkenleri etkinleştirmemek

Click URL veya Click Text gibi değişkenler varsayılan olarak kapalıdır. Tetikleyici koşulunda bu değişkenleri bulamıyorsanız Değişkenler bölümünden etkinleştirmeniz gerekir.

5. Olay adında harf uyumsuzluğu

dataLayer'a Form_Gonderildi gönderilip tetikleyicide form_gonderildi yazılırsa tetikleyici çalışmaz. Olay adları için tek bir yazım standardı belirleyin; küçük harf ve alt çizgi kullanmak GA4 adlandırma kurallarıyla da uyumludur.

6. Kişisel veriyi göndermek

E-posta adresi, telefon numarası veya ad soyad gibi kişisel bilgileri GA4 olay parametrelerine ya da URL'ye eklemek Google Analytics politikalarına aykırıdır ve KVKK açısından da risk oluşturur. dataLayer'a gönderdiğiniz verileri bu gözle gözden geçirin.

7. Düzensiz adlandırma

"Etiket 1", "yeni tetikleyici" gibi adlar container büyüdükçe yönetimi imkânsız hale getirir. "GA4 - Olay - generate_lead" veya "Tetik - Özel Olay - form_gonderildi" gibi tutarlı bir şema kullanın.

8. Ölçümü kurup sonra hiç kontrol etmemek

Site güncellemeleri, tema değişiklikleri veya yeni eklentiler, aylarca sorunsuz çalışan bir etiketi bozabilir. Dönüşüm sayılarında ani düşüş gördüğünüzde ilk bakılacak yer, kodun hâlâ sitede olup olmadığı ve olayın hâlâ tetiklenip tetiklenmediğidir. Organik trafik verisini ölçüm verisiyle birlikte okumak için Search Console ve GA4 ile SEO analizi rehberimize göz atabilirsiniz. Search Console tarafının kurulumu için de Google Search Console nedir yazımız iyi bir başlangıç noktasıdır.

GTM ile ölçülebilecek tipik olaylar

OlayÖnerilen tetikleme yöntemiNot
Form gönderimidataLayer özel olayı veya teşekkür sayfası görüntülemeDönüşüm olarak işaretlemeye uygun
Telefon tıklamasıBağlantı tıklaması, Click URL "tel:" ile başlarAramanın gerçekleştiğini değil, tıklamayı ölçer
WhatsApp tıklamasıBağlantı tıklaması, Click URL "wa.me" veya "whatsapp" içerirFarklı WhatsApp bağlantı biçimlerini kapsayın
Dosya indirmeBağlantı tıklaması, Click URL ".pdf" içerirGA4 gelişmiş ölçüm bazı dosya türlerini zaten yakalar
Sepete ekleme / satın almadataLayer e-ticaret olaylarıGA4 e-ticaret olay şemasına uygun gönderilmeli
Üyelik tamamlamadataLayer özel olayıSunucu tarafında başarı kesinleştikten sonra gönderin

Ölçtüğünüz olayları yalnızca toplamak yetmez; hangi sayfaların ve arama sorgularının bu olaylara yol açtığını görmek gerekir. Search Console'dan gelen tıklama verisini GA4 dönüşümleriyle eşleştirmek, hangi içeriğin gerçekten iş getirdiğini ortaya koyar. Bu eşleştirmeyi elle yapmak yerine SEO Analytics panelinde Search Console, GA4 ve GTM verilerini tek ekranda görebilirsiniz.

Sık sorulan sorular

Google Tag Manager ücretli mi?

Hayır. Google Tag Manager'ın standart sürümü ücretsizdir. Büyük kuruluşlara yönelik ücretli bir kurumsal sürüm de bulunur, ancak çoğu web sitesi için ücretsiz sürüm yeterlidir.

GTM ile Google Analytics aynı şey mi?

Değil. Google Analytics veriyi toplayan ve raporlayan analiz aracıdır; Google Tag Manager ise Analytics dahil farklı araçların kodlarını sitede çalıştıran yönetim katmanıdır. GTM tek başına rapor üretmez.

GTM siteyi yavaşlatır mı?

Container kodu asenkron yüklendiği için tek başına etkisi genellikle sınırlıdır. Yavaşlığa asıl yol açan, container içine eklenen çok sayıda ağır üçüncü taraf script'tir. Kullanılmayan etiketleri düzenli olarak temizlemek performansı korur.

GTM kurulumu SEO'yu etkiler mi?

GTM'in sıralamaya doğrudan bir etkisi yoktur. Dolaylı etkisi iki yönlüdür: doğru kurulduğunda hangi içeriğin dönüşüm getirdiğini ölçmenizi sağlar; aşırı yüklendiğinde ise sayfa hızını düşürerek kullanıcı deneyimini olumsuz etkileyebilir.

Diğer yazılar

Google Tag Manager Nedir? Etiket, Tetikleyici ve Değişken Mantığı | SEO Analytics