Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Google etiketini içerik yönetim sisteminize veya web sitesi tasarım aracınıza entegre edin.

Google etiketi, Google Analytics, Google Ads ve Google Marketing Platform dahil olmak üzere çeşitli Google ürünlerindeki kullanıcı etkinliğini ölçmek için web sitesine eklenebilen bir kod snippet'idir. Google etiketi hakkında daha fazla bilgi edinin.

Bu kılavuzda, son kullanıcılarınıza Google'ın ölçüm ürünlerine erişim sağlamak için Google etiketini içerik yönetim sisteminize (İYS) veya web sitesi tasarım aracınıza nasıl entegre edeceğiniz açıklanmaktadır.

Kitle

Bu kılavuz, kullanıcılarına Google ölçüm ürünleriyle entegrasyon sağlamak isteyen içerik yönetim sistemi (İYS) sahipleri veya web sitesi tasarım araçları için hazırlanmıştır. Bu kılavuz, İYS veya web sitesi tasarım aracı kullanıcıları için hazırlanmamıştır.

Başlamadan önce

Google etiketi geliştirici kimliğinizin olduğundan emin olun. Google etiketi Geliştirici Kimliğiniz yoksa Google etiketi Geliştirici Kimliği istek formunu doldurun. Geliştirici kimliğiniz, son kullanıcılarınızın web sitesi ölçüm kodlarına eklediği Ölçüm Kimliği veya Dönüşüm Kimliği gibi diğer kimliklerden farklıdır.

Genel Bakış

Platformunuzu Google ürünleriyle entegre etmek için aşağıdaki adımları uygulayın:

Google etiketiyle entegrasyon oluşturma
Kullanıcı girişi yapınızı güncelleme
İzin API'sini uygulama
Etkinlik verilerini ayarlama
Güncellenen entegrasyonunuzu doğrulama
Kullanıcı dağıtımı talimatlarınızı güncelleme

Google etiketiyle entegrasyon oluşturma

Google etiketiyle entegrasyon oluşturarak müşterilerinizin Google ölçüm ürünlerini (gtag.js aracılığıyla) sitelerinin her sayfasına dağıtmasına olanak tanıyabilirsiniz. gtag.js ile entegrasyon oluşturmadan önce mevcut tüm eski etiket entegrasyonlarını (ör. analytics.js) kaldırdığınızdan emin olun.

Google etiketiyle entegrasyon oluşturmak için mevcut kod snippet'inizi aşağıdaki snippet ile değiştirin. Kullanıcıların TAG_ID yerine kendi etiket kimliklerini girebildiğinden emin olun.

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GOOGLE_TAG_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('set', 'developer_id.<developer ID>', true); // Replace with your Google tag Developer ID
  gtag('js', new Date());

  gtag('config', 'GOOGLE_TAG_ID');
</script>

Aşağıdakileri göz önünde bulundurun:

Reklamverenler, allow_ad_personalization_signals parametresiyle yeniden pazarlama gibi reklam kişiselleştirme özelliklerini devre dışı bırakabilir (bkz. Kişiselleştirilmiş reklamcılık verilerinin toplanmasını devre dışı bırakma).
İdeal olarak, Google etiketi snippet'i sayfa başına yalnızca bir kez görünmelidir. Snippet birden fazla etiket kimliğini destekleyebilir. gtag.js'nin mevcut bir örneği varsa yeni etiket kimliklerini mevcut etikete eklemeniz gerekir. Daha fazla bilgi

Kullanıcı girişi yapınızı güncelleme

Müşterileriniz, dağıttıkları Google ölçüm ürününden bağımsız olarak tek bir arayüz üzerinden Google etiketi kimliklerinin birden fazla biçimini sağlayabilmelidir.

Örneğin, aşağıda basit bir Google etiketi girişi gösterilmektedir. Entegrasyon, Google etiketi için bir dağıtım olarak çerçevelenmelidir. Bu, Google Ads ve Google Analytics'i dağıtma yöntemi olarak alt başlıklara ayrılabilir.

Google etiketi kimliği giriş kutusu

Alternatif olarak, aşağıdaki diyagramda bir platformun Analytics ve Ads için ayrı kullanıcı işlemleri akışları olabileceği ancak her akışın, kullanıcıların Google etiketi kimliklerini sağladığı tek bir arayüze yönlendirdiği gösterilmektedir.

Analizler ve Reklamlar tek bir giriş akışına yönlendiriyor

Etiket kimliği girişi, normal ifade kalıbı [A-Z]{1,3}\\w{5,}[\w]* kullanılarak birden fazla kimlik varyantını kabul etmelidir.

Google etiketinde, kullanıcı iznini yönetmek için yerleşik bir izin API'si bulunur. Reklam amaçlı çerezler için kullanıcı izni ile analiz amaçlı çerezler için kullanıcı izni arasında ayrım yapabilir.

Beklenen sonuç, müşterilerin en az gtag('consent', 'update' {...}) görüşme hakkı elde etmesi ve müşterinin herhangi bir işlem yapmasının gerekmemesidir. Bu, Google etiketlerinin (Google Ads, Floodlight, Google Analytics, Dönüşüm Bağlayıcı) en son kullanıcı izni durumunu okuyabilmesini ve durumu Google'a yönelik ağ isteklerine (&gcs parametresi aracılığıyla) ekleyebilmesini sağlar.

Ek uygulama adımları, gtag('consent', default' {...}) durumunu dağıtmak veya reklamverenlerin dağıtmasına yardımcı olmak (ör. kullanıcı arayüzü aracılığıyla) ve Google etiketlerinin engellemesini kaldırmaktır (yani izne dayalı koşullu etkinleştirme yoktur). Böylece izin modunun, etiketleri izin alınmış şekilde etkinleştirmesi sağlanır.

Uygulama ayrıntıları için İzin ayarlarını yönetme (web) başlıklı makaleyi inceleyin.

Etkinlik verilerini ayarlama

Müşterinin web sitesinden zengin etkinlik verilerini, müşterinin herhangi bir işlem yapmasına gerek kalmadan Google Hesabı'na göndermelisiniz. Örneğin, bir satın alma dönüşümü hunisi boyunca etkinlikler ekleyebilirsiniz (ör. add_to_cart, begin_checkout, add_payment_info, add_shipping_info ve purchase), potansiyel müşteri kazanma ve kayıtlar.

Etkinlik eklemeyle ilgili en iyi uygulamalar şunlardır:

Mümkün olan her şeyi günlüğe kaydetme
En az 8 temel etkinlik ayarlayın
E-ticaret etkinliklerine öncelik verme

Mümkün olan her şeyi günlüğe kaydetme

Mümkün olduğunda etkinlikleri varsayılan olarak ayarlamanız gerekir. Bunlardan bazıları:

purchase veya sign_up gibi önemli etkinlikler
add_to_cart gibi önemli etkinliklerden önceki etkinlikler
Müşterilerin son kullanıcılarıyla nasıl etkileşim kurduklarını anlamalarına yardımcı olan medya etkileşimleri gibi davranışsal etkileşimler

Önemli etkinlik snippet'lerini yalnızca önemli etkinlik sayfalarına (ör. satın alma onayı, form gönderimi onayı) eklemeniz gerekir. Google etiketini sitenin her sayfasına eklemeniz gerektiğini unutmayın.

Etkinlikler, event komutu kullanılarak gönderilir. Buna, yukarıda açıklanan genel site etiketine eklediğiniz Google etiketi geliştirici kimliği de dahildir:

gtag('event', 'my_event', {
  'developer_id.<developer ID>': true,
  // Additional event parameters
});

Örneğin, event komutunu kullanarak method değeri "Google" olan bir login etkinliği gönderebilirsiniz:

gtag('event', 'login', {
  'developer_id.<developer ID>': true,
  'method': 'Google'
});

<!-- Event snippet for sales conversion page -->
<script>
  gtag('event', 'conversion', {
      'developer_id.<developer ID>': true,
      'value': <value>,
      'currency': '<currency>',
      'transaction_id': '<transaction_id>'
  });
</script>

Aşağıdakileri göz önünde bulundurun:

Geliştirici kimliğiniz <developer ID> benzersizdir ve platformunuza özeldir. Kimliği her etkinliğe ekleyin.
Aşağıdaki parametreler isteğe bağlıdır ve atlanabilir:
- 'value', önemli etkinliğin sayısal değeridir (ör.satın alma işleminin fiyatı).
- 'currency', birden fazla para birimini kabul eden reklamverenler için yararlı olan üç harfli bir para birimi kodudur.
- 'transaction_id', işlem için benzersiz bir kimliktir (ör. sipariş kimliği); tekilleştirme amacıyla kullanılır.
Bazı parametreler isteğe bağlı olsa da her etkinlik için mümkün olduğunca fazla bilgi eklemeniz önerilir.
- Parametreler, kullanıcıların web siteniz veya uygulamanızla etkileşim kurma yöntemleri hakkında ek bilgi sağlar. Örneğin, bir kullanıcı sattığınız bir ürünü görüntülediğinde etkinliğe bu ürünü tanımlayan parametreler (ör. ad, kategori ve fiyat) ekleyebilirsiniz.
- Bazı parametreler, Google Analytics'te önceden oluşturulmuş boyutları ve metrikleri otomatik olarak doldurur ve kullanıcılara müşterilerini daha iyi anlama imkanı sunar.

Bir tıklamaya dayalı önemli bir etkinliği (ör. bir düğmeyi tıklama veya AJAX kullanan bir site için dinamik yanıt) ölçmek istiyorsanız aşağıdaki snippet'i de kullanabilirsiniz:

<!-- Event snippet for sales conversion page
    In your HTML page, add the snippet and call gtag_report_conversion
    when someone clicks on the chosen link or button. -->
<script>
  function gtag_report_conversion(url) {
  var callback = function () {
    if (typeof(url) != 'undefined') {
      window.location = url;
    }
  };
  gtag('event', 'conversion', {
    'developer_id.<developer ID>': true,
    'value': <value>,
    'currency': '<currency>',
    'transaction_id': '<transaction_id>',
    'event_callback': callback
  });
  return false;
}
</script>

En az 8 temel etkinlik ayarlayın

Site sahipleri için en değerli olan temel bir etkinlik grubu oluşturmanızı öneririz. En azından aşağıdaki etkinlikleri ayarlamanızı öneririz:

view_item_list: Kullanıcı bir öğe listesini (ör. ürün listesi) görüntülediğinde Daha fazla bilgi

gtag('event', 'view_item_list', {
  item_list_id: "related_products",
  item_list_name: "Related products",
  items: [{
    item_id: "SKU_123",
    item_name: "Test Item",
    currency: "USD",
    discount: 2.22,
    price: 99.9,
    quantity: 1
  }]
});

add_to_cart: Kullanıcı bir veya daha fazla ürünü alışveriş sepetine eklediğinde Daha fazla bilgi

gtag('event', 'add_to_cart', {
  value: 99.0,
  currency: "USD",
  items: [{
    item_id: "SKU_123",
    item_name: "Test Product",
    price: 99.0,
    currency: 'USD',
    quantity: 1,
    item_category: "All Products"
  }]
});

begin_checkout: Kullanıcı bir veya daha fazla ürün için ödeme sürecini başlattığında. Daha fazla bilgi

gtag('event', 'begin_checkout') {
  value: 99.0,
  currency: "USD",
  items: [{
    item_id: "SKU_123",
    item_name: "Test Product",
    price: 99.0,
    currency: 'USD',
    quantity: 1,
    item_category: "All Products"
  }]
});

purchase: Kullanıcı bir veya daha fazla ürün ya da hizmet satın aldığında Daha fazla bilgi
```
gtag('event', 'purchase', {value: XX, currency: 'USD', items: [{xx},{xx}]});
```
sign_up: Kullanıcı kaydolduğunda, son kullanıcının en popüler kaydolma yöntemlerini (ör. Google Hesabı, e-posta adresi) görebilmesi için. Daha fazla bilgi
```
gtag('event', 'sign_up', {method: 'web'});
```

generate_lead: Kullanıcı bir form gönderdiğinde Daha fazla bilgi

gtag('event', 'generate_lead', {value: XX, currency: 'USD'});

subscribe: Kullanıcı bir hizmete veya bültene abone olduğunda

gtag('event', 'subscribe', {value: XX, currency: 'USD', coupon: 'XX'});

book_appointment: Kullanıcı randevu aldığında

gtag('event', 'book_appointment', {value: XX, currency: 'USD', coupon: 'XX'});

Ek öneriler

Google, özellikle e-ticaret için çok daha fazla etkinlik ve parametreyi destekler. Genel olarak, aşağıdakileri kaydetmenizi öneririz:

Değerle doğrudan ilişkili tüm başarı etkinlikleri
Temel önemli etkinliklere (add_to_cart, sign_up vb.) katkıda bulunan başarı etkinlikleri
Reklamverenlerin son kullanıcılarıyla nasıl etkileşim kurduğunu anlamalarına yardımcı olan etkileşimler ve kullanıcı etkileşimleri

Aşağıda, etkinlik toplama hakkında daha fazla bilgi veren ek kaynaklar yer almaktadır:

Etkinlikler
Kullanım alanına göre önerilen etkinlikler
Google Analytics mülkleri için e-ticaret ölçümü yapma

Bu şemada yapılabilecek olası genişletmeler hakkında görüşmek istiyoruz. Bu nedenle, önerileriniz varsa lütfen bize bildirin.

Güncellenen entegrasyonunuzu doğrulama

Değişikliklerinizi üretime aktarmadan önce aşağıdakilerle uyumluluğunu doğrulayın:

Google Analytics hedefi olan Google etiketiniz
Yeniden pazarlama ve dönüşüm ölçümü için Google etiketiniz

Ayrıca, aşağıdaki araçlardan herhangi birini kullanarak etiketin önemli etkinlik sayfaları da dahil olmak üzere tüm sayfalarda düzgün şekilde tetiklendiğini doğrulayın:

Google Tag Assistant: Tag Assistant, hangi Google etiketlerinin hangi sırayla tetiklendiğini görmenizi sağlar. Tag Assistant hata ayıklama modu, veri katmanına hangi verilerin aktarıldığını ve bu veri alışverişlerini hangi etkinliklerin tetiklediğini gösterir.
Chrome geliştirici araçları: Verilerin nasıl gönderildiğini doğrulamak için "google" içeren istekleri filtrelemek üzere Ağ sekmesini kullanın.
(Sunucu tarafı) Google Analytics anlık raporu: Ücretsiz bir Google Analytics hesabı oluşturun ve etiket isabetlerinin Google'ın sunucuları tarafından alınıp alınmadığını görmek için Anlık raporu kullanın.

Bir hatayı bildirmek veya eksik bilgilerle ilgili geri bildirimde bulunmak için İçerik Yönetim Sistemi Destek formunu doldurun.

Mümkünse devam eden doğrulama için lütfen test erişimini Google ile paylaşın.

Kullanıcı dağıtımı talimatlarınızı güncelleme

Uygulamanızı kullanarak Google ölçüm ürünlerinin nasıl uygulanacağı konusunda net talimatlar vermek için dokümanlarınızı güncelleyin. Geri bildirimde bulunabilmemiz için CMS Entegrasyonu Kurulumu Dokümanı inceleme formunu doldurarak bu talimatların bir taslağını paylaşın.