Google Tag Manager Kurulumu ve İlk Etiket
Google Tag Manager kapsayıcısını kurup ilk GA4 etiketini oluşturmayı, tetikleyici ve değişken mantığını, data layer ile olay göndermeyi ve güvenli yayınlamayı anlatıyoruz.

Google Tag Manager kurulumu için tagmanager.google.com'da hesap ve web kapsayıcısı oluşturur, verilen iki kod parçasını sitenizin head ve body bölümlerine eklersiniz. Ardından panelde ilk etiketi (ör. GA4 için Google etiketi) oluşturup bir tetikleyiciye bağlar, Önizleme modunda test eder ve Gönder düğmesiyle yayınlarsınız.
GTM Nedir, Ne İşe Yarar?
Google Tag Manager (GTM), sitenize eklenen analiz, reklam ve ölçüm kodlarını tek bir panelden yönetmenizi sağlayan ücretsiz etiket yönetim sistemidir. Siteye yalnızca bir kez kapsayıcı kodu eklenir; GA4, Google Ads, Meta Pikseli gibi diğer kodlar bu kapsayıcının içinden çalıştırılır.
En büyük faydası, her yeni ölçüm ihtiyacında yazılımcıya ve kod yayınına bağımlı kalmamaktır. Pazarlama ekibi yeni bir dönüşüm etiketini panelde hazırlar, önizlemede test eder ve yayınlar. Her yayın bir sürüm olarak saklandığı için hatalı bir değişiklik tek tıkla geri alınabilir.
GTM'in bir sorumluluğu da vardır: kapsayıcıya erişimi olan herkes siteye kod ekleyebilir. Bu yüzden yetkileri dikkatli dağıtmak ve gereksiz etiketleri düzenli temizlemek gerekir.
Etiket, Tetikleyici ve Değişken
GTM'i anlamanın anahtarı üç temel kavramdır. Her kurulum, bu üç parçanın birbirine bağlanmasından oluşur.
| Kavram | Ne işe yarar? | Örnek |
|---|---|---|
| Etiket (tag) | Çalıştırılacak kod | GA4 etkinliği, Google Ads dönüşümü, Meta Pikseli |
| Tetikleyici (trigger) | Etiketin ne zaman çalışacağı | Tüm sayfalar, form gönderimi, belirli bir tıklama |
| Değişken (variable) | Etikete ve tetikleyiciye taşınan bilgi | Sayfa adresi, tıklanan bağlantı, sipariş tutarı |
Data layer nedir?
Data layer, sitenizin GTM'e bilgi aktardığı ortak bir JavaScript dizisidir. Sipariş numarası, ürün bilgisi ya da form adı gibi sayfada görünmeyen verileri buraya yazarsınız; GTM bu verileri değişken olarak okuyup etiketlere aktarır. Böylece ölçüm, sayfa tasarımı değiştiğinde bozulmayan sağlam bir zemine oturur.
Hesap ve Kapsayıcı Oluşturma
tagmanager.google.com adresine işletmenin Google hesabıyla girin. Hesap ve kapsayıcı işletme adına açılmalı, ajansa yalnızca kullanıcı yetkisi verilmelidir; iş birliği sona erdiğinde ölçüm altyapınız sizde kalır.
- Hesap oluştur düğmesine basın, hesap adına işletme adınızı yazın ve ülkeyi seçin.
- Kapsayıcı adına sitenizin adresini yazın ve hedef platform olarak Web seçin.
- Hizmet şartlarını kabul edin; ekrana kurulum kodları gelir.
- GTM- ile başlayan kapsayıcı kimliğini not edin.
Kapsayıcı Kodunu Siteye Ekleme
GTM iki kod parçası verir. İlki her sayfanın head bölümünde, mümkün olduğunca yukarıda yer almalıdır. İkincisi JavaScript kapalı tarayıcılar için yedektir ve açılış body etiketinin hemen ardından eklenir. Ortak bir şablon ya da başlık dosyası kullanıyorsanız kodu yalnızca bir yere eklemeniz tüm sayfaları kapsar.
<!-- 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 --><!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXXX"
height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<!-- End Google Tag Manager (noscript) -->Altyapı panelinden ekleme
Pek çok hazır sistem kapsayıcı kimliği için ayrı bir alan sunar ve kodu doğru yerlere kendisi yerleştirir. Aurora'nın e-ticaret altyapısında Google Tag Manager kodu panelden eklenir ve canlı kontrol ekranı kodun gerçekten çalışıp çalışmadığını gösterir.
İlk Etiket: GA4 Google Etiketi
Kapsayıcı yüklendikten sonra ilk iş genellikle GA4 ölçümünü GTM üzerinden başlatmaktır. GA4 mülkünüz henüz yoksa önce Google Analytics 4 kurulumu adımlarıyla ölçüm kimliğini alın.
Google etiketi sayfa görüntülemelerini ve gelişmiş ölçüm etkinliklerini toplar. Ek etkinlikler için ayrı GA4 Etkinliği etiketleri oluşturur, ölçüm kimliğini ve etkinlik adını yazar, uygun tetikleyiciye bağlarsınız. Google Ads dönüşümleri için de aynı mantık geçerlidir: Google Ads panelinden aldığınız dönüşüm kimliği ve etiketiyle bir Google Ads Dönüşüm İzleme etiketi oluşturup bunu teşekkür sayfasına ya da satın alma olayına bağlamanız yeterlidir. Etiket adlarında araç, tür ve amaç sırasını korumak, kapsayıcı büyüdükçe aradığınızı kolayca bulmanızı sağlar.
- Etiketler menüsünden Yeni düğmesine basın ve etikete anlaşılır bir ad verin (ör. GA4 - Google Etiketi).
- Etiket yapılandırmasında Google Etiketi türünü seçin ve G- ile başlayan ölçüm kimliğinizi yazın.
- Tetikleme bölümünde Initialization - All Pages (Başlatma - Tüm Sayfalar) tetikleyicisini seçin; böylece etiket diğer etiketlerden önce yüklenir.
- Kaydedin. Etiket henüz canlı değildir; sırada önizleme ve yayınlama var.
Data Layer ile Olay Gönderme
Form gönderimi ya da satın alma gibi önemli anlarda sitenin data layer'a bir olay yazması en güvenilir ölçüm yöntemidir. Tıklama ya da sayfa adresi gibi görünür öğelere dayanan tetikleyiciler, tasarım değiştiğinde sessizce bozulabilir.
Aşağıdaki örnekte form başarıyla gönderildiğinde form_gonderildi adlı bir olay yazılır. GTM'de Özel Etkinlik türünde, olay adı form_gonderildi olan bir tetikleyici oluşturur, GA4 Etkinliği etiketini bu tetikleyiciye bağlarsınız. Form adını okumak için de Data Layer Değişkeni türünde form_adi adlı bir değişken tanımlarsınız.
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
event: 'form_gonderildi',
form_adi: 'teklif_formu'
});Tek sayfa uygulamalarda (SPA)
React ya da Vue ile yazılmış tek sayfa uygulamalarda sayfa geçişleri tarayıcıyı yeniden yüklemez. Bu durumda Geçmiş Değişikliği (History Change) tetikleyicisini kullanabilir ya da yönlendirici her sayfa değiştiğinde data layer'a bir olay yazabilirsiniz. Proje kurulumunu Vite ile React kurulumu rehberinde anlattık.
Önizleme, Test ve Yayınlama
Hiçbir değişikliği test etmeden yayınlamayın. Sağ üstteki Önizle düğmesi Tag Assistant'ı açar; sitenizin adresini yazdığınızda site hata ayıklama modunda açılır ve her sayfa ya da olayda hangi etiketin çalıştığını, hangisinin çalışmadığını tek tek görürsünüz.
Testten memnunsanız Gönder düğmesine basın, sürüme açıklayıcı bir ad ve kısa bir not yazın. Sürüm adına ne değiştiğini yazmak, aylar sonra bir ölçüm sorunu çıktığında hangi değişikliğin buna yol açtığını bulmanızı kolaylaştırır.
- GA4 tarafında etkinliklerin geldiğini DebugView ekranından da doğrulayın.
- Sorun çıkarsa Sürümler menüsünden önceki sürümü yeniden yayınlayabilirsiniz.
- Büyük ekiplerde ayrı çalışma alanları açarak değişikliklerin birbirine karışmasını önleyin.
Sık Hatalar ve İyi Uygulamalar
Zamanla kapsayıcıda kullanılmayan etiketler birikir ve her biri sayfa yüküne eklenir. Üç ayda bir kapsayıcıyı gözden geçirip kullanılmayan etiketleri duraklatmak, hem ölçüm karmaşasını hem de sayfa hızı üzerindeki yükü azaltır; bu konu hız ve performans yönetimi çalışmalarımızın da düzenli bir parçasıdır.
Ziyaretçi onayı alınmadan reklam ve ölçüm etiketlerinin çalıştırılmaması gerekir. GTM'in izin ayarları ve Consent Mode yapılandırması bu akışı yönetir. Bu yazı genel bilgi verir; çerez onay yapınız için güncel mevzuatı ve hukuk danışmanınızı kontrol edin.
| Sorun | Çözüm |
|---|---|
| Veriler iki kat sayılıyor | GA4 hem gtag.js ile hem GTM ile yüklenmiş; birini kaldırın. |
| Önizleme siteye bağlanamıyor | Reklam engelleyici ya da tarayıcı ayarları; eklentisiz pencerede deneyin. |
| Etiket önizlemede çalışıyor, canlıda yok | Değişiklikler yayınlanmadı; Gönder adımını tamamlayın. |
| Tıklama tetikleyicisi çalışmıyor | Gerekli yerleşik tıklama değişkenleri etkin değil; Değişkenler menüsünden açın. |
Sık Sorulan Sorular
01GTM siteyi yavaşlatır mı?
Kapsayıcı kodu eşzamansız yüklendiği için tek başına belirgin bir yavaşlık yaratmaz. Asıl yük, kapsayıcının içine eklenen etiketlerin sayısı ve ağırlığından gelir; gereksiz etiketleri kaldırmak bu yüzden önemlidir.
02Meta Pikseli'ni GTM ile kurabilir miyim?
Evet. Piksel temel kodunu Özel HTML etiketiyle ya da topluluk şablonlarından biriyle ekleyip olayları data layer tetikleyicilerine bağlayabilirsiniz. Ayrıntılar Meta Pixel kurulumu rehberimizde.
03Sunucu taraflı GTM nedir?
Sunucu taraflı kapsayıcı, ölçüm isteklerini önce sizin yönettiğiniz bir sunucuya gönderir, oradan analiz ve reklam platformlarına iletir. Veri üzerinde daha fazla kontrol sağlar ama barındırma maliyeti ve teknik bakım gerektirir; çoğu küçük site için web kapsayıcısı yeterlidir.
Doğru kurulmuş bir Tag Manager, reklam ve analiz ölçümünü kod yayınına bağımlı olmadan, test edilebilir ve geri alınabilir biçimde yönetmenizi sağlar. Dönüşüm takibini uçtan uca kurmak ve kampanyaları bu verilerle yönetmek için dijital pazarlama hizmetimize, raporlama ve yorum için SEO ve analiz çözümlerimize göz atın. Ölçüm kodları baştan planlanmış bir landing page tasarımı için de bize ulaşabilirsiniz.

