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

Google etiketi, Google Analytics 4, Google Ads ve Google Marketing Platform dahil olmak üzere çeşitli Google ürünlerinde kullanıcı etkinliğini ölçmek için bir 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 etiketinin İçerik Yönetim Sisteminize (İYS) veya web sitesi tasarım aracınıza nasıl entegre edileceği açıklanmaktadır.

Kitle

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

Başlamadan önce

Google etiketi Geliştirici Kimliğiniz 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.

Not: Geliştirici kimlikleri yalnızca alakasız şirketler veya tüzel kişiler tarafından birden fazla web sitesinde kullanılacak bir uygulama oluştururken gereklidir. Uygulama tek bir site veya varlık tarafından kullanılacaksa lütfen geliştirici kimliği için başvurmayın.

Genel Bakış

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

1. Google etiketiyle entegrasyon oluşturma
2. Kullanıcı girişi yapınızı güncelleme
3. Consent API'yi uygulama
4. Etkinlik verilerini ayarlama
5. Güncellenen entegrasyonunuzu doğrulama
6. Kullanıcı dağıtım talimatlarınızı güncelleme

Google etiketiyle entegrasyon oluşturma

Müşterileriniz, Google etiketiyle entegrasyon oluşturarak sitelerinin her sayfasına Google ölçüm ürünlerini (gtag.js aracılığıyla) dağıtabilir. gtag.js ile entegrasyon oluşturmadan önce mevcut 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 kimliğini kullanabildiğ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('js', new Date());
  gtag('set', 'developer_id.<developer ID>', true); // Replace with your Google tag Developer ID

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

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

• Reklamverenler, allow_ad_personalization_signals parametresini kullanarak yeniden pazarlama gibi reklam kişiselleştirme özelliklerini devre dışı bırakabilir (Kişiselleştirilmiş reklamcılık verilerinin toplanmasını devre dışı bırakma başlıklı makaleyi inceleyin).
• İdeal olarak, Google etiketi snippet'i sayfa başına yalnızca bir kez görünmelidir. Snippet, birden çok etiket kimliğini barındırabilir. Mevcut bir gtag.js örneği varsa mevcut etikete yeni etiket kimlikleri 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 Google etiketi kimliklerinin birden fazla biçimini tek bir arayüzden sağlayabilmelidir.

Örneğin, aşağıdaki basit bir Google etiketi girişini göstermektedir. 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ıklandırılabilir.

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

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

Consent API'yi (diğer adıyla izin modu) uygulama

Google etiketinde, kullanıcı rızasını yönetmek için kullanılan yerleşik bir Consent API'ye sahiptir. Reklam amaçlı çerezlere yönelik kullanıcı rızasını, analiz amaçlı çerezlerden ayırt edebilir.

Beklenen sonuç, müşterilerin en azından gtag('consent', 'update' {...}) çağrısını, müşterinin herhangi bir işlem yapması gerekmeden entegre etmesidir. Bu sayede Google etiketleri (Google Ads, Floodlight, Google Analytics, Dönüşüm Bağlayıcı), en son kullanıcı izni durumunu okuyabilir ve durumu Google'a gönderilen ağ isteklerine (&gcs parametresi aracılığıyla) dahil edebilir.

Ek uygulama adımları arasında, gtag('consent', default' {...}) durumunu dağıtmak veya reklamverenlerin gtag('consent', default' {...}) durumunu (ör. kullanıcı arayüzü aracılığıyla) dağıtmasına yardımcı olmak ve izin modunun etiketleri izin bilinciyle tetiklemesini sağlamak için Google etiketlerinin engellemesini kaldırmak (yani izine dayalı koşullu tetikleme yok) yer alı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 Google Hesabı'na zengin etkinlik verileri göndermeniz gerekir. Bu işlem için müşterinin herhangi bir işlem yapması gerekmez. Örneğin, etkinlikleri bir satın alma dönüşüm hunisine (ör. add_to_cart, begin_checkout, add_payment_info, add_shipping_info ve purchase), olası satış yaratma ve kaydolma işlemleridir.

Etkinlik eklemeyle ilgili en iyi uygulamalar şunlardır:

• Mümkün olan her şeyi günlüğe kaydedin
• En az 8 temel etkinlik oluşturun
• E-ticaret etkinliklerine öncelik verme

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

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
• Davranışsal etkileşimler (ör. müşterilerin, son kullanıcılarla nasıl etkileşim kurduklarını anlamalarına yardımcı olan medya etkileşimleri

Önemli etkinlik snippet'lerini yalnızca önemli etkinlik sayfalarına (ör. satın alma onayı, form gönderme onayı) eklemeniz gerekir. Yine de 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, method değeri "Google" olan bir login etkinliği göndermek için event komutunu kullanabilirsiniz:

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>) platformunuza özel ve benzersizdir. 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. bir 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 çok 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 ad, kategori ve fiyat gibi parametreler ekleyebilirsiniz.
  • Bazı parametreler, Google Analytics'te önceden oluşturulmuş boyut ve metrikleri otomatik olarak doldurur ve kullanıcıların müşterilerini daha iyi anlamasını sağlar.

Bir önemli etkinliği (ör. bir düğmeyi tıklama veya AJAX kullanan bir site için dinamik yanıt) temel alarak ö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 oluşturun

Site sahipleri için en değerli olan temel bir etkinlik grubu oluşturmanızı öneririz. En azından aşağıdaki etkinlikleri oluşturmanı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 alışveriş sepetine bir veya daha fazla ürün 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ı, en popüler kaydolma yöntemlerini (ör. Google Hesabı, e-posta adresi) hangileri olduğunu görmenizi sağlar. 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 yakalamanızı ö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

Aşağıda, etkinlik toplamayı daha ayrıntılı olarak açıklayan ek kaynaklar verilmiştir:

• Etkinlikler
• Kullanım alanına göre önerilen etkinlikler
• Google Analytics 4 mülkleri için e-ticareti ölçme

Bu şemanın olası uzantılarını görüşmek isteriz. Önerileriniz varsa lütfen bize bildirin.

Güncellenen entegrasyonunuzu doğrulayın

Değişikliklerinizi üretime göndermeden önce aşağıdakilerle uyumluluğu doğrulayın:

• Google Analytics 4 hedefi içeren 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ğinden emin olun:

• 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 Ağ sekmesini kullanarak "google" içeren istekleri filtreleyin.
• (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 raporunu kullanın.

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

Mümkün olduğunda, 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

Google ölçüm ürünlerinin uygulamanız aracılığıyla nasıl uygulanacağıyla ilgili net talimatlar sağlamak için dokümanlarınızı güncelleyin. Geri bildirimde bulunabilmemiz için lütfen İYS Entegrasyonu Kurulum Dokümanı İncelemesi formunu doldurarak bu talimatların taslağını paylaşın.