Global site etiketinin (gtag.js) adı Google etiketi olarak değişti. Daha fazla bilgi

Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

Google etiketi (gtag.js); Google Analytics 4, Google Ads ve Google Marketing Platform dahil ç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

Bu kılavuzda, son kullanıcılarınızın Google'ın ölçüm ürünlerine erişmesini sağlamak için Google etiketini İçerik Yönetim Sisteminize (İYS) veya web sitesi tasarım aracına 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 İçerik Yönetim Sistemi (İYS) 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.

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
Consent API'yi 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 sayesinde müşterileriniz, sitelerinin her sayfasına Google ölçüm ürünleri (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 öğesini kendi Etiket Kimlikleriyle değiştirebildiklerinden 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, yeniden pazarlama gibi reklam kişiselleştirme özelliklerini allow_ad_personalization_signals parametresiyle devre dışı bırakabilir (Kişiselleştirilmiş reklamcılık verilerinin toplanmasını devre dışı bırakma bölümünü inceleyin).
İdeal olarak, Google etiketi snippet'i sayfa başına yalnızca bir kez görünmelidir. Snippet, birden fazla etiket kimliğini barındırabilir. gtag.js'nin mevcut bir örneği varsa mevcut etikete yeni etiket kimlikleri eklemeniz gerekir. Daha fazla bilgi

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

Müşterileriniz, kullandıkları Google ölçüm ürününden bağımsız olarak tek bir arayüzden Google etiket kimliklerinin farklı biçimlerini 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ğıtmak için bir yöntem olarak altyazıya dönüştürülebilir.

Google etiketi kimliği giriş kutusunun resmi

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

Analytics ve Google Ads'in bir giriş
akışına yol açan resmi

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

Google etiketi, kullanıcı iznini yönetmek için yerleşik bir Consent API'ye sahiptir. Reklama yönelik çerezler için kullanıcı rızasını analiz amaçlı olanlardan ayırt edebilir.

Beklenen sonuç, müşterilerin herhangi bir işlem yapmadan en azından gtag('consent', 'update' {...}) aramasını entegre etmesidir. Bu işlem, Google etiketlerinin (Google Ads, Floodlight, Google Analytics, Dönüşüm Bağlayıcı) en son kullanıcı izin durumunu okuyabilmesini ve Google'a gönderilen ağ isteklerine durumu dahil edebilmesini (&gcs parametresi aracılığıyla) sağlamalıdır.

Ek uygulama adımları, gtag('consent', default' {...}) durumunu dağıtma (ör. kullanıcı arayüzü aracılığıyla) ve Google etiketlerinin engelini kaldırma (izine dayalı koşullu etkinleşme olmaması) konusunda reklamverenlere yardımcı olmak veya izin modunun bu etiketleri izne duyarlı bir şekilde etkinleştirmesine yardımcı olmaktır.

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

Etkinlik verilerini ayarlama

Müşterinin web sitesindeki zengin etkinlik verilerini, herhangi bir işlem yapması gerekmeden müşterinin Google hesabına göndermeniz gerekir. Örneğin, etkinlikleri bir satın alma dönüşüm hunisi boyunca ekleyebilirsiniz (ör. add_to_cart, begin_checkout, add_payment_info, add_shipping_info ve purchase), olası satış yaratma ve kaydolma işlemleri.

Aşağıda, etkinlik eklemeye yönelik en iyi uygulamalar verilmiştir:

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

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

Mümkün olduğunda varsayılan olarak etkinlikler oluşturmanız gerekir. Bunlardan bazıları:

purchase veya sign_up gibi dönüşüm etkinlikleri
add_to_cart gibi dönüşüm etkinliklerinden önceki etkinlikler
Müşterilerin son kullanıcılarla nasıl etkileşim kurduğunu anlamalarına yardımcı olan medya etkileşimleri gibi davranışsal etkileşimler

Dönüşüm etkinliği snippet'lerini yalnızca dönüşüm sayfalarına (ör. satın alma onayı, form gönderme onayı) eklemelisiniz. Google etiketini yine de sitenin her sayfasına eklemeniz gerektiğini unutmayın.

Etkinlikler event komutu kullanılarak gönderilir. Bu, yukarıda açıklanan global site etiketine eklediğiniz Google etiketi Geliştirici Kimliğini içerir:

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> benzersiz ve platformunuza özgüdür. Kimliği her etkinliğe ekleyin.
Aşağıdaki parametreler isteğe bağlıdır ve atlanabilir:
- 'value', dönüşümün sayısal değeridir (ör. bir satın alma işleminin fiyatı)
- 'currency', birden fazla para birimi kabul eden reklamverenler için kullanışlı, üç harfli bir para birimi kodudur.
- 'transaction_id', işleme ait benzersiz bir kimliktir (ör.sipariş kimliği). Tekilleştirme amacıyla kullanılır.
Bazı parametreler isteğe bağlı olsa da, her bir 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 yolları 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'teki önceden oluşturulmuş boyut ve metrikleri otomatik olarak doldurur ve kullanıcılara müşterilerini daha iyi anlama olanağı sunar.

Bir dönüşüm etkinliğini tıklamaya dayalı olarak ölçmek istiyorsanız (ör. bir düğmeye yapılan tıklama veya AJAX kullanan bir site için dinamik yanıt) 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 sahiplerine en fazla değer sağlayacak temel etkinlikler grubunu oluşturmanızı öneririz. En azından aşağıdaki etkinlikleri oluşturmanızı öneririz:

view_item_list: Kullanıcının bir öğe listesini (ör. ürün listesi) görüntülemesi. 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ı, 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 işlemini 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: Son kullanıcının en popüler kayıt yöntemlerini (ör. Google hesabı, e-posta adresi). Daha fazla bilgi
```
gtag('event', 'sign_up', {method: 'web'});
```
generate_lead: Kullanıcı form gönderdiğinde. Daha fazla bilgi
```
gtag('event', 'generate_lead', {value: XX, currency: 'USD'});
```

subscribe: kullanıcının bir hizmete veya bültene abone olması

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 olmak üzere ç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 dönüşümlere katkıda bulunan başarılı etkinlikler (add_to_cart, sign_up vb.)
Reklamverenlerin son kullanıcılarıyla nasıl etkileşime geçtiğini anlamasına yardımcı olan etkileşimler ve kullanıcı etkileşimleri

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

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

Bu şemanın olası uzantılarını tartışmak istiyoruz. Bu nedenle, önerileriniz varsa lütfen bize bildirin.

Güncellenen entegrasyonunuzu doğrulayın

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

Google Analytics 4 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 dönüşüm sayfaları dahil tüm sayfalarda doğru şekilde etkinleştiğini doğrulayın:

Google Tag Assistant: Tag Assistant sayesinde hangi Google etiketlerinin hangi sırayla tetiklendiğini görebilirsiniz. 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 amacıyla, "google" içeren istekleri filtrelemek için Ağ sekmesini kullanın.
(Sunucu tarafı) Google Analytics gerçek zamanlı raporu: Ücretsiz bir Google Analytics hesabı oluşturun ve etiket isabetlerinin Google sunucuları tarafından alınıp alınmadığını görmek için gerçek zamanlı raporu kullanın.

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

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

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

Uygulamanız aracılığıyla Google ölçüm ürünlerini nasıl uygulayacağınızla ilgili net talimatlar sağlamak için belgelerinizi güncelleyin. Geri bildirim verebilmemiz için lütfen CMS Entegrasyonu Kurulum Belgeleri inceleme formunu doldurarak bu talimatların bir taslağını paylaşın.