E-ticaret

İpucu. JavaScript API'siyle çalışmak için HTML ve JavaScript'le çalışma tecrübesine sahip olmak gerekir. Bu konuda tecrübeniz yoksa sitenizin geliştiricisine veya yöneticisine başvurmanızı öneririz.

Yandex.Metrica, e-ticaretle ilgili veri toplamayı ve analiz etmeyi sağlar.

E-ticaretin çalıştırılması

E-ticareti çalıştırmak için:

  1. Ayarlar → Sayaç bölümüne Gelişmiş ayarlar menüsüne girin ve E-Ticaret verilerinin Yandex.Metrica'ya aktarımı seçeneğini etkinleştirin. Böylelikle sayaç koduna, içine verilerin toplanacağı özel bir dataLayer veri taşıyıcısı eklenecek (varsayılan).

  2. Ürün özellikleri, “Sepete koy” butonu gibi, ürünler ve siparişler hakkında bilgi içeren site sayfalarındaki sayaç kodunu güncelleyin veya sayaç kodu eksikse bunu ekleyin.

Veri sunumu ve aktarımı

E-ticaret ortamında her bir ürün, üzerinde belirli işlemlerin yapıldığı birer objedir. Ürünün detaylı açıklamasının görüntülenmesi veya sepete koyulması bu eylemlere örnektir. Bu veriler eylemin kimlik belirleyicisini ve eylemin yapıldığı ürünlerin açıklamalarının listesini içeren JavaScript objeleri olarak aktarılır. JavaScript API'siyle bağlantılı olarak bu tür objelere E-ticaret objeleri diyelim.

Verilerin E-Ticaret objeleri olarak Yandex.Metrica servisine aktarılması için bunları push yöntemiyle özel bir JavaScript dizisine yerleştirmek gerekir. Bu diziye veri taşıyıcısı diyelim.

Uyarı. Ziyaretçinin web sitesinin başka bir sayfasına geçmesi anından itibaren verileri aktarmayın. Örneğin, onclick eyleminin kullanılırken “Sipariş ver” butonunda. Bu durumda, bir sonraki sayfa sayaç kodu Yandex.Metrica'ya verileri aktarmadan önce yüklenebilir. Sonuç olarak, eylem bilgileri kaybolacaktır.

Veri taşıyıcısı, global ad alanında bulunmalı ve adı sayaç başlatma işlemi sırasında belirtilen ad ile aynı olmalıdır. Veri taşıyıcısının adı dataLayer ise ya da çalıştırılan Yandex.Metrica sayacının ecommerce parametresinin değeri true ise veri taşıyıcılığının, window.dataLayer dizisi tarafından üstlenildiği varsayılır.

<script type="text/javascript">
window.dataLayer = window.dataLayer || [];
</script>
...
<script type="text/javascript">
window.dataLayer.push ({...});
</script>

Veri taşıyıcısının ismi ve buna yerleştirilen E-Ticaret objelerinin yapısı, Google Analytics Enhanced Ecommerce'teki benzer varlıklara denk gelir. Böylece Global Site Tag üzerinden de dahil olmak üzere Google Analytics Enhanced Ecommerce'a veri gönderimi ayarlamanın yanı sıra ayrıca Yandex.Metrica'da E-Ticaret özelliğini de çalıştırdıysanız Yandex.Metrica da ilgili veriler toplanmaya başlar.

Not. Veri taşıyıcı maksimum 2048 karakter içerebilir.

E-ticaret objesi şöyle görünür:

window.dataLayer.push({
    "ecommerce": {
        "currencyCode": "RUB",
        "<actionType>" : {
            "actionField" : <actionField>,
            "products" : [<productFieldObject>, <productFieldObject>, ...]
        }
    }
});
Alan Türü Açıklama
ecommerce *

Object

Zorunlu taşıyıcı alan

currencyCode

String

ISO 4217'ye göre para birimi kodu (3 harf).

Bunlardan başka döviz bilgileri aktarıldığında ilgili tutar ve para birimi değerleri 0 olarak aktarılacaktır.

<actionType> *

<actionType> yerine konan alan adı, ürün setiyle yapılan eylemin kimlik belirleyicisidir.

Olası değerler:

  • detail: Ürünün tam açıklamasının (ürün kartının) görüntülenmesi,
  • add: Ürünün sepete eklenmesi,
  • remove: Ürünün sepetten çıkarılması,
  • purchase: Satın alma.

Ürünün sepetten çıkarılması hakkında bilginin Yandex.Metrica'ya gönderilmesi raporda ürün sayısının negatif bir sayıyla ifade edilmesine neden olabilir (hesaplamalar sırasında sepetten çıkarılan ürünlerin sayısı eklenen ürünlerin toplam sayısından çıkarılır). Ürünün aktarılan fiyatı da bu durumda raporda negatif bir sayıyla yansıtılır.

actionField **

Object

< actionField> şeklindeki obje. Yapılan eylemi açıklayan ek veriler.

Eylem sadece satın alma ( <actionType> - purchase) ise işlenir.

products *

Array

Belirtilen eylemin yapıldığı ürünlerin açıklama listesi. Ürün açıklamaları, <productFieldObject> şeklindeki objelerdir

* Bu parametre zorunludur

** Satın alma ile ilgili bilgileri iletmek için zorunlu parametre.

Ürün hakkındaki veriler

Belirli bir ürünün özelliklerini açıklayan obje.

Ürünü açıklayan objenin yapısı <productFieldObject> olarak adlandırılır.

Obje alanları
Alan Türü Açıklama
id *

String

Ürünün kimlik belirleyicisi. Örnek: SKU.

Belirtilmesi zorunlu olan öğe: id veya name

name *

String

Ürün adı. Örnek: "Tişört"

Belirtilmesi zorunlu olan öğe: name veya id

brand

String

Ürünle ilgili bir ticari marka. Örnek: Yandex

category

String

Ürünün ait olduğu kategori

Desteklenen kategoriler hiyerarşisi 5 yuvalanma seviyesine kadardır. Seviye ayırıcısı olarak kullanılan simge: / Örnek: "Giyim/Erkek giyimi/Tişörtler"

coupon

String

Ürünle ilgili promosyon kodu. Örnek: "PARTNER_SITE_15"

position

Number

Ürünün listedeki pozisyonu. Örnek: 2

price

Number

Ürünün birim fiyatı

quantity

Integer

Ürünün birim sayısı

variant

String

Ürün çeşidi. Örnek: "Kırmızı"

Eylem verileri

Ürünle veya ürün setiyle yapılan eylemler hakkında veriler içeren obje.

Eylem sadece satın alma ( <actionType> - purchase) ise işlenir.

Eylemi açıklayan objenin yapısı <productFieldObject> olarak adlandırılır.

Eylemle ilgili veriler aktarıldığında Yandex.Metrica bir hedef oluşturur. Bu hedef, Yandex.Direct reklam kampanyasından elde edilen gelir hakkında bilgi almayı sağlar. Yandex.Direct'teki hedef listesinde böyle bir hedef şu şekilde görünür: “eCommerce: Alım işlemi (Sayaç No.: <Sayaç ID'si>)” goal_id alanını aktarmak suretiyle hedefe ulaşmayı kendiniz de takip edebilirsiniz.

Obje alanları
Alan Türü Açıklama
id *

String

Satın alma işleminin kimlik belirleyicisi.

Alanın doldurulması zorunludur.

Örnek: TRX#54321

coupon

String

Bir bütün olarak satın alma işlemiyle (alınan ürünlerle) ilgili promosyon kodu

goal_id

Integer

Hedef numarasıdır. Söz konusu eylem hedeflenen bir eylem olduğu takdirde belirtilir.

Hedef, JavaScript eylemi türündeki bir koşulla belirlenmelidir.

Hedefin numarasına Yandex.Metrica arayüzünde Ayarlar bölümündeki Hedefler sekmesi üzerinden ulaşabilirsiniz.

revenue

Number

Elde edilen gelir.

Özel olarak belirtilmediği durumlarda işlem çerçevesinde satın alınan tüm ürünlerin fiyat toplamı olarak otomatik hesaplanır.

Örnekler

Tüm örnekler sayacın E-Ticaret çalıştırılmış olarak başlatıldığı ve verilerin window.dataLayer taşıyıcısı üzerinden aktarıldığı varsayımlarıyla verilmektedir.

Ürünün tam açıklamasını görüntüleme

dataLayer.push({    "ecommerce": {        "detail": {            "products": [                {                    "id": "P15432",                    "name" : "Tişört",                    "price": 477.60,                    "brand": "Yandex / Яndex",                    "category": "Giyim/Erkek giyim/Tişörtler",                    "variant" : "Kırmızı"                },                {                    "name": "Yandex rozeti",                    "price": 50,                }            ]        }    }});

Ürünü sepete koyma

dataLayer.push({    "ecommerce": {        "add": {            "products": [                {                    "id": "43521",                    "name": "Yandex çantası",                    "price": 654.32,                    "brand": "Yandex / Яndex",                    "category": "Aksesuarlar/Çantalar",                    "quantity": 2                }            ]        }    }});

Ürünü sepetten çıkarma

dataLayer.push({    "ecommerce": {        "remove": {            "products": [                {                    "id": "15243",                    "name": "Telefon ekranı için Yandex temizleme mendili",                    "category": "Mobil telefon aksesuarları",                    "quantity": 1                }            ]        }    }});

Satın alma

dataLayer.push({    "ecommerce": {        "purchase": {            "actionField": {                "id" : "TRX987"            },            "products": [                {                    "id": "25341",                    "name": "Yandex erkek kazağı",                    "price": 1345.26,                    "brand": "Yandex / Яndex",                    "category": "Giyim/Erkek giyim/Kazaklar",                    "variant": "Turuncu"                },                {                    "id": "25314",                    "name": "Yandex bayan kazağı",                    "price": 1543.62,                    "brand": "Yandex / Яndex",                    "category": "Giyim/Bayan giyim/Kazaklar",                    "variant": "Beyaz",                    "quantity": 3                }            ]        }    }});

Sorun çözme

E-Ticaret aracılığıyla aktarılan bilgiler Yandex.Metrica raporlarında görüntülenmiyorsa aşağıdaki olası nedenlere dikkat edin:

  • Aktarılan alanların içeriğindeki hatalar. Verilerin doğruluğunu kontrol etmek için tarayıcı konsoluna JSON.stringify(dataLayer) komutunu yazın. Kontrol işlemini site yöneticisine veya site desteğinden sorumlu bir uzmana yaptırmanız önerilir.

  • actionField alanındaki veriler aktarılmıyor. Alım bilgilerinin aktarılabilmesi için actionField alanını doldurun.
  • Sayacınızın çalışması Adblock Plus uzantısı tarafından engellenebilir.
  • Ziyaretçi, sayaç yüklenmeden önce site sayfasını terketti.
  • Sayfada döngüsel yönlendirme var.