- Konu sahibi
- #1
GA4’te ürün bilgisi, e-ticaret olayının içindeki
Ürün bilgilerini olayın en üst seviyesinde
Aşağıdaki örnek, bir ürün görüntüleme olayında tek ürün gönderir.
Bu olay ürün sayfası açıldığında çalıştırılabilir. Sepete ekleme için aynı ürün nesnesini
Alan seçerken yalnız gerçekten sahip olduğunuz ve tutarlı üretebildiğiniz bilgileri gönderin. Sabit olmayan veya her sayfada değişen değerlerle ürün raporlarını bozmayın.
Kategori hiyerarşiniz varsa alt kategori bilgilerini GA4’ün desteklediği kategori alanlarıyla tutarlı biçimde kullanın. Özel ürün niteliği raporlarda gerekli oluyorsa özel parametre olarak gönderilebilir; ancak standart alanların yerine aynı bilgiyi farklı adlarla çoğaltmayın.
Tarayıcı geliştirici araçlarında gönderilen isteği incelemek de yararlıdır. Tarayıcıdaki Google etiketi ürünleri ağ isteğinde kodlanmış alanlarla taşıyabilir; ağ gövdesinde düz bir items JSON dizisi görmemek tek başına hata değildir. Gtag’a verdiğiniz yapı ile taşıma biçimini karıştırmayın. Olay nesnesindeki items gerçekten boşsa verinin hazır olma sırası ve ürün nesnesinin seviyesi incelenmelidir. Satın alma olayını sayfa yenilemesinde yeniden göndermemek için sipariş başarı durumu ve işlem kimliğiyle tekrar tetiklenmeyi engelleyin.
GTM kullanıyorsanız olayın veri katmanından GA4 etiketine nasıl eşlendiğini ayrıca kurun; bu gtag örneklerini mevcut GTM e-ticaret gönderiminin yanına ekleyip aynı olayı iki kez üretmeyin. Özel ürün niteliğini raporlamak için uygun öğe kapsamında özel boyut gerekebilir; parametre göndermek bütün standart raporlara otomatik sütun eklemez.
Ürün alanlarını üst seviyeye koymak:
Aynı ürüne değişken kimlik vermek: Ürün kimliği sayfa, dil veya kampanya değiştikçe değişirse aynı ürün farklı ürünler gibi raporlanabilir. Katalogdaki kararlı kimliği kullanın.
Fiyatı metin göndermek: Fiyat ve adet gibi sayısal değerleri biçimlendirilmiş metin yerine sayısal veri olarak gönderin. Para birimini ayrıca
Satın almada ürün listesini göndermemek: Yalnızca toplam
items dizisine eklenir. Her ürün ayrı bir nesne olmalıdır. En azından ürünü ayırt eden kararlı bir item_id veya ürün adı olan item_name gönderin; pratikte benzersiz SKU ya da ürün kodunu item_id olarak kullanmak daha sağlıklıdır. Ürün adı, fiyat ve adet gibi alanlar da aynı ürün nesnesinde yer alır.Ürün bilgilerini olayın en üst seviyesinde
product_name veya product_price gibi özel alanlarla göndermek, GA4’ün standart e-ticaret raporlarında ürün olarak işlenmesini sağlamaz. Doğru yapı items: [{ ... }] biçimidir.Temel veri yapısı ve uygulanabilir örnek
Aşağıdaki örnek, bir ürün görüntüleme olayında tek ürün gönderir.
gtag kütüphanesinin sayfada daha önce kurulmuş ve GA4 ölçüm kimliğinin yapılandırılmış olduğu varsayılmıştır.
Kod:
<script>
gtag('event', 'view_item', {
currency: 'TRY',
value: 1299.90,
items: [{
item_id: 'SKU-1001',
item_name: 'Kablosuz Kulaklık',
item_brand: 'Örnek Marka',
item_category: 'Elektronik',
price: 1299.90,
quantity: 1
}]
});
</script>Bu olay ürün sayfası açıldığında çalıştırılabilir. Sepete ekleme için aynı ürün nesnesini
add_to_cart olayında, satın alma tamamlandığında ise purchase olayının items dizisinde gönderin. Aşağıdaki ikinci kod, ürün görüntüleme kodunun hemen peşine koşulsuz eklenmez; yalnız uygulamanız siparişin başarılı olduğunu doğruladığında çalıştırılacak ayrı bir örnektir. Denemeyi test mülkünde yapın. Satın almada kişisel bilgi içermeyen kararlı ve benzersiz işlem kimliği de eklenmelidir:
Kod:
gtag('event', 'purchase', {
transaction_id: 'ORDER-5001',
currency: 'TRY',
value: 1299.90,
items: [{
item_id: 'SKU-1001',
item_name: 'Kablosuz Kulaklık',
price: 1299.90,
quantity: 1
}]
});value olayın toplam parasal değerini, price ise ilgili ürünün birim fiyatını ifade eder. Birden fazla ürün varsa items içine ayrı nesneler ekleyin; quantity adet bilgisidir. GA4’ün bu olayları için value, items içindeki indirim uygulanmış price × quantity toplamıyla tutarlı olmalıdır; kargo ve vergiyi bu toplama katmayın, uygun shipping/tax alanlarında ayrı gönderin. Örneğin birim fiyatı 1299.90 TRY olan iki ürünün ürün toplamı 2599.80 olur; kargo eklenmiş sipariş tahsilatı başka bir toplam olabilir.Sık kullanılan ürün alanları
Alan seçerken yalnız gerçekten sahip olduğunuz ve tutarlı üretebildiğiniz bilgileri gönderin. Sabit olmayan veya her sayfada değişen değerlerle ürün raporlarını bozmayın.
| Alan | Kapsamı | Örnek |
|---|---|---|
| item_id | Ürünün kararlı kimliği veya SKU’su | SKU-1001 |
| item_name | Ürünün görünen adı | Kablosuz Kulaklık |
| price | Tek ürünün fiyatı | 1299.90 |
| quantity | Olaydaki ürün adedi | 1 |
| item_brand | Ürün markası | Örnek Marka |
| item_category | Ana ürün kategorisi | Elektronik |
Kategori hiyerarşiniz varsa alt kategori bilgilerini GA4’ün desteklediği kategori alanlarıyla tutarlı biçimde kullanın. Özel ürün niteliği raporlarda gerekli oluyorsa özel parametre olarak gönderilebilir; ancak standart alanların yerine aynı bilgiyi farklı adlarla çoğaltmayın.
Gönderimi kontrol etme ve hatayı yorumlama
- Ürün sayfası, sepete ekleme ve ödeme tamamlanma noktalarında hangi olayın çalışacağını belirleyin. Aynı kullanıcı eyleminde aynı olayı birden fazla kez tetiklemeyin.
- Her olayın
itemsdeğerini dizi olarak oluşturun ve her ürün için en azitem_idveyaitem_namegönderin. - Ürün kimliği, ad, fiyat ve adet değerlerinin sunucudaki sepet veya sipariş verisiyle eşleştiğini kontrol edin.
- Önce etiket veya GTM önizlemesinde gönderilen olay nesnesini inceleyin: ürün alanları items içindeki nesnelerde, currency/value olay seviyesinde olmalıdır. DebugView’ın e-ticaret/ürün gösterimi ve ağ isteği bu incelemeyi tamamlar; arayüzün birebir JavaScript nesne ağacı göstermesini beklemeyin.
- Ürün görünmüyor veya ürün raporları boş kalıyorsa önce olay adını,
itemsdizisinin gerçekten gönderilip gönderilmediğini, kimlik alanının boş olup olmadığını ve olayın tek sefer çalışıp çalışmadığını inceleyin.
Tarayıcı geliştirici araçlarında gönderilen isteği incelemek de yararlıdır. Tarayıcıdaki Google etiketi ürünleri ağ isteğinde kodlanmış alanlarla taşıyabilir; ağ gövdesinde düz bir items JSON dizisi görmemek tek başına hata değildir. Gtag’a verdiğiniz yapı ile taşıma biçimini karıştırmayın. Olay nesnesindeki items gerçekten boşsa verinin hazır olma sırası ve ürün nesnesinin seviyesi incelenmelidir. Satın alma olayını sayfa yenilemesinde yeniden göndermemek için sipariş başarı durumu ve işlem kimliğiyle tekrar tetiklenmeyi engelleyin.
GTM kullanıyorsanız olayın veri katmanından GA4 etiketine nasıl eşlendiğini ayrıca kurun; bu gtag örneklerini mevcut GTM e-ticaret gönderiminin yanına ekleyip aynı olayı iki kez üretmeyin. Özel ürün niteliğini raporlamak için uygun öğe kapsamında özel boyut gerekebilir; parametre göndermek bütün standart raporlara otomatik sütun eklemez.
Sık yapılan hatalar
Ürün alanlarını üst seviyeye koymak:
item_id ve price ürün nesnesinin içinde olmalıdır. Üst seviyede yalnızca olayın genel bilgilerini tutun.Aynı ürüne değişken kimlik vermek: Ürün kimliği sayfa, dil veya kampanya değiştikçe değişirse aynı ürün farklı ürünler gibi raporlanabilir. Katalogdaki kararlı kimliği kullanın.
Fiyatı metin göndermek: Fiyat ve adet gibi sayısal değerleri biçimlendirilmiş metin yerine sayısal veri olarak gönderin. Para birimini ayrıca
currency ile belirtin.Satın almada ürün listesini göndermemek: Yalnızca toplam
value gönderilirse gelir görülebilir; ürün bazlı analiz için satın alma olayında da gerçek items listesi bulunmalıdır.Kaynaklar
Sık sorulan sorular
Bir olayda birden fazla ürün nasıl gönderilir?
items dizisine her ürün için ayrı bir nesne ekleyin. Her nesnede kimlik, fiyat ve adet gibi değerleri o ürüne ait olacak şekilde tutun; toplam value değerini olayın tamamı için hesaplayın.Ürün adını göndermek yeterli midir?
Teknik olarakitem_name kullanılabilir; ancak aynı adın farklı ürünlerde tekrar edilmesi ayrıştırmayı zorlaştırır. Bu nedenle mümkünse benzersiz ve değişmeyen item_id ile birlikte ürün adını da gönderin.Özel ürün alanı eklemek standart raporu bozar mı?
Tek başına bozmaz; fakat özel alan, standartitems yapısının yerine geçmez. Standart raporlama için desteklenen ürün alanlarını kullanın, ek analitik ihtiyaç varsa özel parametreyi ayrıca tanımlayın.