Standart Universal Analytics (UA) mülkleri 1 Temmuz 2023'te veri işlemeyi durdurdu. UA 360 mülkleri 1 Temmuz 2024'te veri işlemeyi durduracak ve Google Analytics 4'e geçişimiz sırasında bazı UA 360 özellikleri bu tarihten önce kullanımdan kaldırılacak.

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

Geliştirilmiş e-ticaret

Bu sayfada, geliştirilmiş e-ticaret verilerini toplamak için gtag.js'nin nasıl kullanılacağı açıklanmaktadır. gtag.js'de Google Analytics'i yapılandırdıysanız ve Google Analytics'te geliştirilmiş e-ticareti etkinleştirdiyseniz gtag.js'yi kullanarak gösterim verilerini, ürün verilerini, promosyon verilerini ve işlem verilerini Google Analytics'e gönderebilirsiniz.

Geliştirilmiş E-ticaret Veri Türleri ve İşlemleri

Gönderebileceğiniz birden fazla e-ticaret verisi türü vardır:

gösterim verileri
ürün verileri
işlem verileri
işlem türleri

Gösterim Verileri

Görüntülenen bir ürünle ilgili bilgileri temsil eder. impressionFieldObject olarak adlandırılır ve aşağıdaki değerleri içerir:

Anahtar	Değer Türü	Gerekli	Açıklama
`id`	text (metin)	*Evet	Ürün kimliği veya SKU'su (ör. P67890). * `id` veya `name` değerlerinden biri ayarlanmalıdır.
`name`	text (metin)	*Evet	Ürünün adı (ör. Android Tişörtü). * `id` veya `name` değerlerinden biri ayarlanmalıdır.
`list`	text (metin)	Hayır	Ürünün ait olduğu liste veya koleksiyon (ör. arama sonuçları)
`list_name`	text (metin)	Hayır	Ürünün ait olduğu liste veya koleksiyon (ör. arama sonuçları)
`brand`	text (metin)	Hayır	Ürünle ilişkili marka (ör. Google).
`category`	text (metin)	Hayır	Ürünün ait olduğu kategori (ör. Giyim). 5'e kadar hiyerarşi düzeyini belirtmek için sınırlayıcı olarak `/` kullanın (ör. Giyim/Erkek/Tişörtler).
`variant`	text (metin)	Hayır	Ürünün varyantı (ör. Siyah).
`position`	tam sayı	Hayır	Ürünün bir liste veya koleksiyondaki konumu (ör. 2).
`list_position`	tam sayı	Hayır	Ürünün bir liste veya koleksiyondaki konumu (ör. 2).
`price`	sayı	Hayır	Bir ürünün fiyatı (ör. 29,20).

Ürün Verileri

Ürün verileri, görüntülenen, alışveriş sepetine eklenen vb. ürünleri ayrı ayrı temsil eder. productFieldObject olarak adlandırılır ve aşağıdaki değerleri içerir:

Anahtar	Değer Türü	Gerekli	Açıklama
`id`	text (metin)	*Evet	Ürün kimliği veya SKU'su (ör. P67890). * Kimlik veya `name` özelliklerinden biri ayarlanmalıdır.
`name`	text (metin)	*Evet	Ürünün adı (ör. Android Tişörtü). * Kimlik veya `name` özelliklerinden biri ayarlanmalıdır.
`brand`	text (metin)	Hayır	Ürünle ilişkili marka (ör. Google).
`category`	text (metin)	Hayır	Ürünün ait olduğu kategori (ör. Giyim). 5'e kadar hiyerarşi düzeyini belirtmek için sınırlayıcı olarak / karakterini kullanın (ör. Giyim/Erkek/Tişörtler).
`variant`	text (metin)	Hayır	Ürünün varyantı (ör. Siyah).
`price`	sayı	Hayır	Bir ürünün fiyatı (ör. 29,20).
`quantity`	tam sayı	Hayır	Bir ürünün miktarı (ör. 2).
`coupon`	text (metin)	Hayır	Bir ürünle ilişkilendirilmiş kupon kodu (ör. YAZ_SAAT13).
`position`	tam sayı	Hayır	Ürünün bir liste veya koleksiyondaki konumu (ör. 2).
`list_position`	tam sayı	Hayır	Ürünün bir liste veya koleksiyondaki konumu (ör. 2).

Promosyon Verileri

Görüntülenen promosyonla ilgili bilgileri temsil eder. Bu, promoFieldObject olarak adlandırılır ve aşağıdaki değerleri içerir:

Anahtar	Değer Türü	Gerekli	Açıklama
`id`	text (metin)	*Evet	Promosyon kimliği (ör. PROMO_1234). * `id` veya `name` değerlerinden biri ayarlanmalıdır.
`name`	text (metin)	*Evet	Promosyonun adı (ör. Yaz İndirimi). * `id` veya `name` değerlerinden biri ayarlanmalıdır.
`creative`	text (metin)	Hayır	Promosyonla ilişkili reklam öğesi (ör. yaz_banner2).
`creative_name`	text (metin)	Hayır	Reklam öğesinin adı (ör. yaz_banner2).
`position`	text (metin)	Hayır	Reklam öğesinin konumu (ör. banner_slot_1).
`creative_slot`	text (metin)	Hayır	Reklam öğesi alanının adı (ör. banner_slot_1).

İşlem Verileri

E-ticaretle ilgili olarak yapılmış bir işlemle ilgili bilgileri temsil eder. actionFieldObject olarak adlandırılır ve aşağıdaki değerleri içerir:

Anahtar	Değer Türü	Gerekli	Açıklama
`id`	text (metin)	*Evet	İşlem kimliği (ör. T1234). * İşlem türü `purchase` veya `refund` ise zorunludur
`affiliation`	text (metin)	Hayır	Bu işlemin gerçekleştirildiği mağaza veya satış ortağı (ör. Google Store).
`revenue`	sayı	Hayır	Bu işlemle ilişkilendirilen toplam geliri veya genel toplamı (ör. 11,99) belirtir. Bu değer, gelir hesaplamalarınızın bir parçası olarak toplam gelirinize dahil etmek istediğiniz gönderim bedelini, vergi maliyetlerini veya diğer ayarlamaları içerebilir. Not: Gelir ayarlanmazsa değeri, aynı isabetteki tüm ürünlerin ürün miktarı ve fiyat alanları kullanılarak otomatik olarak hesaplanır.
value	sayı	Hayır	Etkinlikle ilişkili değer (ör. gelir).
`tax`	sayı	Hayır	İşlemle ilişkili toplam vergi.
`shipping`	sayı	Hayır	İşlemle ilişkilendirilen gönderim maliyeti.
`coupon`	text (metin)	Hayır	İşlemde kullanılan işlem kuponu.
`list`	text (metin)	Hayır	İlişkilendirilmiş ürünlerin ait olduğu liste. İsteğe bağlı.
`items`	dizi	Hayır	İlişkilendirilmiş ürünleri içeren dizi.
`step`	tam sayı	Hayır	Ödeme sürecindeki bir adımı temsil eden sayı. "Ödeme" işlemlerinde isteğe bağlıdır.
`checkout_step`	tam sayı	Hayır	Ödeme sürecindeki bir adımı temsil eden sayı.
`option`	text (metin)	Hayır	Seçilen ödeme yöntemi gibi ödeme sayfasındaki seçenek bilgilerini açıklayabilen, `checkout` ve `checkout_option` işlemleri için ek alan.
`checkout_option`	text (metin)	Hayır	Ödeme seçeneği (yani seçilen ödeme yöntemi).

Anahtar	Değer Türü	Gerekli	Açıklama
`coupon`	dize	Hayır	Satın alınabilir bir öğenin kupon kodu.

Ürün ve Promosyon İşlemleri

İşlemler, Google Analytics'e gönderdiğiniz ürün ve promosyon verilerinin nasıl yorumlanacağını belirtir.

İşlem	Etkinlik	Açıklama
`click`	Bir veya daha fazla ürüne ait ürün veya ürün bağlantısının tıklanması.
`detail`	Ürün ayrıntılarının görünümü.
`add`	Alışveriş sepetine bir veya daha fazla ürün ekleme.
`remove`	Alışveriş sepetinden bir veya daha fazla ürünü kaldırın.
`checkout`	Bir veya daha fazla ürün için ödeme sürecini başlatma.
`checkout_option`	Belirli bir ödeme adımı için seçenek değerini gönderme.
`purchase`	Bir veya daha fazla ürünün satışı.
`refund`	Bir veya daha fazla ürün için geri ödeme.
`promo_click`	Dahili tanıtımın tıklanması.
`add_to_cart`	Kullanıcı, alışveriş sepetine bir veya daha fazla ürün ekler.
`begin_checkout`	Kullanıcı, en az bir ürün için ödeme işlemini başlatır.
`checkout_progress`	Kullanıcı, ödeme adımlarını ilk ödeme adımından sonra tamamlar.
`purchase`	Kullanıcı bir satın alma işlemini tamamlar.
`refund`	Bir kullanıcıya bir veya daha fazla ürün için geri ödeme yapılır.
`remove_from_cart`	Kullanıcı, alışveriş sepetinden bir veya daha fazla ürünü kaldırır.
`select_content`	Kullanıcı bir ürünü veya ürünün bağlantısını tıklar.
`set_checkout_option`	Kullanıcının tamamladığı ödeme adımı.
`view_item`	Kullanıcı bir ürünün ayrıntılarını görüntüler.
`view_item_list`	Kullanıcı, bir veya daha fazla üründen oluşan bir listeyi görüntüler.
`view_promotion`	Bir kullanıcı, dahili bir tanıtımı tıklar.
`view_refund`	Kullanıcı, bir veya daha fazla ürün için yapılan geri ödemeyi görüntüler.

Örnekler

Ürün gösterimlerini ölçme

Ürün gösterimlerini ölçmek için ürün bilgileriyle birlikte bir view_item_list gönderin:

gtag('event', 'view_item_list', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": 3
    }
  ]
});

Ürün tıklamalarını ölçme

Bir ürün tıklamasını ölçmek için select_content etkinliği gönderin, content_type olarak product değerini belirtin ve ürün bilgilerini sağlayın:

gtag('event', 'select_content', {
  "content_type": "product",
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    }
  ]
});

Ürün ayrıntısı görüntülemelerini ölçme

Kullanıcı, bir ürün listelemesini tıkladıktan sonra ürün ayrıntıları sayfasını görüntüleyebilir. Ürün ayrıntıları görüntülemelerini ölçmek için ürün ayrıntılarını içeren bir view_item etkinliği gönderin:

gtag('event', 'view_item', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Alışveriş sepetine ekleme ve sepetten ürün çıkarma işlemlerini ölçme

Bir ürünün alışveriş sepetine eklendiğini ölçmek için ürün bilgilerini içeren bir add_to_cart etkinliği gönderin:

gtag('event', 'add_to_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Bir ürünün alışveriş sepetinden ne zaman çıkarıldığını ölçmek için ürün bilgilerini içeren bir remove_from_cart etkinliği gönderin:

gtag('event', 'remove_from_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Ödemeleri ölçme

Ödeme sürecindeki her adımı ölçmek için:

Ödeme sürecinin her adımını ölçmek için ölçüm kodu ekleyin.
Varsa ödeme seçeneklerini kaydetmek için ölçüm kodu ekleyin.

1. Ödeme adımlarını ölçme

İlk ödeme adımını ölçmek için ödeme öğeleriyle birlikte bir begin_checkout etkinliği gönderin:

gtag('event', 'begin_checkout', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": ""
});

Sonraki her ödeme adımını ölçmek için ödeme öğeleriyle birlikte bir checkout_progress etkinliği gönderin:

gtag('event', 'checkout_progress', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": "SUMMER_DISCOUNT"
});

2. Ödeme seçeneklerini ölçme

Bir ödeme seçeneğini ölçmek için ödeme seçeneğiyle birlikte bir set_checkout_option etkinliği gönderin:

gtag('event', 'set_checkout_option', {
  "checkout_step": 1,
  "checkout_option": "shipping method",
  "value": 3
});

Tanıtım gösterimlerini ölçme

Promosyon gösterimlerini ölçmek için promosyon bilgilerini içeren bir view_promotion etkinliği gönderin:

gtag('event', 'view_promotion', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    },
    {
      "id": "xyz987",
      "name": "spring savings"
    }
  ]
});

Tanıtım tıklamalarını ölçme

Bir promosyon tıklamasını ölçmek için select_content etkinliği gönderin ve promosyonu sağlayın:

gtag('event', 'select_content', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    }
  ]
});

Satın alma işlemlerini ölçme

Bir işlemi ölçmek için işlemdeki öğelerle birlikte bir purchase etkinliği gönderin:

gtag('event', 'purchase', {
  "transaction_id": "24.031608523954162",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});

Geri ödemeleri ölçme

Bir işlemin eksiksiz geri ödemesini ölçmek için işlem kimliğine sahip bir refund etkinliği gönderin:

gtag('event', 'refund', { "transaction_id": "T12345" })

Kısmi geri ödemeyi ölçmek için işlem kimliğini ve geri ödeme yapılacak öğeleri içeren bir refund etkinliği gönderin:

gtag('event', 'refund', {
  "transaction_id": "79.18502354114992",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});