Google ürünlerini yapılandırma ve etkinlik verilerini gönderme

Bu sayfa, Google etiketini gtag.js kullanarak yapılandırması gereken geliştiriciler içindir. Google etiketi, kullanıcı arayüzündeki bazı ayarları da ayarlamanıza olanak tanır. Google etiketi ayarlarınızı yapılandırma bölümüne bakın.

Google etiketini yükledikten sonra, Google etiketi snippet'inden sonra kodunuzun herhangi bir yerinde gtag() komutlarını çağırabilirsiniz.

Bu sayfada aşağıdakiler gösterilmektedir:

  1. config komutunu kullanarak web siteniz ile Google ürünleri arasında veri akışı oluşturma
  2. event komutunu kullanarak Google ürünlerinize etkinlik gönderin
  3. set komutunu kullanarak her etkinlikle birlikte gönderilen değerleri ayarlama

Başlamadan önce

Bu rehberde, aşağıdakileri yaptığınız varsayılmaktadır:

Veri akışını ayarlamak için:

  • Google etiketini yüklediğiniz web sitesi koduna erişme
  • Google etiketine bağlamak istediğiniz Google ürünü etiketinin kimliği

Etiket kimliği nedir ve nerede bulunur? Etiket kimliği, bir Google etiketini tanımlar. Bir Google etiketinin birden fazla etiket kimliği olabilir. Örneğin, Google Ads kullanıyorsanız etiketinizin artık iki kimliği vardır: Bir eski kimlik (AW) ve bir Google etiketi kimliği (GT).

Google Ads'de iki etiket kimliğine sahip bir Google etiketini gösteren ekran.

Etiket kimlikleri değiştirilebilir. Aşağıdaki tabloda, hangi etiketlerin Google etiketiyle uyumlu olduğuna dair genel bir bakış yer almaktadır.

Ön numara Kimlik türü Açıklama
GT-XXXXXX Google etiketi Yeni oluşturulan her Google etiketine bir GT öneki ve benzersiz kimlik verilir.
G-XXXXXX Google etiketi (eski ön ek) Google Analytics 4 etiketleri, G ön ekiyle ve benzersiz kimlikle başlayan Google etiketleridir.
AW-XXXXXX Google etiketi (eski ön ek) Google Ads etiketleri, AW ön ekiyle ve benzersiz kimlikle oluşturulan Google etiketleridir.
DC-XXXXXX Google etiketi (eski ön ek) Google Floodlight etiketleri, DC öneki ve benzersiz kimliğe sahip Google etiketleridir.

Universal Analytics (UA) etiketleri, Google etiketiyle (GT) uyumlu değildir.

Etiket kimliğinizi bulma:

1. adım: Google ürünlerini etiketinize bağlayın

config komutu hakkında

config komutu, etkinlik verileri göndermek istediğiniz Google ürünlerini belirtir. Komut şu biçimdedir:

gtag('config', 'TAG_ID', {<additional_config_params>});

Ek yapılandırma parametreleri

İsteğe bağlı {<additional_config_params>} nesnesinde parametreler belirterek config komutunu ayarlayabilir ve genişletebilirsiniz. Örneğin, aşağıdaki parametreyi eklemek Google Analytics sayfa görüntülemesinin otomatik olarak gönderilmesini engeller:

gtag('config', 'TAG_ID', {'send_page_view': false});

Veri toplama ayarlarını belirleme

Bir Google ürünü için veri toplamayı ayarlamak üzere config komutunu bir etiket kimliğiyle ekleyin.

Örnek

Google etiketi (GT-XXXXXX), kendisi için tanımladığınız hedeflere (ör. Google Ads ve GA4) veri gönderir.

Aşağıdaki örnekte, kodunuzu bir Floodlight hedefine bağlı ikinci bir Google etiketi yükleyecek şekilde nasıl güncelleyeceğiniz gösterilmektedir.

Floodlight'a (etiket kimliği DC-ZZZZZZ) veri göndermek için ilk Google etiketini (etiket kimliği GT-XXXXXX) başlattıktan sonra başka bir config komutu ekleyin:

<head>
 ...
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments)};
  gtag('js', new Date());
  gtag('config', 'GT-XXXXXX');
  gtag('config', 'DC-ZZZZZZ');
</script>
</head>

Ürüne özgü config davranışı

TAG_ID içinde belirtilen ürüne bağlı olarak config komutu, söz konusu ürün için belirli davranışları da başlatabilir. Örneğin, bazı durumlarda config komutu gtag.js'ye bir pageview etkinliği başlatmasını söyler.

config komutunun her bir ürüne göre nasıl davrandığı hakkında daha fazla bilgi edinmek için ürüne özel belgeleri okuyun:

2. adım: event ile veri gönderin

event komutu hakkında

event komutu, config ile belirttiğiniz ürünlere etkinlik verileri göndermenize olanak tanır. Komut şu biçimdedir:

gtag('event', 'event_name', {
  'key': 'value',
});

Etkinlik adları ve anahtar/değer çiftleri hakkında

Önerilen etkinlikler: Önerilen etkinlikler, sizin uyguladığınız ancak önceden tanımlanmış anahtar/değer çiftlerine sahip olan etkinliklerdir. Bu etkinlikler, mevcut ve gelecekteki raporlama özelliklerinden yararlanmanıza olanak tanır.

Özel etkinlikler: Kendi etkinliklerinizi ve veri yapılarınızı tanımlamak için özel değerler girerek özel etkinlik gönderebilirsiniz.

Etkinlik oluşturma

Google etiketini başlattıktan sonra event yöntemini kodunuzun herhangi bir yerinde çağırabilirsiniz.

  1. Bir etkinlik tanımlayın. Önerilen bir etkinlik kullanıyorsanız standartlaştırılmış etkinlik adlarını ve önceden tanımlanmış anahtar/değer çiftlerini kullandığınızdan emin olun.

  2. Etkinliğin ne zaman tetikleneceğini tanımlayın (örneğin, sayfa yüklenirken mi yoksa bir düğme tıklandığında mı gönderilir?).

Örnek

Aşağıdaki örnekte, bir kullanıcı bir düğmeyi tıkladığında bültene kaydolma işlemlerini ölçmenin bir olası yolu gösterilmektedir. Örnekte, özel bir etkinlik kullanılmakta ve bu etkinlik bir Google Analytics 4 mülküne gönderilmektedir.

<head>
   ...
   /* 1. Initialize the Google tag and gtag.js library */
   <!-- Google tag (gtag.js) -->
   <script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
   <script>
     window.dataLayer = window.dataLayer || [];
     function gtag(){dataLayer.push(arguments)};
     gtag('js', new Date());
     gtag('config', 'TAG_ID');
   </script>
</head>

<body>
   <script>
     let date = Date.now();
     /* 2. Define your event. */
     function newsletterSignup() {
       gtag('event', 'newsletter_signup', {
       'time': date,
       });
   }
   </script>
   ...
   /* 3. Trigger your event */
   <button type="submit" onlick="newsletterSignup()">Sign me up!</button>
   ...
</body>

İsteğe bağlı: set kullanarak her etkinlikle birlikte veri gönderin

set komutu, sayfada sonraki her etkinlikle ilişkilendirilecek parametreleri tanımlamanıza olanak tanır.

Örneğin, aynı sayfadaki birden fazla etiket tarafından erişilebilmesi için campaign parametrelerini paylaşabilirsiniz.

Komut aşağıdaki biçimdedir:

gtag('set', 'parameterName');

Sonraki adımlar

Google ürünlerinizi ve etkinliklerinizi ayarladıktan sonra temel Google etiketi yapılandırması tamamlanır.

Birden fazla ürün yönetiyorsanız ve bu ürünlerin veri akışını daha ayrıntılı bir şekilde yönetmek istiyorsanız Verileri gruplandırma ve yönlendirme başlıklı makaleyi inceleyin.