Ana sayfa / Rehberler

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.

Yayınlandı 10 Ağustos 2026

Preview modu, Google Tag Manager'ı ayıklamanın resmi yolu ve tek bir konuda gerçekten çok iyi: bir tetikleyicinin neden o şekilde değerlendirildiğini söylemek. Bir yandan da sürekli karşınıza çıkan üç kısıtı var. O container'a düzenleme erişimi ister. Ayıkladığı sayfayı değiştirir. Ve yalnızca o tek container'daki tag'leri bilir ki bu, sayfadaki izlemenin tamamı olmaktan genellikle uzaktır.

Preview modunun kapsayamadıkları

• Erişiminiz olmayan bir container. İş başlamadan önceki müşteri sitesi, başka bir ajanstan devir, bir rakibin kurulumu, GTM hesabı işten ayrılmış birine ait olan kendi siteniz.
• GTM'de olmayan tag'ler. Temaya gömülü bir Meta pixel'i Preview için görünmezdir ve çift dönüşüme ve izin ihlallerine yol açan tam olarak o tag'dir.
• Ateşlendi ile gönderildi arasındaki boşluk. Preview tag'in ateşlendiğini söyler. Bir Content Security Policy kuralı, bir içerik engelleyici ya da bir ağ hatası isteği yine de durdurabilir. "Ateşlendi" ile "ulaştı" iki ayrı iddiadır.
• Preview altında farklı davranan sayfalar. Preview parametreler ve bir debug çerezi ekler; tek sayfalık uygulamalar, izin banner'ları ve bot koruması bunu her zaman iyi karşılamaz.

Dört soru

Bir GTM kurulumunu ayıklamak aslında arka arkaya dört sorudur ve her birinin tarayıcıdan alınabilecek bir cevabı vardır:

1. Container sayfada var mı? Bir gtm.js isteği size container kimliğini verir. dataLayer'ı yeniden adlandıran siteye dikkat edin — snippet'in son argümanı bu addır ve dataLayer değilse, konsola dataLayer yazmayı anlatan bütün rehberler o site için yanlıştır.
2. dataLayer event'i aldı mı? Push ya oldu ya olmadı; bu, GTM'in değil sitenin kendi kodunun sorusudur.
3. Bunun için bir tag ateşlendi mi? Yayınlanmış container herkese açık bir dosyadır. Onu okumak, "bu event'i dinleyen bir tag var mı" sorusunu cevaplar ki bu, "neden hiçbir şey olmuyor"un şaşırtıcı ölçüde sık çıkan cevabıdır.
4. İstek çıktı mı, neyle çıktı? Platforma bir şeyin ulaştığını kanıtlayan tek soru budur.

Preview olmadan container'ı okumak

gtm.js her ziyaretçiye açık şekilde sunulur; dolayısıyla yayınlanmış container yalnızca container kimliğinden okunabilir: içindeki tag'ler, tetikleyiciler ve o tetikleyicilerin hangi event'leri dinlediği. Bu, "geliştirici purchase tag'i var diyor" cümlesini kontrol edilebilir bir şeye çevirir.

Dürüst sınırlar: yayınlanmış sürümü görürsünüz, workspace'i değil; yayınlanmamış değişiklikler görünmez. Bir tetikleyicinin var olduğunu görürsünüz, bu sayfa yüklenmesinde neden doğru değerlendirildiğini değil. İkincisi tam olarak Preview modunun işidir ve Preview'ın araç çantasındaki yerini korumasının sebebi budur.

dataLayer ve iki tuzağı

Zamanlama. Sayfa yüklendikten sonra dataLayer'ı okuyan her şey, GTM'in çoktan işleyip yeniden yazdığı bir dizi görür. Yükleme sırasında olan push'lar — izin varsayılanları, ilk gtm.js event'i, satır içi ateşlenen e-ticaret gösterimleri — siz baktığınızda kaybolmuş olabilir. Diziyi sayfa scripti çalışmadan önce yakalayan bir izleyici tüm geçmişi görür; konsoldan alınan bir anlık görüntü görmez.

Kırılganlık. İzlemek için push'u değiştiren her şey, sitenin kendi kodunun ortasında duruyordur ve bunu özensiz yapmak sayfayı bozar. Döngüsel bir yapı, bir DOM düğümü ya da klonlanamayan bir değer içeren bir push, bozulmadan hayatta kalıp GTM'e değişmeden ulaşmak zorundadır. Ayıklama aracınız ayıkladığı şeyin davranışını değiştiriyorsa, ondan sonrası gürültüdür.

Push'tan isteğe

İşe yarayan görünüm, push'lar ile istekleri ayrı ayrı listelemek değil; her push'un yanına ona sebep olduğu istekleri koymaktır. Bunu kulağa geldiğinden zor kılan iki şey var. Platformlar aynı event'i farklı yazar — GA4'te purchase, Meta'da Purchase, TikTok'ta CompletePayment — yani eşleştirmenin bu sözlüğü bilmesi gerekir. Bir de GA4 gruplar; bir istek, sebebi olan push'tan çok sonra ve alakasız daha yeni isteklerden sonra görünebilir.

Tag ateşlenip hiçbir şey ulaşmadığında

Preview modunun başarı olarak raporladığı durum budur. Sırayla bakmaya değer:

• Content Security Policy. Sayfa, platformun script'ini yüklemeyi ya da uç noktasına bağlanmayı reddeder. Konsol bunu kısaca ve bir kez söyler.
• İzin engeli. Tag ateşlendi, izin durumu reddedildi diyordu ve platformun kendi script'i göndermemeyi seçti.
• Sayfadan ayrılma zamanlaması. Bağlantı tıklamasında veya form gönderiminde ateşlenen bir tag, gezinmeyle yarışır. sendBeacon olmadan istek yolda iptal edilir ve hiçbir yere kaydedilmez.
• Bir engelleyici. Sizinki ya da ziyaretçinin. Kendi tarayıcınızda ayıklarken unutulması çok kolaydır.

İhtiyacınız olan tetikleyiciyi kurmak

GTM işinin çoğu ayıklama değil, tekrar eden aynı küçük görevdir: sayfadaki bir şeyin event'e dönmesi gerekir. Öğeye tıklayıp karşılığında kararlı bir CSS seçici, bir tetikleyici koşulu ve değeri çıkaran bir değişken almak, beş dakika ile yarım saat arasındaki farktır — özellikle sınıf adları üretilen ve her dağıtımda değişen sitelerde.

Preview modunun hâlâ doğru olduğu yer

Soru neden olduğunda. Bu tetikleyici, ateşlenmemesi gereken bir sayfada neden ateşlendi. Tag çalıştığı anda hangi değişken boştu. Arama tablosu ne döndürdü. GTM'in kendi değerlendirmesinin içini görebilen tek şey Preview'dır ve ne kadar istek okursanız okuyun yerini tutmaz. Bir şeyin yanlış olduğunu ve nerede olduğunu bulmak için istekleri, nedenini bulmak için Preview'ı kullanın.

İlgili rehberler

• TikTok, Snap, UET ve beş platform için Test Events
• Canlı raporları kirletmeden izleme testi
• Sonraki dağıtımda bozulmayacak bir GTM tıklama tetikleyicisi