Web için kullanıcı tanımlı değişken türleri

Yerleşik değişkenlerin karşılayamadığı belirli gereksinimlere uyacak şekilde, Google Etiket Yöneticisi'nde kullanıcı tanımlı özel web değişkenleri oluşturun.

Yeni bir kullanıcı tanımlı değişken oluşturmak için:

1. Soldaki gezinme panelinde Değişkenler'i tıklayın.
2. Kullanıcı Tanımlı Değişkenler bölümünde Yeni'yi tıklayın.
3. Değişken Yapılandırması'nı tıklayın ve istediğiniz değişken türünü seçin.
4. Seçilen değişken türü için yapılandırma seçeneklerini girin.
5. Değişkene ad verin. Değişkenin işlevini tanımlayan bir adlandırma düzeni kullanın (ör. "Veri Katmanı Değişkeni - Ürün Adı").
6. Kaydet'i tıklayın.

Etiket Yöneticisi, web için bu kullanıcı tanımlı değişken türlerini destekler:

• Gezinme
  • HTTP Yönlendiren
  • URL
• Sayfa değişkenleri
  • Birinci taraf çerezi
  • Özel JavaScript
  • Veri katmanı
• Sayfa öğeleri
  • Otomatik etkinlik değişkeni
  • DOM öğesi
  • Öğe görünürlüğü
• Yardımcı programlar
  • Sabit
  • Özel etkinlik
  • Ortam adı
  • Google Analytics ayarları
  • Google Etiketi: Yapılandırma Ayarları
  • Google Etiketi: Etkinlik Ayarları
  • Arama tablosu
  • Rastgele sayı
  • RegEx tablosu
• Kullanıcı tarafından sağlanan veriler
• Kapsayıcı verileri
  • Kapsayıcı kimliği
  • Kapsayıcı sürümü numarası
  • Hata ayıklama modu

Gezinme

HTTP Yönlendiren

Değer, kullanıcının ziyaret ettiği önceki sayfanın URL'si olan HTTP yönlendiren olarak ayarlanır. Örneğin, kullanıcı ana sayfadan ürün sayfalarının birine giderse, yönlendiren ana sayfa olur. Bu değişken türünün bir örneği Etiket Yöneticisi tarafından otomatik olarak oluşturulur, ancak yönlendiren URL'nin farklı kısımlarını göstermek istiyorsanız başka örnekler de oluşturabilirsiniz.

URL

Bu değişken türü, URL bileşenlerini ayrıştırmanızı ve göstermenizi sağlar. URL'nin farklı kısımlarını göstermek için başka örnekler de oluşturabilirsiniz. Seçebileceğiniz URL bileşenleri şunlardır: Tam URL, Protokol, Ana Makine Adı, Bağlantı Noktası, Yol, Dosya Adı Uzantısı, Sorgu ve Parça. Bu tür değişkenler için ayarlanan giriş değeri, kullanıcının bulunduğu sayfanın URL'sidir (document.location'dan alınır). URL Kaynağı'nı, Etiket Yöneticisi'ne URL değerinin kaynağı olarak başka bir değişken kullanmasını bildirecek şekilde ayarlayın.

Sayfa değişkenleri

Birinci taraf çerezi

Bu değer, kullanıcının hâlihazırda bulunduğu alanın adıyla birlikte birinci taraf çerezi olarak ayarlanır. Aynı alanda, aynı ada sahip birden fazla çerez dağıtılmışsa ilk değer seçilir. Bu işlem, document.cookie'yi bir sayfadan çağırıp ilk sonucu seçmenizle aynıdır.

Özel JavaScript

Değer, bir JavaScript işlevinin sonucu olarak ayarlanır. JavaScript, bir değer döndüren isimsiz bir işlev biçimini almalıdır. Örneğin, önceden tanımlı {{url}} değişkeninin tüm örneklerini küçük harfe dönüştürmek için özel bir JavaScript değişkeni oluşturulabilir:

function () {
  return {{url}}.toLowerCase();
}

Veri katmanı

Değer, dataLayer.push() çağrısıyla veri katmanına veri aktarıldığında ayarlanır:
dataLayer.push({"Data Layer Name": "value"}).

Etiket Yöneticisi'nin anahtar adındaki noktaları (".") nasıl yorumlayacağını belirtebilirsiniz:

• 1. Yöntem: Anahtar adlarında noktalara izin verilir. Örneğin, dataLayer.push("a.b.c": "value") için, anahtarın adı "a.b.c" (yani {"a.b.c": "value"}) olarak yorumlanır.
• 2. Yöntem: Noktalar iç içe geçmiş değerler olarak yorumlanır. Örneğin, dataLayer.push({"a.b.c": "value"}) iç içe yerleştirilmiş üç seviye olarak yorumlanır: {a: {b: {c: "value"}}}.

JavaScript değişkeni

Değer, belirttiğiniz genel JavaScript değişkeni olarak ayarlanır. Gereken değer, veri katmanında ayarlanmamışsa (bkz. Veri Katmanı değişkeni) ve DOM'da görünmüyorsa (ayrıca bkz: DOM Öğesi değişkeni), değeri bir JavaScript değişkeninden elde etmek mümkün olabilir. Değeri sayfanın kaynak kodunda bir JavaScript değişkeni olarak bulabiliyorsanız bu değişken türünü kullanın.

Sayfa öğeleri

Otomatik Etkinlik değişkeni

Bir etkinliği tetikleyen öğeyle ilgili bilgileri yakalar (ör. tıklamalar, form gönderimleri, öğe görünürlüğü vb.).

• Öğe: Öğe nesnesini döndürür. Özel JavaScript için (ör. {{Element}}.title veya CSS seçicilerde {{Element}} matches CSS Selector div.foo) bir nesne gibi ele alınabilir.
• Öğe Türü:element.tagName değerini döndürür (ör. "A", "BUTTON", "IMG").
• Öğe Özelliği: Bir özellik adı belirtildiğinde bu seçenek söz konusu özelliğin değerini döndürür.
• Öğe Sınıfları: Öğenin class özelliğinde bulunan sınıfların listesini döndürür.
• Öğe Kimliği: id özelliğinin değerini döndürür.
• Öğe Hedefi: target özelliğinin değerini döndürür (ör. "_blank").
• Öğe Metni: Öğenin metin içeriğinin değerini döndürür.
• Öğe URL'si: Öğenin URL'sini döndürür. Bu değer href veya action özelliğinden toplanır.
• Geçmiş Yeni URL Parçası: Tarayıcı geçmişinden yeni URL parçasını döndürür (ör. "#summary").
• Geçmiş Eski URL Parçası: Tarayıcı geçmişinden eski URL parçasını döndürür (ör. "#intro").
• Geçmiş Yeni Durum: Sitenin pushState'e yaptığı çağrılarla kontrol edilen yeni geçmiş durum nesnesi.
• Geçmiş Eski Durum: Sitenin pushState'e yaptığı çağrılarla kontrol edilen eski geçmiş durum nesnesi.
• Geçmiş Değişiklik Kaynağı: Geçmiş değişikliğine neden olan etkinliği döndürür (ör. "pushState", "replaceState" vb.).

DOM Öğesi

Değer, DOM (Belge Nesne Modeli) öğesinin metni veya belirtilen DOM öğesi özelliğinin değeri olarak belirlenir. İstenen değer veri katmanında ayarlanmamışsa (bkz. Veri Katmanı değişkeni) değerin DOM'dan alınması mümkündür. Değeri DOM'da bulabiliyorsanız bu değişken türünü kullanın.

İsteğe bağlı özellik adı ayarlanmışsa, değişkenin değeri o özellikte belirtilen değeri döndürür (ör. data-food="cupcake"). Aksi durumda, değer, DOM öğesindeki metin olur.

Öğe Görünürlüğü

Değer, belirtilen DOM öğesinin görünürlük durumuna göre ayarlanır. Öğe Görünürlüğü tetikleyicisinin aksine, tek bir Öğe Görünürlüğü değişkeni yalnızca tek bir öğenin görünürlüğünü bildirebilir. Öğelerin öğe kimliğine mi yoksa bir CSS Seçici'ye bağlı olarak mı seçileceğini belirleyin. Belirtilen CSS Seçici birden çok öğeyi eşleştirirse eşleşen ilk öğe kullanılır.

Şu değişkenleri çıkış türü olarak seçebilirsiniz:

• Doğru / Yanlış: Değişkene başvurulduğunda seçili öğenin görünür olup olmayacağını belirten boole değeridir. 
• Yüzde: Değişkene başvurulduğunda, seçili öğenin ne kadarının ekranda görüneceğini belirten, 0 ile 100 arasında bir yüzde değeridir.

Çıkış türünü Doğru / Yanlış olarak seçerseniz, değişkenin "true" (doğru) döndürmesi için seçili öğenin ne kadarının ekranda görünmesi gerektiğini belirten bir Minimum Görünürlük Yüzdesi de belirtebilirsiniz.

Yardımcı Programlar

Sabit

Değer, sağladığınız dize olarak ayarlanır. Sabit dize değişkenleri, aynı hesap numarasından yararlanan birden çok etiket olduğu durumlarda yaygın olarak kullanılır. Ayrıca bkz.: Google Analytics Ayarları.

Özel Etkinlik

Değer, veri katmanına aktarılan özel etkinliğin adı olarak ayarlanır.

Ortam Adı

Önizleme modunda görüntülenen ortamın adını döndürür.

Google Analytics Ayarları

Google Analytics Ayarları değişkeni, birden çok etikette kullanılan ortak Google Analytics ayarlarını merkezi olarak yapılandırmak ve paylaşmak için web ve mobil (Firebase) kapsayıcılarındaki Universal Analytics etiketlerinde kullanılır. Universal Analytics'i kullanarak bir Google Analytics etiketi oluşturduğunuzda, Etiket Yöneticisi bir Google Analytics Ayarları değişkeni seçmenizi veya oluşturmanızı ister. Daha fazla bilgi

Google Etiketi: Yapılandırma Ayarları

Bu değişken, Google etiketi yüklendiğinde yapılandırma düzeyinde parametreler ayarlamanıza olanak tanır.

Örneğin, web sitenizi birden fazla dilde yayınladığınızı ve kitlenizi okudukları dile göre segmentlere ayırmak istediğinizi varsayalım. language parametresiyle bir yapılandırma değişkeni oluşturabilir ve her etiketi manuel olarak güncellemek yerine, oluşturduğunuz bu yapılandırma değişkenini Google etiketlerinizde kullanabilirsiniz.

Yapılandırma ayarlarını nasıl yeniden kullanacağınızı öğrenin

Google Etiketi: Etkinlik Ayarları

Bu değişken, GA4 etkinliğiyle ek veriler göndermek için etkinlik düzeyinde parametreler ayarlamanıza olanak tanır.

Online mağazanız olduğunu ve indirim yaptığınızı varsayalım. Kullanıcılara verdiğiniz indirim kodlarını kaç kişinin kullandığını izlemek istiyorsunuz. Her etikete manuel olarak discount parametresi eklemek yerine Google Etiketi: Etkinlik Ayarları değişkeniyle aynı parametreyi yeniden kullanabilirsiniz.

Yapılandırma ayarlarını nasıl yeniden kullanacağınızı öğrenin

Arama Tablosu

Değer, arama tablosundaki talimatlara göre ayarlanır. Arama tablosunda iki sütun bulunur. (Daha sonra verilerin nasıl kullanıldığını göstermek için tablo boştur):

[belirli değişken] şuna eşitse	[bu değişken] değerini şu yap

Arama Tablosu, değeri başka bir değişkenin değerine göre farklılık gösteren bir değişken oluşturmanızı sağlar. Web sitesi uygun değerin (ör. dönüşüm kimliği) URL'ye, DOM öğesine veya sayfanın başka bir kısmına eşlenebileceği şekilde ayarlanmışsa bunu kullanmak yararlı olacaktır. Bu örnekte, Dönüşüm Kimliği adlı bir değişken oluşturulmaktadır. URL “/thanks/buy1.html” içeriyorsa değer “12345”; URL “thanks/buy2.html” içeriyorsa değer 34567” olarak ayarlanır.

{{Url}} şunu içeriyorsa	{{Dönüşüm Kimliği}} değerini şu yap
/thanks/buy1.html	12345
/thanks/buy2.html	34567
/thanks/buy3.html	56789

Rastgele sayı

Değer, 0 ile 2147483647 arasında rastgele bir sayı olarak ayarlanır.

RegEx Tablosu

Bir RegEx Tablosu değişkeni, Arama Tablosu değişkenine benzer. Buna ek olarak, eşleştirmek istediğiniz öğeler için normal ifade kalıplarını da çalıştırabilir.

Bu RegEx Tablosu yapılandırması için:

Kalıp	Çıkış
.*/page[1-3]\.html.*	foo
.*/page[4-6]\.html.*	bar
.*/page[7-9]\.html.*	baz

Değişkenin çıkış değeri aşağıdaki gibi olacaktır:

Eşleşen sonuç	Değer
http://example.com/page1.html	foo
http://www.example.com/page1.html	foo
http://example.com/page2.html#detail	foo
http://example.com/page5.html	bar
http://example.com/page5.html?status=new	bar
http://example.com/page6.html	bar
https://example.com/page9.html	baz

RegEx Tablosu aramaları, listenin en üstünden aşağıya doğru yapılır. Bir eşleşme bulunduğunda, ilgili çıkış değeri döndürülür.

Eşleşme bulunamadığında bir çıkış değeri ayarlamak için Varsayılan Değeri Ayarla'yı seçin.

Varsayılan olarak, kalıplar tam giriş dizesiyle eşleşmelidir ve büyük/küçük harfe duyarlı değildir. Bu davranış Gelişmiş Ayarlar'dan değiştirilebilir.

• Büyük-Küçük Harf Kullanımını Yoksay: Kalıplar, normal ifadede açıkça belirtmeye gerek kalmadan büyük ve küçük harfli varyasyonlarıyla eşleşecektir.

• Yalnızca Tam Eşleşmeler: Bu ayar etkinleştirilirse kalıpların tüm girişle eşleşmesi gerekir. Dolaylı olarak kalıbınızın başında (^) ve sonunda($) gizli çapa işaretlerinin bulunmasıyla aynı etkiye sahiptir. Devre dışı bırakılırsa, kalıplar, girişin herhangi bir yerinde bulunduğunda eşleşir.

• Yakalama Grupları ve Değiştir İşlevi: Etkinleştirildiğinde, giriş bölümlerini (ör. eşleştirilen kalıptaki yakalama gruplarından) çıkışa eklemek için dolar işareti değiştirme söz dizimini kullanabilirsiniz. Örneğin, eşleştirilen normal ifade /(news)/page(2)\.html olduğunda, birinci yakalama grubuna ("news") atıfta bulunmak için $1 ve ikinci yakalama grubuna ("2") atıfta bulunmak için $2 kullanabilirsiniz.

"Yalnızca Tam Eşleşmeler" devre dışıyken "Yakalama Grupları ve Değiştir İşlevi"ni kullanmak, beklenmedik davranışla (ör. eşleştirilen bölüm değiştirilerek tüm giriş değerinin döndürülmesiyle) sonuçlanabilir.

Kullanıcı tarafından sağlanan veriler

E-posta, telefon, ad ve adres gibi iletişim formu bilgilerini toplar. Aşağıdaki modlardan birini kullanarak yakalanacak bilgileri belirtin:

• Otomatik yapılandırma: Web sitenizdeki form alanlarını ve yeni girişleri otomatik olarak algılar.
• Manuel yapılandırma: Mevcut Etiket Yöneticisi değişkenlerini, kullanıcı tarafından sağlanan e-posta, telefon numarası, ad ve adres gibi veri alanlarıyla eşleştirmenize olanak tanır.
• Kod: Kullanıcı tarafından sağlanan yapılandırılmış veri nesnenizi döndüren bir Veri Katmanı Değişkeni veya Özel JavaScript Değişkeni belirtmenize olanak tanır.

Kapsayıcı Verileri

Kapsayıcı Kimliği

Etiket Yöneticisi kapsayıcısının kimliğini döndürür (ör. "GTM-101010").

Kapsayıcı Sürümü Numarası

Kapsayıcı önizleme modundayken, kapsayıcı sürümü değişkeni kapsayıcının önizleme sürümü numarasını döndürür. Aksi durumda, bu değişken kapsayıcının yayındaki sürümünün numarasını döndürür.

Hata Ayıklama Modu

Kapsayıcı önizleme ve hata ayıklama modundaysa değertrue (doğru) olarak, değilse false (yanlış) olarak ayarlanır.