GA4 e-ticaret (Etiket Yöneticisi): GA4 etkinliklerini 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.

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

Sonuç

Bu kılavuzdaki talimatların sonucunda, mevcut Universal Analytics uygulamanız GA4 e-ticaret etkinliklerini ve parametrelerini kullanacak şekilde güncellenir. Bu güncellenmiş e-ticaret uygulaması, e-ticaret verilerini yeni GA4 mülküne göndermek için de kullanılacaktı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 etkinliklere ilişkin veriler eksik olacaktır. Aşağıdaki Ödünleşimler ve dikkat edilmesi gereken noktalar bölümünü inceleyin.

Başlamadan önce

1. Mevcut uygulamanızı aşağıdaki hususların 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 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ızda Google Analytics 4 e-ticaret etkinliklerini kullanmak için bu kılavuzu gerçekten 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 birlikte kullanmanın olası 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 yoktur ve Universal Analytics raporlarınızda görünmez.

Uygulama

Temel uygulama hedeflerinden biri, veri katmanından gtag.js API'ye geçiş yapmaktır. Bu geçişi yaparken ölçümde kesinti yaşanmadığından emin olmak için aşağıdaki talimatlarda, ilk olarak tüm etiket yapılandırması güncellemelerinin tamamlanması ve ardından veri katmanında güncellemeler yapılması önerilir.

1. Yeni 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 Universal Analytics mülkünüzden şu ayarları kopyalayın: mülk adı, web sitesi URL'si, saat dilimi ve para birimi ayarları. 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 ayarları kopyalamak istemiyorsanız GA4 Kurulum Asistanı'nı kullanmadan 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ı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. Etiketi Tüm Sayfalarda (veya sayfaların ölçmek istediğiniz alt kümesinde) tetiklemek için bu seçeneği belirleyin.
   6. Etiket yapılandırmanızı kaydedin ve yayınlayın.

2. E-ticaret etkinliklerini ölçmek için GA4 etkinlik 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 işlemde, gtag.js API kullanılarak gönderilen GA4 e-ticaret etkinlik adı kullanılır.
3. Diğer Ayarlar ve ardından E-ticaret 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 etkinlik etiketi oluşturmanız gerekmez. Bunun yerine, tüm e-ticaret etkinlikleri için yerleşik Event değişkenini kullanan tek bir GA4 etkinlik 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üncelleyin

Her bir Universal Analytics e-ticaret etiketi yapılandırması için eşdeğer GA4 e-ticaret etkinliğinde tetiklenecek bir tetikleyici eklemeniz ve GA4 e-ticaret etkinlik 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 üzere 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 etkinliğinin 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'ı işaretleyin. Bu değişikliği, veri katmanından gtag.js API'sine geçişten önce yapmanızda bir sorun 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 etkinleşecek olan yeni eklenen tetikleyici. Bu belgenin ilerleyen bölümlerinde açıklandığı gibi, ek tetikleyici, veri katmanından gtag.js API'sine geçiş sırasında veri kesintisi olmamasını sağlamaktır.
   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 etkinlik 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 amacıyla, 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 işleminden, Etiket Yöneticisi ile birlikte çalışan gtag.js API'ye geçmeniz önerilir.

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

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

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

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

Tüm etiket yapılandırma güncellemelerini tamamlayıp gtag.js API'yi etkinleştirdikten sonra, veri katmanından gtag.js API'ye geçiş yapmaya hazırsınız demektir.

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

• gtag.js API'yi kullanarak GA4 e-ticaret etkinliklerini gönderme ve Etiket Yöneticisi'nde GA4 Etkinliği etiketini ve tetikleyicilerini yapılandırmayı öğrenmek için E-ticaret (GA4) Geliştirici Kılavuzu'nu inceleyin.
• 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 etkinliğinin 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ı olacak UA ve GA4 için karşılaştırılabilir parametreler tablosu.
• E-ticaret etkinliklerinizi doğru şekilde güncellediğinizi doğrulamanızı sağlayacak e-ticaret taşıma yardımcısı.

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

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çildiğinde 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 parametre 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ıklama 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 aşağıdaki Ürün Tıklamasını Ölçme konusu. Özel etkinliğin 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ı 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 Etkinlikleri gönderme

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

Etiket Yöneticisi'nde, Universal Analytics etiket yapılandırması, ürün tıklama 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ı Kullanın: true
GA4 şemasını kullanın: true
Tetikleyici #1: event eşittir productClick
2. Tetikleyici şuna eşittir: eventselect_item

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

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

GA4 Etkinliği, GA4 etkinlikleri ve parametreleri kullanılarak uygulanan e-ticaret etkinliklerini ölçmek için yapılandırılır. Etiket, etkinlik adını GA4'e iletmek için yerleşik Etkinlik 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ının dataLayer.push() API ile productClick özel etkinliğinden gtag.js API ile GA4 select_item etkinliğine nasıl geçiş yaptığı 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>