GA4 e-ticaret (Etiket Yöneticisi): GA4 etkinliği gönderme

Bu kılavuzda, Google Analytics 4 e-ticaret etkinliklerini kullanmak için mevcut bir Universal Analytics (Etiket Yöneticisi) e-ticaret uygulamasının nasıl güncelleneceği açıklanmaktadır.

Ek taşıma kılavuzları ve kaynakları için Geliştirici taşıma merkezini ziyaret edin.

Sonuç

Bu kılavuzu uyguladığınızda, mevcut Universal Analytics uygulamanız GA4 e-ticaret etkinliklerini ve parametrelerini kullanacak şekilde güncellenir. Güncellenen e-ticaret uygulaması, e-ticaret verilerini yeni bir GA4 mülküne göndermek için de kullanılır. UA e-ticaret raporlarınız verilerle doldurulmaya devam eder ve yeni Google Analytics 4 mülkünüzde veri almaya başlarsınız.

Dikkat: Google Analytics 4 e-ticaret etkinlikleri, Universal Analytics ile uyumlu olacak şekilde otomatik olarak çevrilir. Ancak tüm Google Analytics 4 etkinliklerinin Universal Analytics'te eşdeğer bir etkinliği yoktur. Universal Analytics e-ticaret raporlarında bu etkinliklerin verileri eksik olur. Aşağıdaki Ödünleşimler ve dikkat edilmesi gereken noktalar bölümüne bakın.

Başlamadan önce

1. Aşağıdakilerin mevcut uygulamanızı açıkladığını onaylamak için e-ticaret taşıma yardımcısı aracını kullanın:

   • Universal Analytics mülkü kullanıyorsunuz
   • Siteniz Etiket Yöneticisi'ni kullanıyor ve e-ticaret etkinliklerini göndermek için veri katmanını kullanıyor.

2. Her bir seçeneğin artıları hakkında bilgi edinmek için e-ticaret uygulamaları için taşıma seçeneklerini inceleyin. Mevcut Universal Analytics uygulamanız için Google Analytics 4 e-ticaret etkinliklerini kullanmak üzere bu kılavuzdaki önerileri uygulamak istediğinizi onaylayın.

3. Bir GA4 mülküne gönderildiğinde UA etkinliklerinin nasıl çevrildiğini öğrenmek için Etkinlik uyumluluğu referansını inceleyin.

Ödünler ve dikkat edilmesi gereken noktalar

Google Analytics 4 e-ticaret etkinliklerini mevcut Universal Analytics (Etiket Yöneticisi) e-ticaret uygulamanızla kullanmanın etkilerini tam olarak anlamak için aşağıdaki bilgileri inceleyin ve değerlendirin.

Artıları	Eksileri
E-ticaret verilerini hem GA4 hem de Universal Analytics raporlarınızda görmenize olanak tanır. GA4 etkinlik ve parametrelerinin kullanılması, GA4 e-ticaret raporlarının eksiksiz olmasını sağlar.	Mevcut e-ticaret etkinliklerinizi değiştirmenizi gerektirir. Universal Analytics'te tüm GA4 etkinlik ve parametrelerinin eşdeğerleri yoktur. shipping_tier, discount, currency, location_id, promotion_name ve promotion_id parametrelerinin Universal Analytics eşdeğerleri olmadığından Universal Analytics raporlarınızda görünmez.

Uygulama

Uygulamanın temel hedeflerinden biri, veri katmanından gtag.js API'sine geçmektir. Bu geçiş sırasında ölçümde kesinti yaşanmadığından emin olmak için aşağıdaki talimatlarda, önce tüm etiket yapılandırma güncellemelerinin tamamlanması, ardından veri katmanında güncellemeler yapılması önerilir.

1. Yeni bir GA4 mülkü oluşturma ve yapılandırma

Yeni Google Analytics 4 mülkünüzü oluşturmak ve yapılandırmak için aşağıdaki adımları uygulayın:

1. Yeni bir Google Analytics 4 mülkü oluşturun.
   • Otomatik olarak yeni bir GA4 mülkü oluşturmak için GA4 Kurulum Asistanı'nı kullanın ve mülk adı, web sitesi URL'si, saat dilimi ve para birimi ayarları gibi ayarları Universal Analytics mülkünüzden kopyalayın. Ancak bağlı site etiketi özelliğini devre dışı bırakmak için Mevcut etiketlerinizi kullanarak veri toplamayı etkinleştirin seçeneğinin işaretini kaldırın. Alternatif olarak, Universal Analytics mülkünüzdeki herhangi bir ayarı kopyalamak istemiyorsanız GA4 Kurulum Asistanı olmadan bir Google Analytics 4 mülkü oluşturun.
2. Google etiketini ekleyin.
   1. Mevcut Universal Analytics uygulamanız için Google Etiket Yöneticisi kapsayıcısını açın.
   2. Etiketler > Yeni'yi tıklayın.
   3. Etiket Yapılandırması'nı tıklayın ve Google etiketi'ni seçin.
   4. Google Analytics 4 mülkünüzün etiket kimliğini girin.
   5. Tüm Sayfalar üzerinde (veya ölçmek istediğiniz sayfa alt kümesi üzerinde) etiketi tetiklemeyi seçin.
   6. Etiket yapılandırmanızı kaydedin ve yayınlayın.

2. E-ticaret etkinliklerini ölçmek için GA4 etkinliği etiketi yapılandırması ekleme

E-ticaret etkinliklerini ve parametrelerini GA4 mülkünüze göndermek amacıyla bir GA4 etkinliği etiketi eklemek için aşağıdaki adımları uygulayın:

1. Yeni bir Etiket Yapılandırması oluşturun ve GA4 Etkinliği'ni seçin.
2. Etkinlik Adı için yerleşik değişkenini kullanın. Bu durumda, gtag.js API kullanılarak gönderilen GA4 e-ticaret etkinlik adı kullanılır.
3. Diğer Ayarlar'ın ve ardından E-ticaret'in altında, E-ticaret verilerini gönder'i işaretleyin.
4. Veri Kaynağı için Veri Katmanı'nı seçin.
5. Kaydet'i tıklayın. Tetikleyiciler sonraki adımlarda eklenecektir. Böylece eksik tetikleyicilerle ilgili uyarıları güvenle yoksayabilirsiniz.

Önemli Nokta: Birden fazla GA4 etkinliği etiketi oluşturmanız gerekmez. Bunun yerine, tüm e-ticaret etkinlikleri için yerleşik Event değişkenini kullanan tek bir GA4 etkinliği etiketi kullanılabilir. Etiket tetikleyicileri, etiketi tetikleyen belirli GA4 e-ticaret etkinliklerini tanımlar.

3. UA e-ticaret etiketi yapılandırmalarınızı GA4 etkinliklerini kullanacak şekilde güncelleme

Her Universal Analytics e-ticaret etiketi yapılandırması için eşdeğer GA4 e-ticaret etkinliğinde etkinleşecek bir tetikleyici eklemeniz ve GA4 e-ticaret etkinliği verilerini okuma seçeneğini etkinleştirmeniz gerekir.

Her Universal Analytics e-ticaret etkinliği için karşılık gelen bir GA4 etkinliğine güncelleme yapmak için genel adımlar aşağıdaki gibidir:

1. Güncellemek istediğiniz UA e-ticaret etkinliğiyle ilgili olarak ilgili GA4 etkinlik adını belirlemek için UA ile GA4 etkinlikleri arasında uyumluluk ve UA ile GA4 tabloları için karşılaştırılabilir parametreler ve/veya e-ticaret taşıma yardımcısı bölümlerindeki bilgileri kullanın. Örneğin, ürün tıklamalarını ölçmek için bir etkinliği güncelliyorsanız GA4 etkinlik adı select_item olur.
2. Etkinlik için Universal Analytics Etiket Yapılandırmasını güncelleyin:
   1. Mevcut etiketlerinizin güncellenen GA4 e-ticaret etkinliğini doğru şekilde okuduğundan emin olmak için Diğer Ayarlar ve ardından E-ticaret bölümünde GA4 şemasını kullan seçeneğini işaretleyin. Bu değişikliği, veri katmanından gtag.js API'sine geçiş yapmadan önce yapmanızda bir sakınca yoktur.
   2. Tetikleyici bölümünde, Etkinlik Adı'nın yukarıda tanımlanan GA4 e-ticaret etkinliği olduğu yeni bir Özel Etkinlik tetikleyicisi ekleyin. Bu adımı tamamladıktan sonra en az 2 tetikleyicinizin olması gerekir: etiketi tetikleyen orijinal tetikleyici ve GA4 etkinliklerine geçişi tamamladığınızda sonunda tetiklenecek yeni eklenen tetikleyici. Ek tetikleyici, bu belgenin ilerleyen bölümlerinde açıklandığı gibi, veri katmanından gtag.js API'sine geçiş sırasında veri kesintisi olmamasını sağlar.
   3. Değişiklikleri kaydedin.
3. Yeni tetikleyiciyi GA4 etkinliği etiketine ekleyin:
   1. GA4 mülkünüze e-ticaret etkinlikleri ve parametreleri göndermek için daha önce yapılandırdığınız GA4 Etkinliği etiketini açın.
   2. GA4 etkinliklerine geçiş yapmanızın ardından GA4 etkinlik etiketinin, ilişkili e-ticaret etkinliği için etkinleşmesini sağlamak üzere, yukarıda oluşturulan Özel Etkinlik tetikleyicisini (ör. select_item) Tetikleme bölümüne ekleyin.
   3. Değişiklikleri kaydedin.
4. Her Universal Analytics e-ticaret etkinliği için yukarıdaki adımları tekrarlayın. İşlem tamamlandığında değişikliklerinizi Etiket Yöneticisi'nde yayınlayın.

Dikkat: Universal Analytics etiket yapılandırmanızda GA4 şemasını kullan seçeneğini etkinleştirdiğinizden emin olun. Bu seçenek etkinleştirilmezse UA e-ticaret raporlarınız doğru şekilde doldurulmaz.

4. gtag.js API'yi etkinleştirme

E-ticaret uygulamanızı UA'dan GA4'e güncellemek için veri katmanını kullanma yerine Etiket Yöneticisi ile birlikte çalışan gtag.js API'yi kullanmaya başlamanız önerilir.

gtag.js API'sini etkinleştirmek için aşağıdaki kod snippet'ini sayfanızın en üst kısmına, Etiket Yöneticisi kapsayıcı snippet'inizin üstüne ekleyin:

<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
</script>

Dikkat: Daha önce Sayfaya Veri Katmanı Değişkenleri Ekleme yöntemini uyguladıysanız ve sayfada daha önce bir veri katmanı değişkeni tanımladıysanız yukarıdaki snippet, mevcut veri katmanı bildiriminizden sonra yerleştirilmelidir.

5. Veri katmanından gtag.js kullanmaya geçiş

Tüm etiket yapılandırması güncellemelerini tamamladıktan ve gtag.js API'yi etkinleştirdikten sonra, veri katmanını kullanma yönteminden gtag.js API'yi kullanmaya hazırsınız.

Güncellemeye yardımcı olmak için aşağıdaki kaynakları kullanın:

• gtag.js API'yi kullanarak GA4 e-ticaret etkinliklerini nasıl göndereceğinizi ve Etiket Yöneticisi'nde GA4 Etkinliği etiketini ve tetikleyicilerini nasıl yapılandıracağınızı öğrenmek için E-ticaret (GA4) Geliştirici Kılavuzu.
• Bir Universal Analytics e-ticaret etkinliği için uygun GA4 etkinlik adını bulmanıza yardımcı olan UA ile GA4 etkinlikleri arasında uyumluluk tablosu. Örneğin, ürün gösterimlerini ölçmek için bir etkinliği güncelliyorsanız GA4 etkinlik adı view_item_list olur.
• UA e-ticaret parametre adlarını eşdeğer GA4 e-ticaret parametresi adlarıyla eşleştirmenize yardımcı olan UA ve GA4 için karşılaştırılabilir parametreler tablosu.
• E-ticaret etkinliklerinizi doğru şekilde güncellediğinizi doğrulamak için e-ticaret taşıma yardımcısı.

Her Universal Analytics e-ticaret etkinliği için UA E-ticaret etkinlikleri ile dataLayer.push() API'yi kullanmaktan, ilgili GA4 e-ticaret etkinliğiyle birlikte gtag.js API'yi kullanmaya geçişle ilgili genel adımlar aşağıdaki gibidir:

1. Özel etkinlik adlarını ilgili GA4 etkinlik adıyla güncelleyin. Örneğin, productClick özel etkinlik adı kullanan bir ürün tıklamasını ölçmek için bir etkinliği güncelliyorsanız GA4 için güncellenmiş etkinlik adı select_item olur. GA4 etkinlik adı, daha önce yapılandırdığınız bir tetikleyicinin etkinlik adıyla eşleşmelidir.

   Örneğin, veri katmanını kullanan aşağıdaki ürün tıklama etkinliği

   dataLayer.push({'event': 'productClick', 'ecommerce': {<ecommerce_parameters>}});
   

   gtag.js API'sine geçiş yapıldığında aşağıdaki hale gelir:

   gtag('event', 'select_item', {<ecommerce_parameters>});
   

2. E-ticaret parametrelerini, GA4 etkinliğinden beklenenlerle eşleşecek şekilde güncelleyin. Parametre adı değiştiğinden UA ve GA4 için karşılaştırılabilir parametreler kullandığınızdan emin olun. GA4 parametre değerini, eşleşen UA parametresi değeriyle doldurun.

Not: dataLayer.push() API'den gtag.js API'ye geçiş tamamlandıktan sonra, eski UA veri katmanı etkinliklerine göre tetiklenen tüm özel etkinlik tetikleyicilerini isteğe bağlı olarak kaldırabilirsiniz.

Örnek: UA etkinliğini GA4'e güncelleme

Aşağıdaki örnekte, Universal Analytics için Etiket Yöneticisi'nde uygulanan bir ürün tıklaması e-ticaret etkinliği için eşdeğer bir GA4 Etkinliğinin nasıl oluşturulacağı gösterilmektedir.

Önce: UA etkinliklerini veri katmanını kullanarak gönderme

Universal Analytics için veri katmanı kullanılarak uygulanan Ürün Tıklamasını Ölçer konusu. Özel etkinlik adı: productClick.

<script>
/**
 * Call this function when a user clicks on a product link. This function uses the event
 * callback datalayer variable to handle navigation after the ecommerce data has been sent
 * to Google Analytics.
 * @param {Object} productObj An object representing a product.
 */
function(productObj) {
  dataLayer.push({
    'event': 'productClick',
    'ecommerce': {
      'click': {
        'actionField': {'list': 'Search Results'},      // Optional list property.
        'products': [{
          'name': productObj.name,                      // Name or ID is required.
          'id': productObj.id,
          'price': productObj.price,
          'brand': productObj.brand,
          'category': productObj.cat,
          'variant': productObj.variant,
          'position': productObj.position
         }]
       }
     },
     'eventCallback': function() {
       document.location = productObj.url
     }
  });
}
</script>

Etiket Yöneticisi'nde Universal Analytics etiket yapılandırması aşağıdaki gibidir:

Etiket türü: Universal Analytics
İzleme türü: Etkinlik
Etkinlik Kategorisi: Ecommerce
Etkinlik İşlemi: Product Click
Geliştirilmiş E-Ticaret Özelliklerini Etkinleştir: true
Veri Katmanını Kullan: true
Tetikleyici: event şuna eşittir: productClick

Tetikleyici yapılandırması, productClick etkinliği veri katmanına aktarıldığında etiketi tetikleyecek şekilde ayarlanır:

Sonra: gtag.js kullanarak GA4 etkinliklerini gönderme

UA için etiket yapılandırması güncellemeleri

Etiket Yöneticisi'nde, Universal Analytics etiket yapılandırması, ürün tıklaması etkinliğinin GA4 etkinlik adında tetiklenmesi için güncellenir ve GA4 şemasını kullan seçeneği etkinleştirilir. Etiket yapılandırması artık şu şekildedir:

Etiket türü: Universal Analytics
İzleme türü: Etkinlik
Etkinlik Kategorisi: Ecommerce
Etkinlik İşlemi: Product Click
Geliştirilmiş E-Ticaret Özelliklerini Etkinleştir: true
Veri Katmanını Kullan: true
GA4 şemasını kullan: true
Tetikleyici #1: event şuna eşittir: productClick
2. Tetikleyici şuna eşittir: select_itemevent

Yeni Özel Etkinlik tetikleyicisinin tetikleyici yapılandırması, select_item Etkinlik adı'nda etiketi tetikleyecek şekilde ayarlanır:

GA4 için etiket yapılandırma güncellemeleri

GA4 Etkinliği, GA4 etkinlikleri ve parametreleri kullanılarak uygulanan e-ticaret etkinliklerini ölçecek şekilde yapılandırılır. Etiket, etkinlik adını GA4'e iletmek için yerleşik Event değişkenini kullanır. UA etiketi için oluşturulan tetikleyicinin aynısı (select_item), GA4 etiketini tetiklemek için kullanılır.

Veri katmanından gtag.js kullanmaya geçiş

Aşağıda, yukarıdaki UA uygulaması için dataLayer.push() API ile productClick özel etkinliği kullanmaktan gtag.js API ile GA4 select_item etkinliğine geçişin nasıl yapıldığı gösterilmektedir. select_item için parametre değerleri buna göre ayarlanır.

<script>
/**
 * Call this function when a user clicks on a product link.
 * @param {Object} productObj An object representing a product.
 */
function(productObj) {
  gtag('event', 'select_item', {
    'items': [{
      'item_id': productObj.id,
      'item_name': productObj.name,
      'index': productObj.position,
      'item_list_name': 'Search Results',
      'item_brand': productObj.brand,
      'item_category': productObj.cat,
      'item_variant': productObj.variant,
      'price': productObj.price
    }]
  });
}
</script>