Standart Universal Analytics (UA) mülkleri 1 Temmuz 2023'ten itibaren veri işlemeyi durduracak (UA 360 mülkleri için 1 Temmuz 2024). Google Analytics 4'e geçin.

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

Switch to English

Geliştirilmiş e-ticaret

Bu sayfada, geliştirilmiş e-ticaret verilerini toplamak için gtag.js'yi nasıl kullanacağınız açıklanmaktadır. Google Analytics'i gtag.js'de yapılandırdıysanız ve Google Analytics'te geliştirilmiş e-ticareti etkinleştirdiyseniz Google Analytics'e gösterim verileri, ürün verileri, tanıtım verileri ve işlem verileri göndermek için gtag.js'yi kullanabilirsiniz.

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

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

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

Gösterim Verileri

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

Anahtar	Değer Türü	Zorunlu	Açıklama
`id`	kısa mesaj	*Evet	Ürün kimliği veya SKU (ör. P67890). * `id` veya `name`lerden biri ayarlanmalıdır.
`name`	kısa mesaj	*Evet	Ürünün adı (ör. Android Tişörtü). * `id` veya `name`lerden biri ayarlanmalıdır.
`list`	kısa mesaj	Hayır	Ürünün ait olduğu liste veya koleksiyon (ör. Arama Sonuçları)
`list_name`	kısa mesaj	Hayır	Ürünün ait olduğu liste veya koleksiyon (ör. Arama Sonuçları)
`brand`	kısa mesaj	Hayır	Ürünle ilişkili marka (ör. Google).
`category`	kısa mesaj	Hayır	Ürünün ait olduğu kategori (ör. Giyim). En fazla 5 hiyerarşi düzeyini (ör. Giyim/Erkek/Tişört) belirtmek için sınırlayıcı olarak `/` kullanın.
`variant`	kısa mesaj	Hayır	Ürünün varyantı (ör. Siyah).
`position`	tam sayı	Hayır	Ürünün bir listedeki veya koleksiyondaki konumu (ör. 2).
`list_position`	tam sayı	Hayır	Ürünün bir listedeki veya koleksiyondaki konumu (ör. 2).
`price`	number (sayı)	Hayır	Ürünün fiyatı (ör. 29,20).

Ürün Verileri

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

Anahtar	Değer Türü	Zorunlu	Açıklama
`id`	kısa mesaj	*Evet	Ürün kimliği veya SKU (ör. P67890). * Kimlik veya `name` değerlerinden biri ayarlanmalıdır.
`name`	kısa mesaj	*Evet	Ürünün adı (ör. Android Tişörtü). * Kimlik veya `name` değerlerinden biri ayarlanmalıdır.
`brand`	kısa mesaj	Hayır	Ürünle ilişkili marka (ör. Google).
`category`	kısa mesaj	Hayır	Ürünün ait olduğu kategori (ör. Giyim). En fazla 5 hiyerarşi düzeyini belirtmek için sınırlayıcı olarak / kullanın (ör. Giyim/Erkek/Tişörtler).
`variant`	kısa mesaj	Hayır	Ürünün varyantı (ör. Siyah).
`price`	number (sayı)	Hayır	Ürünün fiyatı (ör. 29,20).
`quantity`	tam sayı	Hayır	Ürünün miktarı (ör. 2).
`coupon`	kısa mesaj	Hayır	Bir ürünle ilişkili kupon kodu (ör. SUMMER_SALE13).
`position`	tam sayı	Hayır	Ürünün bir listedeki veya koleksiyondaki konumu (ör. 2).
`list_position`	tam sayı	Hayır	Ürünün bir listedeki veya koleksiyondaki konumu (ör. 2).

Promosyon Verileri

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

Anahtar	Değer Türü	Zorunlu	Açıklama
`id`	kısa mesaj	*Evet	Promosyon kodu (ör. PROMO_1234). * `id` veya `name`lerden biri ayarlanmalıdır.
`name`	kısa mesaj	*Evet	Promosyonun adı (ör. Yaz İndirimi). * `id` veya `name`lerden biri ayarlanmalıdır.
`creative`	kısa mesaj	Hayır	Tanıtımla ilişkili reklam öğesi (ör. yaz_banner2).
`creative_name`	kısa mesaj	Hayır	Reklam öğesinin adı (ör. yaz_banner2).
`position`	kısa mesaj	Hayır	Reklam öğesinin konumu (ör. banner_slot_1).
`creative_slot`	kısa mesaj	Hayır	Reklam alanının adı (ör. banner_slot_1).

İşlem Verileri

E-ticaretle ilgili olarak gerçekleşen bir işlem hakkındaki bilgileri temsil eder. actionFieldObject olarak anılır ve aşağıdaki değerleri içerir:

Anahtar	Değer Türü	Zorunlu	Açıklama
`id`	kısa mesaj	*Evet	İşlem kimliği (ör. T1234). * İşlem türü `purchase` veya `refund` ise gereklidir
`affiliation`	kısa mesaj	Hayır	Bu işlemin gerçekleştiği mağaza veya satış ortağı (ör. Google Store).
`revenue`	number (sayı)	Hayır	İşlemle ilişkili toplam geliri veya genel toplamı belirtir (ör. 11,99). Bu değer, gönderim bedelini, vergi maliyetlerini veya gelir hesaplamalarınızın bir parçası olarak dahil etmek istediğiniz toplam gelirde yapılan diğer düzenlemeleri içerebilir. Not: Gelir belirlenmezse değeri, aynı isabetteki tüm ürünlerin ürün miktarı ve fiyat alanları kullanılarak otomatik olarak hesaplanır.
value	number (sayı)	Hayır	Etkinlikle ilişkili değer (ör. gelir).
`tax`	number (sayı)	Hayır	İşlemle ilişkili toplam vergi.
`shipping`	number (sayı)	Hayır	İşlemle ilişkilendirilen gönderim maliyeti.
`coupon`	kısa mesaj	Hayır	İşlemde kullanılan işlem kuponu.
`list`	kısa mesaj	Hayır	İlişkili ü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 işlemindeki bir adımı temsil eden sayı. "Ödeme" işlemlerinde isteğe bağlıdır.
`checkout_step`	tam sayı	Hayır	Ödeme işlemindeki bir adımı temsil eden sayı.
`option`	kısa mesaj	Hayır	`checkout` ve `checkout_option` işlemleri için ödeme sayfasındaki seçenek bilgilerini (ör. seçili ödeme yöntemi) açıklayabilecek ek alan.
`checkout_option`	kısa mesaj	Hayır	Ödeme seçeneği (yani seçilen ödeme yöntemi).

Anahtar	Değer Türü	Zorunlu	Açıklama
`coupon`	string	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ün için bir ürünün ya da ürün bağlantısının tıklanması.
`detail`	Ürün ayrıntılarının görünümü.
`add`	Bir alışveriş sepetine bir veya daha fazla ürün ekleme.
`remove`	Bir veya daha fazla ürünü alışveriş sepetinden çıkarma.
`checkout`	Bir veya daha fazla ürün için ödeme işlemini başlatma.
`checkout_option`	Belirli bir ödeme adımı için seçenek değeri gönderme.
`purchase`	Bir veya daha fazla ürünün satışı.
`refund`	Bir veya daha fazla ürünün geri ödemesi.
`promo_click`	Dahili tanıtımın tıklanması.
`add_to_cart`	Bir kullanıcının alışveriş sepetine bir veya daha fazla ürün eklemesi.
`begin_checkout`	Kullanıcı, bir veya daha fazla ürün için ödeme işlemini başlatır.
`checkout_progress`	Kullanıcı ilk adımı tamamladıktan sonra ödeme adımlarını tamamlar.
`purchase`	Kullanıcı bir satın alma işlemini tamamlar.
`refund`	Kullanıcıya bir veya daha fazla ürün için geri ödeme yapılır.
`remove_from_cart`	Bir kullanıcı, alışveriş sepetindeki bir veya daha fazla ürünü kaldırır.
`select_content`	Kullanıcı bir ürünü veya ürün bağlantısını tıklar.
`set_checkout_option`	Kullanıcının tamamlamakta olduğu ö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ünün listesini görüntüler.
`view_promotion`	Kullanıcı dahili bir promosyonu tıklar.
`view_refund`	Kullanıcı, bir veya daha fazla ürün için geri ödeme görüntüleyebilir.

Örnekler

Ürün gösterimlerini ölçme

Ürün gösterimlerini ölçmek için ürün bilgilerini içeren 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 bir select_content etkinliği gönderin, content_type olarak product özelliğini 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üleme sayısını ölçme

Bir ürün listelemesini tıkladıktan sonra, kullanıcı ürün ayrıntıları sayfasını görüntüleyebilir. Ürün ayrıntısı görüntüleme sayısını ö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ş sepetlerine yapılan eklemeleri ve kaldırmaları ölçme

Alışveriş sepetine bir ürün 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 kaldırılması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'
    }
  ]
});

Ödeme işlemlerini ölçme

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

Ödeme işleminin her adımını ölçmek için ölçüm kodu ekleyin.
Mümkünse ö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 öğelerini içeren 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 öğelerini içeren 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ğini kullanarak 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

Tanıtım 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"
    }
  ]
});

Promosyon tıklamalarını ölçme

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

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

Satın almaları ö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 tam geri ödemesini ölçmek için işlem kimliğiyle birlikte bir refund etkinliği gönderin:

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

Kısmi geri ödemeyi ölçmek için işlem kimliği ve geri ödenecek öğelerle birlikte 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'
    }
  ]
});