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

GA4 e-ticaret (analytics.js - Standart e-ticaret): GA4 e-ticaret etkinliklerini gönderme

Bu kılavuzda, Google Analytics 4 e-ticaret etkinliklerini kullanmak amacıyla analytics.js Universal Analytics için mevcut bir Standart e-ticaret uygulamasını nasıl taşıyacağınız açıklanmaktadır.

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

Sonuç

Bu kılavuzdaki talimatların sonucunda, yeni Google Analytics 4 uygulamanız GA4 e-ticaret etkinliklerini yeni bir GA4 mülküne ve mevcut bir Universal Analytics mülküne gönderir. Mevcut Universal Analytics mülkü, GA4 e-ticaret verilerini alır ancak raporlarda değişiklik olmaz.

Bu, taşımanın iki aşamasıdır:

UA işlemlerini GA4 satın alma etkinliğine taşıma
- Universal Analytics için Standart e-ticaret, işlem ve öğe verilerinin gönderilmesini destekler. Google Analytics 4 purchase etkinliğine geçiş yapmak eşdeğer işlev sağlar.
(İsteğe bağlı) Diğer GA4 e-ticaret etkinliklerini ölçme
- GA4 e-ticaret özelliklerinden tam olarak yararlanmak için diğer GA4 e-ticaret etkinliklerini uygulayın. Ürün görüntülemeleri ve etkileşimleri, satın alma öncesi etkileşimler, ödeme etkileşimleri.

Başlamadan önce

Aşağıdakilerin mevcut uygulamanızı açıkladığını onaylayın:
- Universal Analytics mülkü kullanıyorsunuz.
  - Mülkünüzün İzleme Kimliği varsa Universal Analytics'tir.
- Siteniz, e-ticaret etkinliklerini göndermek için analytics.js kitaplığını kullanıyor.
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.
Bir UA mülküne gönderildiğinde GA4 satın alma etkinliğinin nasıl çevrildiğini öğrenmek için Etkinlik uyumluluğu referansını inceleyin.

Ödünler ve dikkat edilmesi gereken noktalar

Universal Analytics e-ticaret uygulamanızla birlikte Google Analytics 4 e-ticaret etkinliklerini kullanmanın olası etkilerini tam olarak anlamak için aşağıdaki bilgileri inceleyin.

Artıları	Eksileri
E-ticaret verilerini hem GA4 hem de Universal Analytics raporlarında görüntüleyin. GA4 `purchase` etkinliğine geçiş yaptığınızda eksiksiz UA e-ticaret raporları sağlanır.	analytics.js'den gtag.js'ye geçiş için ek çalışmalar. Tüm özel ölçümleri analytics.js'den gtag.js'ye (ör.etkinlikler, sayfa görüntülemeler, zamanlama vb.) taşımanız önerilir.

Uygulama

1. UA ölçümünü analytics.js'den gtag.js'ye taşıma

GA4 e-ticaret etkinliklerini göndermek için tüm özel ölçümler dahil olmak üzere analytics.js'den gtag.js'ye geçmeniz gerekir.

Genel olarak, taşıma işlemini tamamlamak için uygulanacak adımlar şunlardır:

analytics.js snippet'ini kaldırın.
Google etiketini (gtag.js) yükleyin ve UA mülkünüzün İzleme Kimliği ile yapılandırın.
Özel ölçüm kodunuzu analytics.js'den gtag.js'ye taşıyın. Aşağıdaki bölümlerde standart bir e-ticaret işleminin nasıl taşınacağı açıklanmaktadır. Diğer ölçüm senaryolarını taşımayla ilgili genel yardım için Ölçümü taşıma bölümüne bakın.

Önce: analytics.js etiketi

<!-- Google Analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');

ga('create', 'UA-XXXXX-Y', 'auto');    // Universal Analytics property.
ga('send', 'pageview');
</script>
<!-- End Google Analytics -->

Sonra: Google etiketi (gtag.js)

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-XXXXX-Y"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-XXXXX-Y');    // Universal Analytics property.
</script>

2. E-ticaret uygulamanızı GA4 etkinliklerini göndermek için güncelleme

Mevcut e-ticaret uygulamanızı, Universal Analytics e-ticaret etkinliklerini kullanmaktan Google Analytics 4 etkinliklerine geçiş yapacak şekilde güncelleyin. Bu adımı tamamladığınızda Universal Analytics mülkünüz bir GA4 purchase etkinliği alır. Bu güncellemenin sonuçlarını anlamak için Ödünleşimler ve dikkat edilmesi gereken noktalar bölümünü inceleyin.

Aşağıdaki örnekte, bir analytics.js standart e-ticaret işlem etkinliğinin, Universal Analytics ile uyumlu bir GA4 e-ticaret purchase etkinliğine nasıl taşınacağı gösterilmektedir.

Önce: UA standart e-ticaret işlemi (analytics.js)

Aşağıdaki örnekte, 2 öğeli bir işlem için bir analytics.js standart e-ticaret uygulaması gösterilmektedir:

// Add the transaction.
ga('ecommerce:addTransaction', {
  id: '1234',     // Transaction ID.
  affiliation: 'Google Store',
  revenue: '29.97',
  shipping: '5.25',
  tax: '2.42'
});

// Add the items belonging to the transaction.
ga('ecommerce:addItem', {
  id: '1234',     // Transaction ID.
  name: 'Android Warhol T-Shirt',
  sku: 'P12345',  // Item ID.
  category: 'Apparel/T-Shirts',
  price: '12.99',
  quantity: '2'
});
ga('ecommerce:addItem', {
  id: '1234',     // Transaction ID.
  name: 'Flame challenge T-Shirt',
  sku: 'P67890',  // Item ID.
  category: 'Apparel/T-Shirts',
  price: '3.99',
  quantity: '1'
});
ga('ecommerce:send');

Sonra: GA4 e-ticaret satın alma (gtag.js)

Bir analytics.js işlem etkinliğini GA4 purchase etkinliğine taşırken önemli farklar şunlardır:

GA4, işlemle ilgili tüm ayrıntıları ve öğeleri içeren tek bir purchase etkinliğine sahiptir. analytics.js, aynı bilgileri yakalamak için birden fazla ga() e-ticaret komutu yürütür.
GA4'te, etkinliğin tamamı için tek bir transaction_id alanı bulunur. analytics.js, her öğeye işlem kimliğinin eklenmesini gerektirir.
GA4'te birden fazla öğe kategorisi alanı bulunur. analytics.js, hiyerarşileri açıklamak için / sınırlayıcıya sahip tek bir kategori alanı kullanır. Ancak birden fazla öğe kategorisi alanına sahip GA4 etkinlikleri, Kategori parametresi çevirisi nedeniyle UA mülkünüz için çalışacaktır.

 gtag('event', 'purchase', {
   currency: 'USD',
   transaction_id: '1234',    // Transaction ID.
   value: 29.97,
   affiliation: 'Google Store',
   shipping: 5.25,
   tax: 2.42,
   items: [
    {
      item_id: 'P12345',     // Item ID.
      item_name: 'Android Warhol T-Shirt',
      item_category: 'Apparel',
      item_category2: 'T-Shirts',
      price: 12.99,
      quantity: 2
    },
    {
      item_id: 'P67890',    // Item ID.
      item_name: 'Flame challenge T-Shirt',
      item_category: 'Apparel',
      item_category2: 'T-Shirts',
      price: 3.99,
      quantity: 1
    }
  ]
});

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

E-ticaret uygulamanızı GA4 e-ticaret etkinliklerini gönderecek şekilde güncelledikten sonra, yeni bir Google Analytics 4 mülküne veri göndermeye başlamak için aşağıdaki seçeneklerden birini tamamlayın.

1. Seçenek: GA4 Kurulum Asistanı'nı kullanma ve bağlı site etiketlerini etkinleştirme

GA4 Kurulum Asistanı, otomatik olarak yeni bir GA4 mülkü oluşturur ve Universal Analytics mülkünüzdeki şu ayarları kopyalar: mülk adı, web sitesi URL'si, saat dilimi ve para birimi ayarları. Ayrıca, yeni GA4 mülkünüzü yüklemek üzere mevcut Universal Analytics gtag.js uygulamanızı yeniden kullanmak için bağlı site etiketi özelliğini de etkinleştirebilir.

Yeni bir Google Analytics 4 mülkü oluşturmak ve yapılandırmak için GA4 Kurulum Asistanı'nda açıklanan adımları uygulayın. Bağlı site etiketi özelliğini kullanmak için Mevcut etiketlerinizi kullanarak veri toplamayı etkinleştirin seçeneğini işaretlediğinizden emin olun.

2. Seçenek: gtag.js snippet'inizi güncelleme

Yeni bir Google Analytics 4 mülkü oluşturun.
- Google Analytics 4 mülkü eklemek için GA4 Kurulum Asistanı'nı kullanın. Ancak kurulum sırasında istendiğinde Mevcut etiketlerinizi kullanarak veri toplamayı etkinleştirin seçeneğinin işaretini kaldırın. Alternatif olarak, GA4 Kurulum Asistanı olmadan bir Google Analytics 4 mülkü oluşturabilirsiniz. Asistan'ı kullanmanın avantajı, Universal Analytics mülkünüzden bazı temel ayarları kopyalamasıdır.
Google Analytics 4 mülkünün etiket kimliğini bulun.
Google Analytics 4 mülkünü mevcut gtag.js snippet'inize eklemek için etiket kimliğiyle birlikte config komutunu kullanın.

Aşağıda, Universal Analytics ve Google Analytics 4 mülkünü yapılandıran bir gtag.js snippet'i örneği verilmiştir.

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-XXXXX-Y"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-XXXXX-Y');         // Universal Analytics property.
  gtag('config', 'TAG_ID');  // Google Analytics 4 property.
</script>

4. (İsteğe bağlı) Ek e-ticaret etkinliklerini ölçme

GA4 e-ticaret raporlarından tam olarak yararlanmak için ek GA4 e-ticaret etkinliklerini uygulayın. Daha fazla bilgi edinmek için Google Analytics 4 E-ticaret bölümünü inceleyin.

Varsayılan gtag.js snippet yapılandırmasını kullanıyorsanız GA4 etkinlikleri hem UA hem de GA4 mülklerinize gönderilir. UA mülkünüze gönderilen GA4 etkinlikleri, Etkinlik uyumluluğu referansında tanımlandığı şekilde çevrilir. Farklı bir davranış tercih ederseniz UA ve GA4 mülkünüze hangi etkinliklerin gönderileceğini kontrol etmek için gtag.js'nin Gruplama ve rota verileri işlevini kullanabilirsiniz. Örneğin, purchase etkinliğini hem UA hem de GA4 mülkünüze gönderirken yalnızca diğer GA4 e-ticaret etkinliklerini GA4 mülkünüze gönderebilirsiniz.