GTM Lookup Tables: Yüzlerce Etiketi Tek Tabloya Sığdırmak

GTM Lookup Tables: Yüzlerce Etiketi Tek Tabloya Sığdırmak

Google Tag Manager hesabınızı ilk kurduğunuzda her şey sade görünür. Birkaç etiket, birkaç tetikleyici, iki üç değişken. Sonra site büyür. Yeni kategoriler açılır, blog bölümü genişler, kampanya sayfaları eklenir. Bir bakmışsınız container’da yüz elli tane neredeyse birbirinin aynısı kural var ve hiçbirine dokunmaya cesaret edemiyorsunuz.

Bu noktaya gelen ekiplerin çoğu sorunu yanlış yerde arıyor. Sorun etiket sayısı değil, mantığın nerede durduğu. Lookup Table değişkeni tam da bunu düzeltiyor: kuralları etiketlerin içine dağıtmak yerine tek bir tabloda toplamanızı sağlıyor. Dijital pazarlama tarafında düzenli olarak paylaştığım pratik yöntemler için ana sayfayı takip edebilirsiniz.

İçindekiler

• Lookup Table Tam Olarak Ne Yapıyor?
• Gerçek Hayatta Nerede İşe Yarıyor?
• Adım Adım Kurulum
• Lookup Table mı, RegEx Table mı?
• Sık Yapılan Beş Hata
• Uzun Vadeli Bakım Avantajı
• Sıkça Sorulan Sorular

Lookup Table Tam Olarak Ne Yapıyor?

Lookup Table, bir giriş değerine bakıp karşılığında önceden tanımladığınız çıktıyı döndüren bir GTM değişkeni. Programlamadaki switch-case yapısının arayüzü diyebiliriz.

Mantığı şöyle işliyor: Giriş değişkeni olarak diyelim ki Page Path‘i seçtiniz. Tabloya satır satır eşleşmeleri yazıyorsunuz. Sayfa yolu /urunler/ayakkabi ise çıktı “Ayakkabı”, /blog/ ise çıktı “Blog”. Hiçbiri tutmazsa Default Value devreye giriyor.

Kritik nokta şu: Lookup Table tam eşleşme arar. “İçeriyorsa” veya “ile başlıyorsa” gibi esnek koşullar burada çalışmaz. Bu ayrıntıyı atlayan ekiplerin tablosu sessizce boş dönmeye başlar ve kimse haftalarca fark etmez. Aşağıda bunun çözümüne değineceğim.

Gerçek Hayatta Nerede İşe Yarıyor?

Sayfa tipi sınıflandırması

En yaygın kullanım bu. Sitenizdeki her URL’yi Homepage, Kategori, Ürün Detay, Blog, Sepet, Ödeme gibi kovalara ayırıyorsunuz. Sonra bu değeri GA4’e özel boyut olarak gönderiyorsunuz.

Kazancı somut: GA4’te “ürün detay sayfalarında ortalama etkileşim süresi ne?” sorusunun cevabı tek bir filtreye iniyor. URL’lerle boğuşmuyorsunuz. Bin sayfalık bir e-ticaret sitesinde bu fark, raporun okunabilir olmasıyla olmaması arasındaki fark.

Çoklu domain ve çoklu hesap yönetimi

Aynı GTM container’ını birden fazla sitede kullanıyorsanız, her site için ayrı GA4 etiketi kurmak yerine hostname’i giriş değişkeni yapıp ölçüm kimliğini tablodan döndürebilirsiniz. Beş site, beş ayrı etiket yerine tek etiket ve beş satırlık bir tablo.

Bu yapı aynı zamanda insan hatasını azaltıyor. Yeni bir domain eklendiğinde container’ı baştan incelemek yerine tabloya bir satır yazıyorsunuz.

Dil ve pazar segmentasyonu

Uluslararası siteler için /tr/, /en/, /de/ gibi yol öneklerini dil koduna çeviren bir tablo, GA4’teki pazar bazlı raporlamanın temelini kuruyor. Türkiye’de faaliyet gösterip Avrupa’ya satış yapan e-ticaret markaları için bu, kampanya bütçesini nereye kaydıracağınıza karar verirken doğrudan işinize yarayan bir veri.

Kategori bazlı dönüşüm değeri

Farklı ürün kategorilerinin kâr marjı farklıysa, dönüşüm değerini de farklı hesaplamak isteyebilirsiniz. Kategori bilgisini lookup table ile çekip çarpan olarak kullanmak, Google Ads tarafında akıllı teklif stratejilerinin daha isabetli çalışmasını sağlıyor.

Adım Adım Kurulum

GTM arayüzünde şu yolu izliyorsunuz:

1. Variables → User-Defined Variables → New diyorsunuz.
2. Variable Type olarak Lookup Table‘ı seçiyorsunuz.
3. Input Variable alanında karar verici değişkeni belirliyorsunuz. Genelde Page Path, Page Hostname veya bir Data Layer değişkeni.
4. Add Row ile satırları ekliyorsunuz. Sol sütun giriş değeri, sağ sütun döneceği çıktı.
5. Set Default Value kutusunu işaretleyip bir varsayılan yazıyorsunuz. Buraya “(not set)” değil, “Diğer” gibi anlamlı bir şey yazın — raporda ne olduğunu anlamak kolaylaşır.
6. Değişkene tanınabilir bir isim veriyorsunuz. LT - Sayfa Tipi gibi bir önek kullanmak, altı ay sonra container’a bakan kişiye (muhtemelen yine siz) yardım eder.

Kaydettikten sonra Preview modunda birkaç farklı sayfayı gezin ve değişkenin doğru değeri döndürdüğünü gözünüzle görün. Yayınlamadan önceki bu iki dakika, sonradan haftalarca bozuk veri toplamanın önüne geçiyor.

Lookup Table mı, RegEx Table mı?

GTM’de aynı işi yapan ikinci bir değişken tipi daha var: RegEx Table. Farkı şu:

• Lookup Table: Giriş değerinin tabloda yazana birebir eşit olması gerekiyor. Sınırlı sayıda, net değer varsa ideal — hostname listesi, dil kodları, kampanya isimleri gibi.
• RegEx Table: Düzenli ifadelerle desen eşleştiriyor. ^/urunler/ yazdığınızda o klasör altındaki tüm sayfalar tek satırla yakalanıyor. Ayrıca büyük-küçük harf duyarlılığını kapatma ve tam eşleşme zorunluluğunu açma seçenekleri var.

Pratik tavsiyem: URL yapısıyla çalışıyorsanız neredeyse her zaman RegEx Table’a geçin. Lookup Table’ı ise kaynağı kontrollü ve sonlu olan veriler için saklayın. Çoğu ekibin “lookup table çalışmıyor” dediği durum, aslında RegEx Table kullanması gereken bir senaryoyu Lookup Table ile çözmeye çalışmasından kaynaklanıyor.

Sık Yapılan Beş Hata

1. Tam eşleşme tuzağı. Tabloya /urunler yazıp /urunler/kadin/canta sayfasında çalışmasını beklemek. Çalışmaz.

2. Query string’i unutmak. Page URL’i giriş olarak seçerseniz ?utm_source=... parametreleri eşleşmeyi bozar. Page Path kullanın veya RegEx Table’a geçin.

3. Default Value’yu boş bırakmak. Eşleşme olmadığında değişken undefined döner ve GA4 raporunda o satır tamamen kaybolur. Veri kaybını fark etmeniz aylar alabilir.

4. Tabloyu şişirmek. Yüz elli satırlık bir lookup table, yüz elli etiketten daha iyidir ama hâlâ bakım yükü demektir. Bu boyuta ulaştıysanız veriyi Data Layer üzerinden CMS’ten göndermek daha doğru bir çözüm.

5. Preview’de test etmeden yayınlamak. En ucuz hata, en sık yapılanı. Bu arada tetikleyici ve değişken hatalarının ölçüme nasıl sızdığını GA4 ile form hatalarını izleme yazısında da ele almıştım; oradaki mantık burada da geçerli.

Uzun Vadeli Bakım Avantajı

Lookup Table’ın asıl değeri kurulum anında değil, altı ay sonra ortaya çıkıyor.

Siteye yeni bir kategori eklendiğini düşünün. Dağınık yapıda: ilgili tüm etiketleri bulmak, hangisinin ne yaptığını hatırlamak, birer birer güncellemek, hiçbirini bozmadığınızı ummak. Tablo yapısında: tek bir değişkeni açıp bir satır eklemek.

Ölçüm altyapısı düzenli olan hesaplarda kampanya kararları da daha hızlı alınıyor, çünkü veriye güven artıyor. UTM ve parametre hijyeninin bu güveni nasıl etkilediğine dair iç linklerde UTM parametresi kullanmak yazısı da tamamlayıcı bir okuma olur. Konunun tamamına GA4 kategorisinden göz atabilirsiniz.

Sıkça Sorulan Sorular

Bir lookup table kaç satır olabilir?

GTM tarafında katı bir üst sınır yok, yüzlerce satır teknik olarak çalışıyor. Ama pratikte otuz-kırk satırı geçtiyseniz yapıyı sorgulayın. O noktada veriyi Data Layer üzerinden dinamik göndermek hem daha hızlı hem daha az kırılgan.

Lookup table sayfa hızını etkiler mi?

Ölçülebilir bir etkisi yok. Değerlendirme tarayıcıda, container yüklendikten sonra ve mikrosaniyeler içinde gerçekleşiyor. Asıl performans yükü etiketlerin kendisinde — özellikle üçüncü taraf piksellerinde.

Lookup table içinde başka bir değişken kullanabilir miyim?

Evet. Hem giriş değişkeni hem de çıktı değerleri {{Değişken Adı}} söz dizimiyle başka değişkenlere referans verebilir. Bu, iç içe tablo kurmanıza olanak tanıyor — ama okunabilirlik hızla düştüğü için iki katmandan fazlasına inmemenizi öneririm.

Server-side GTM’de de çalışıyor mu?

Evet, sunucu tarafı container’larda da Lookup Table ve RegEx Table değişkenleri mevcut. Giriş olarak istek başlıklarını veya olay verilerini kullanabilirsiniz. Mantık aynı, sadece veri kaynağı farklı.

Mevcut yüzlerce etiketimi tabloya nasıl taşırım?

Hepsini birden değil, kategori kategori taşıyın. Önce yeni değişkeni kurup Preview’de doğru çalıştığını doğrulayın, ardından eski etiketleri gruplar hâlinde devre dışı bırakın. Silmeyin — iki hafta pasif bekletip veri akışında kayma olmadığını gördükten sonra temizleyin.

Toparlarsak

Lookup Table, GTM’in en eski ve en az kullanılan özelliklerinden biri. Gösterişli değil, ama bir container’ın beş yıl mı yaşayacağını yoksa iki yıl sonra sıfırdan mı kurulacağını belirleyen şey genelde tam da bu tür kararlar.

Bugün yapabileceğiniz en küçük adım şu: Container’ınızı açın, birbirine çok benzeyen üç etiket bulun ve aralarındaki tek farkın ne olduğuna bakın. O fark, kuracağınız ilk tablonun çıktı sütunu.

Ölçüm altyapınızı sıfırdan kurmak veya mevcut yapıyı sadeleştirmek istiyorsanız Google Analytics ve Tag Manager eğitimi sayfasına göz atabilir, ya da doğrudan iletişim formundan yazabilirsiniz. Formu dolduran herkese 24 saat içinde dönüyorum.

Kaynakça

Ahava, S. (2020). The RegEx Table variable in Google Tag Manager. https://www.simoahava.com/analytics/the-regex-table-variable-in-google-tag-manager/

Google. (2026). Variables — Tag Manager Help. https://support.google.com/tagmanager/answer/7683362

Searchviu. (2026). GTM lookup table: How to use Google Tag Manager lookup tables. https://www.searchviu.com/en/lookup-tables-google-tag-manager/