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
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).
* |
name |
text (metin) | *Evet |
Ürünün adı (ör. Android Tişörtü).
* |
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 |
text (metin) | *Evet |
Ürünün adı (ör. Android Tişörtü).
* Kimlik veya |
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).
* |
name |
text (metin) | *Evet |
Promosyonun adı (ör. Yaz İndirimi).
* |
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ü |
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. |
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'
}
]
});