Ana sayfa / GTM debugger

Canlı sayfalar için GTM debugger

Google Tag Manager'ı sayfanın gerçekten ne gönderdiğini okuyarak hata ayıklayan bir Chrome eklentisi — canlıda, staging'de, size ait olmayan bir sitede.

Google Tag Manager kendi debugger'ı ile geliyor: Preview Mode. Bir işi iyi yapıyor, bir işi de yapısı gereği hiç yapamıyor. Container'ınızı biliyor — her tetikleyici, her değişken, çalışan ve çalışmayan her tag ve nedeni. Ardından tarayıcıdan çıkan istek hakkında hiçbir şey bilmiyor ve container'ını açamadığınız bir sitede hiç çalışmıyor.

Tag Master öbür uçtan çalışıyor. Ağı izliyor, sayfanın gönderdiği her takip isteğini çözüyor ve her birini onu doğuran dataLayer push'una bağlıyor. Yani GTM'i canlı sayfada, preview oturumu olmadan, URL'de gtm_debug parametresi olmadan ve container'a hiç erişmeden hata ayıklıyor.

Preview Mode'un gösteremedikleri

Dört şey, ve her biri Preview Mode'un sağlıklı diye raporladığı bir hata sınıfı:

• İsteğin kendisi. Preview Mode GA4 tag'inin çalıştığını söyler. /g/collect'in boş bir items dizisiyle gittiğini, para biriminin eksik olduğunu ya da iki parametrenin kırpıldığını söylemez.
• Google tag'i olmayan her şey. Meta, TikTok, LinkedIn, Criteo, Adobe — çoğu container Google'dan çok Google dışı tag çalıştırır ve Preview Mode hepsine kördür.
• Debug oturumu yokken ne olduğu. Preview Mode sayfayı değiştirir: çerez yazar, parametre ekler ve container'ı debug'a alır. Consent banner'ları, A/B testleri ve bot filtreleri bunun altında farklı davranır.
• Başkasının sitesi. Bir rakibi, sözleşme öncesi bir müşteriyi ya da oturum açmadığınız bir cihazdan kendi sitenizi denetlemek — Preview Mode container erişimi ister. Ağı okumak istemez.

Onun yerine gördükleriniz

Sırasıyla her dataLayer push'u ve her birinin altında ürettiği istekler. İnsanların bir debugger'ı açarken sorduğu asıl soruyu bu görünüm cevaplıyor — "tag çalıştı mı" değil, "doğru değerler tarayıcıdan çıktı mı".

Yanında: sayfadaki container kimlikleri, her tag'in gönderdiği ölçüm kimlikleri, her isteğin çıktığı andaki consent durumu ve platformun kendi şemasının kabul etmediği bir parametre taşıyan isteklerin işareti.

Bir container'ı dört adımda ayıklayın

1. İncelemek istediğiniz sayfanın yanında yan paneli açın. Sayfaya hiçbir şey enjekte edilmez ve siz açana kadar hiçbir şey kaydedilmez.
2. Yenileyin, sonra bozuk olan şeyi yapın — ürünü görüntüleyin, sepete ekleyin, formu gönderin.
3. dataLayer event'ini listede bulun. Orada yoksa sorun GTM'in yukarısındadır ve ne kadar tetikleyici uğraşırsanız uğraşın düzelmez.
4. Altındaki istekleri açıp çözülmüş parametreleri okuyun. Eksik bir value, yanlış bir currency ya da yinelenen bir event_id burada görünür.

Oradan event'i seçip ona ait GTM değişkenlerini ve tetikleyicisini üretebilirsiniz; işin aksi hâlde GTM'e elle yol yazmaktan ibaret olan kısmı budur.

Sunucu taraflı GTM

Sunucu taraflı bir container toplama uç noktasını kendi alan adınıza taşır; hata ayıklamayı zorlaştıran da tam olarak budur, çünkü istek artık tanıdık bir yere gitmez. Tag Master birinci taraf uç noktayı tespit eder, sunucu taraflı olarak işaretler ve yükü Google'ın kendi alan adına giden bir istekmiş gibi çözer.

İnsanları yanıltan ayrıntı şu: birinci taraf bir uç nokta ile Google Tag Gateway tarayıcıdan neredeyse aynı görünür. Hangisine baktığınız hatanın nerede olabileceğini değiştirir.

Preview Mode'un hâlâ kazandığı yer

Tetikleyici mantığı. Bir tag çalışmadığında hangi koşulun tutmadığını bilmeniz gerekiyorsa Preview Mode'un değerlendirme görünümü doğru araçtır ve ağı okuyan hiçbir şey onun yerini alamaz — o akıl yürütme GTM'in içinde olur, hatta hiç ulaşmaz. İkisi birbirini tamamlar: Preview Mode container'ın kararlarını açıklar, ağ debugger'ı o kararların sonucunu gösterir.

Aynı dürüstlük sahanın geri kalanı için de geçerli. Tag Assistant, Omnibug ve Analytics Debugger'ın her biri tam karşılaştırmada bir satır kazanıyor ve birini seçmeden önce hangisini kazandığını bilmekte fayda var.

Sorular

Preview Mode olmadan GTM debug edebilir miyim?

Evet. Preview Mode yalnızca container'ın kendi mantığını incelemek için gerekli. Hangi tag'lerin çalıştığını ve ne gönderdiklerini görmek için ağı okuyan bir debugger'a debug oturumu, gtm_debug parametresi ya da container erişimi gerekmez.

Bana ait olmayan sitelerde çalışır mı?

Evet. İncelenen siteden hiçbir şey istenmez — container erişimi de kod değişikliği de. Rakip denetimlerini ve sözleşme öncesi incelemeleri mümkün kılan fark budur.

Sunucu taraflı GTM'i ayıklıyor mu?

Evet. Birinci taraf toplama uç noktası tespit edilip işaretlenir ve yükü diğer istekler gibi çözülür. Google Tag Gateway uç noktası ayrıca raporlanır, çünkü ikisi tarayıcıdan benzer görünür ama farklı şeyler anlatır.

Tag Assistant'ın yerini tutar mı?

Google'ın kendi tag'leri dışındaki her şeyde belirgin biçimde daha fazlasını kapsıyor: 52 platform ve her isteğin arkasındaki consent durumu. Tag Assistant, GTM'in kendi preview oturumuna bağlı araç olmayı sürdürüyor. Tam karşılaştırma her birinin kazandığı satırları listeliyor.

Verilerimi bir yere gönderiyor mu?

Hayır. Kaydedilen oturumlar tarayıcıda kalır. Hesap yok, telemetri yok ve gönderilecek bir sunucu yok.

Rehberler

İnsanları yanıltan kısımların uzun hâli.

• Preview modu olmadan GTM ayıklama — Preview, container erişimi ister, sayfayı değiştirir ve yalnızca tek bir container adına konuşur. GTM'i ürettiği isteklerden doğrulamanın yolu.
• Server-side GTM nasıl ayıklanır — Proxy’lenen isteklerin çoğu araçta neden kaybolduğu, sGTM kurulumunu ele veren dört sinyal ve sunucu önizleme oturumuna nasıl bağlanılacağı.
• Tek tıklama, üç push: doğru dataLayer event'ini seçmek — Sepete ekleme nadiren tek event ateşler. Gerçek bir mağazanın ne push ettiği, tetikleyicinin hangisini kullanması gerektiği ve asla cevap olmayan dört push türü.
• 2026’da Tag Assistant alternatifi — Google Tag Assistant neyi iyi yapar, nerede durur ve size asla göstermeyeceği etiketler için ne kullanmalısınız.
• Yakalanan dataLayer push'larını içe aktarılabilir bir GTM container'ına çevirmek — Bir container dışa aktarım dosyasında ne bulunmalı, hangi iki alan bütün içe aktarımı reddettiriyor ve yer tutucular neden boşluktan iyi.
• Consent Mode V2 ayıklama: gcs, gcd ve kimsenin yakalamadığı ihlaller — İzin parametrelerini doğrudan isteklerden okuyun, varsayılanı güncellemeden ayırın ve banner ne derse desin ateşlenen platformları bulun.

Diğer ikisi: GA4 debugger, dataLayer inceleyici