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

Bu sayfa, gtag.js kullanarak Google etiketini yapılandırması gereken geliştiriciler içindir. Ayarları kullanıcı arayüzünde düzenlemek için Google etiketi ayarlarınızı yapılandırma başlıklı makaleyi inceleyin.

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

Bu sayfada aşağıdakilerin nasıl yapılacağı açıklanmaktadır:

1. event komutunu kullanarak Google ürünlerinize etkinlik gönderme
2. set komutunu kullanarak her etkinlikle birlikte gönderilen değerleri ayarlama

Başlamadan önce

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

• Google etiketinin işleyiş şekli hakkında bilgi sahibi olmanız gerekir.
• Google etiketini yüklediyseniz

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

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

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

Google ürünlerine veri akışı oluşturmak için config komutunu kullanın.

config komutu hakkında

config komutu, etkinlik verilerini göndermek istediğiniz Google ürünlerini belirtir. Komutun biçimi aşağıdaki gibidir:

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

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

Veri toplama ayarlarını belirleme

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

Örnek

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

Aşağıdaki örnekte, kodunuzu bir Floodlight hedefine bağlı ikinci bir Google etiketini 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 parametresinde 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 sayfa görüntüleme etkinliği başlatmasını söyler.

config komutunun her bir ürünle ilgili olarak nasıl davrandığı hakkında daha fazla bilgi edinmek için ürüne özel dokümanları okuyun:

• Google Ads reklam dönüşümleri ve yeniden pazarlama
• Campaign Manager ve Display & Video 360
• Search Ads 360
• Google Analytics

event ile veri gönderme (2. adım)

Google ürünleriyle bağlantıları yapılandırdıktan sonra veri göndermek için event komutunu kullanmanız gerekir.

event komutu hakkında

event komutu, etkinlik verilerini config ile belirttiğiniz ürünlere göndermenize olanak tanır. Komutun biçimi aşağıdaki gibidir:

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

Etkinlik oluşturma

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

1. 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ükleme ile mi yoksa bir kullanıcı bir düğmeyi tıkladığında mı gönderileceğini belirleyin.

Örnek

Aşağıdaki örnekte, bir kullanıcı bir düğmeyi tıkladığında bülten kayıtlarını ölçmenin olası bir yolu gösterilmektedir. Örnekte özel bir etkinlik kullanılıyor ve bu etkinlik bir Google Analytics mülküne gönderiliyor.

<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" onclick="newsletterSignup()">Sign me up!</button>
   ...
</body>

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

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

Örneğin, kampanya parametrelerini aynı sayfadaki birden fazla etiket tarafından erişilebilecek şekilde paylaşabilirsiniz.

Komutun biçimi aşağıdaki gibidir:

gtag('set', 'parameterName');

3. adım: Kurulumunuzu doğrulayın

Etkinlik verilerinizin doğru şekilde gönderildiğinden emin olmak için:

1. Verileri görmek istediğiniz Google ürününü açın.
2. Verilerin gelip gelmediğini kontrol etme Her ürünün, verilerin alınıp alınmadığını kontrol edebileceğiniz farklı bir yeri vardır:
   • Google Analytics: Gerçek zamanlı raporu kontrol edin.
   • Google Ads: Dönüşüm işlemleri tablonuzu kontrol edin ve Durum sütununa bakın (güncellenmesi 24 saati bulabilir).
   • Floodlight: Floodlight etiketlerinin etkinleştiğini doğrulamak için Tag Assistant'ı kullanın.

Sonraki adımlar

Google ürünlerinizi ve etkinliklerinizi ayarladıktan sonra temel Google etiketi yapılandırmasını tamamlamış olursunuz.

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.