--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://www.yandex.com/support/metrica/en/ecommerce/data.md - https://www.yandex.com/support/metrica/es/ecommerce/data.md - https://www.yandex.com/support/metrica/pt/ecommerce/data.md - https://www.yandex.com/support/metrica/ru/ecommerce/data.md - https://www.yandex.com/support/metrica/tr/ecommerce/data.md - https://www.yandex.com/support/metrica/zh/ecommerce/data.md title: E-ticaret verilerinin iletimi description: E-ticaret ortamında her bir ürün, üzerinde belirli işlemlerin yapıldığı birer objedir. Bu veriler eylemin kimlik belirleyicisini ve eylemin yapıldığı ürünlerin açıklamalarının listesini içeren JavaScript objeleri olarak aktarılır. --- > **Documentation Index:** Fetch the complete configuration index at https://www.yandex.com/support/metrica/tr/llms.txt # E-ticaret verilerinin iletimi {% note warning %} 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. {% endnote %} ## Veri taşıyıcısı ve Metrica'ya aktarımı hakkında {#about} 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. Ecommerce nesneleri olarak Yandex Metrica’ya veri iletmek için, bunları JavaScript dizisi `window.dataLayer` içinde küresel ad alanında (window) [push](http://www.w3schools.com/jsref/jsref_push.asp) yöntemiyle eklemeniz gerekir. Bu diziye _veri taşıyıcısı_ diyelim. {% note alert %} 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 sonraki sayfa, sayaç kodu verileri Yandex Metrica’ya iletmeden daha önce yüklenebilir. Sonuç olarak, eylem bilgileri kaybolacaktır. {% endnote %} Veri taşıyıcı, global ad alanında bulunmalıdır ve adı sayaç ayarlama veya 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](https://www.yandex.com/support/metrica/tr/code/counter-initialize.md#param-ecommerce) parametresinin değeri `true` ise veri taşıyıcılığının, `window.dataLayer` dizisi tarafından üstlenildiği varsayılır. ```html ... ``` 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. Bu, Google Analytics Enhanced Ecommerce’e veri gönderimini zaten ayarladıysanız, [Global Site Tag](https://developers.google.com/gtagjs/?hl=en) dahil olmak üzere ve Ecommerce’i Yandex Metrica’da etkinleştirdiyseniz, sonuncusu veri toplamaya başlayacaktır. Ayrıca Metrica, E-ticaret (GA4)'ü destekler ve ek bir ayar yapmaya gerek olmadan verileri toplar. {% note alert %} Veri taşıyıcı maksimum 8192 karakter içerebilir. Konteynerde daha fazla veri aktarıyorsanız, siparişi alt numaralarla parçalara ayırmanızı öneririz (örneğin, `order1-1`, `order1-2`, `order1-3`). Bu şekilde Yandex Metrica’da hem siparişler hem de alt siparişler görüntülenecektir. Gerçek sipariş sayısını değerlendirmek için bir JS hedefi belirleyin ve bunu alt siparişlerden biriyle Yandex Metrica’ya gönderin. Bir siparişin alt siparişlere bölünmüş birden fazla konteyneri aktarıldığında, toplam sipariş sayısını hesaplamak için bir hedefe ulaşılacaktır. {% endnote %} E-Ticaret objesinin şekli şöyle görünür: ```javascript window.dataLayer.push({ "ecommerce": { "currencyCode": "RUB", "": { "actionField": , "products": [, , ...] } } }); ``` #| || **Alan** | **Türü** | **Açıklama** || || `ecommerce`[*](*Параметр) | Object | Zorunlu taşıyıcı alan || || `currencyCode` | String | [ISO 4217'ye göre para birimi kodu](https://www.six-group.com/en/products-services/financial-information/data-standards.html#scrollTo=currency-codes) (3 harf). Başka bir para birimi transfer edilirse, ilgili para birimi ve tutar değerleri 0 olarak gönderilecektir || || ``[*](*Параметр) {#action_type} | — | `` yerine konan alan adı, ürün setiyle yapılan eylemin kimlik belirleyicisidir. Olası değerler: - `impressions` – ürün listesinin görüntülenmesi; - `click` – listedeki ürüne tıklama; - `detail` – ürünün görüntülenmesi; - `add` – Ürünün sepete eklenmesi; - `remove` – Ürünün sepetten çıkarılması; - `purchase` – Satın alma; - `promoView` – dahili reklamı görüntülemei; - `promoClick` – iç reklama tıklama. Ü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). Eğer bununla bereaber ürünün fiyatı da aktarılmışsa, bu durumda raporda aynı şekilde negatif bir sayıyla yansıtılır || || `actionField`[**](*Обязательный_параметр) | Object | [actionField](#action_data) şeklindeki obje. Yapılan eylemi açıklayan ek veriler. Eylem sadece — [satın alma](#purchase) (`` — `purchase`) ise işlenir. || || `products`[*](*Параметр) | Array | Belirtilen eylemin yapıldığı ürünlerin açıklama listesi. Ürün açıklamaları, [productFieldObject](#product_data) şeklindeki objelerdir `promoClick`, `promoView` ve `impressions` eylemleri için kullanılmıyor. || || `promotions`[*](*Параметр) | Array | Belirtilen eylemin gerçekleştirildiği reklam kampanyası açıklamalarının listesi. Reklam kampanyalarının açıklamaları [promoFieldObject](#promo_data) türünde nesneler olarak sunulmaktadır. || |# * Bu parametre zorunludur ** Satın alma ile ilgili bilgileri iletmek için zorunlu parametre. ### Ürün hakkındaki veriler {#product_data} Belirli bir ürünün özelliklerini açıklayan obje. Ürünü açıklayan objenin yapısı **productFieldObject** olarak adlandırılır. #| ### Поля объекта {#product_data} || **Alan** | **Türü** | **Açıklama** || || `id`[*](*Указать) | String | Ürün tanımlayıcısı. Örnek: SKU. **"id" veya "name" belirtilmesi zorunludur** || || `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: / Örneğin, "Giyim / Erkek giyim / Tişörtler" || || `coupon` | String | Ürünle ilgili promosyon kodu. Örnek: "PARTNER_SITE_15" || || `discount` | Number | Ürünün indirim oranı (sayı olarak belirtilir). || || `list` | String | Ürünün ait olduğu liste. Kullanıcının ürünle etkileşiminin farklı aşamalarında listenin etkinliğini değerlendirmek için, ürün listesini görüntülemeden sonraki tüm olaylarda ürün listesini belirtmenizi öneririz. || || `position` | Integer | Ürünün listedeki konumu. Ö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 {#action_data} Ürünle veya ürün setiyle yapılan eylemler hakkında veriler içeren obje. Eylem sadece satın alma ise (`` — `purchase`) desteklenir. Eylemi açıklayan objenin yapısı **actionField** olarak adlandırılır. Eylemle ilgili veriler aktarıldığında Yandex Metrica bir hedef oluşturur. Bu hedef, Yandex Direct 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.: )”. [goal_id](#goal_id) alanını aktarmak suretiyle hedefe ulaşmayı kendiniz de takip edebilirsiniz. #| ### Поля объекта {#action_data} || **Alan** | **Türü** | **Açıklama** || || `id`[*](*Поле) | String | Satın alma işlemi tanımlayıcısı. 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` {#goal_id} | Integer | [Hedef](https://www.yandex.com/support/metrica/tr/general/goals.md) numarasıdır. Söz konusu [eylem](#action_type) hedeflenen bir eylem olduğu takdirde belirtilir. Hedef, [JavaScript eylemi](https://www.yandex.com/support/metrica/tr/general/goals.md) 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. ![](../_assets/order-ecommerce.png){.border-yes} || || `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. || |# ### Promosyon kampanyaları hakkında veriler {#promo_data} Promosyon kampanyalarını tanımlayan nesne. Konteyner aynı fakat **productFieldObject** yerine **promoFieldObject** yazılır. #| ### Поля объекта {#promo_data} || **Alan** | **Türü** | **Açıklama** || || `id`[*](*Поле) | String | Promosyon kampanyasının kimliği. **Alanın doldurulması zorunludur** || || `name` | String | Promosyon kampanyasının adı || || `creative` | String | Reklam bannerinin adı || || `creative_slot` | String | Reklam bannerinin slotu || || `position` | String | Reklam banneri pozisyonu || |# ## Örnekler {#examples} Bilgileri iletmek için yukarıda açıklanan biçimde sitede belirli bir eylemden (örneğin, sipariş oluşturma) sorumlu olacak bir komut dosyası oluşturmanız gerekir. Aşağıda Metrica destekli eylemler için örnek komut dosyaları bulunmaktadır. Örneklerde [sayacın e-ticaret bağlantısı ile başlatıldığı](https://www.yandex.com/support/metrica/tr/data/e-commerce.md) ve veri aktarımının [window.dataLayer taşıyıcısı](#about) üzerinden yapıldığı varsayılır. ### Ürün listesini görüntüleme {#product-list} Veriler, ürün listesinin açılması anında gönderilmelidir. ```javascript dataLayer.push({ "ecommerce": { "currencyCode": "RUB", "impressions": [ { "id": "P15432", "name": "Tişört", "price": 477.60, "brand": "Yandex / Яndex", "category": "Giyim / Erkek giyim / Tişörtler", "variant": "Kırmızı renk", "list": "Search", "position": 1 }, { "id": "P15435", "name": "Tişört", "price": 500.60, "brand": "Yandex / Яndex", "category": "Giyim / Erkek giyim / Tişörtler", "variant": "Lacivert renk", "list": "Search", "position": 2 } ] } }); ``` ### Listeden ürüne tıklama {#click-on-product} Veriler, kullanıcı ürün bağlantısına tıkladığında iletilmelidir. ```javascript dataLayer.push({ "ecommerce": { "currencyCode": "RUB", "click": { "products": [ { "id": "39084", "name": "Yandex termos bardak", "price": 1089.69, "brand": "Yandex / Яndex", "category": "Ev ürünleri / Züccaciye / Termoslar ve termos bardaklar", "variant": "Kırmızı renk", "list": "Search", "position": 1 } ] } } }); ``` ### Ürün görüntüleme {#product-detail} Veriler, ürün kartı sayfası açıldığı anda gönderilmelidir. ```javascript dataLayer.push({ "ecommerce": { "currencyCode": "RUB", "detail": { "products": [ { "id": "P15432", "name": "Tişört", "price": 477.60, "brand": "Yandex / Яndex", "category": "Giyim / Erkek giyim / Tişörtler", "variant": "Kırmızı renk", "list": "Arama sonuçları", "position": 1 } ] } } }); ``` ### Ürünü sepete koyma {#add} Sipariş sepete eklendiğinde veriler gönderilmelidir. Örneğin, “Sepete ekle” butonuna tıklandığında. ```javascript dataLayer.push({ "ecommerce": { "currencyCode": "RUB", "add": { "products": [ { "id": "43521", "name": "Yandex çanta", "price": 654.32, "brand": "Yandex / Яndex", "category": "Aksesuarlar / Çantalar", "quantity": 1, "list": "Kategori sonuçları", "position": 2 } ] } } }); ``` ### Ürünü sepetten çıkarma {#remove} Sipariş sepetten çıkarıldığı anda veriler gönderilmelidir. ```javascript dataLayer.push({ "ecommerce": { "currencyCode": "RUB", "remove": { "products": [ { "id": "15243", "name": "Telefon ekran silme seti – Yandex", "category": "Cep telefonu aksesuarları", "quantity": 1, "list": "Aksesuarlar", "position": 3 } ] } } }); ``` ### Satın alma {#purchase} Sipariş onaylandığı anda veriler gönderilmelidir. ```javascript dataLayer.push({ "ecommerce": { "currencyCode": "RUB", "purchase": { "actionField": { "id": "TRX987" }, "products": [ { "id": "25341", "name": "Yandex erkek sweatshirt", "price": 1345.26, "brand": "Yandex / Яndex", "category": "Giyim / Erkek giyim / Sweatshirt'ler", "variant": "Turuncu renk", "quantity": 1, "list": "Giyim", "position": 1 }, { "id": "25314", "name": "Yandex kadın sweatshirt", "price": 1543.62, "brand": "Yandex / Яndex", "category": "Giyim / Kadın giyim / Sweatshirt'ler", "variant": "Beyaz renk", "quantity": 3, "list": "Sweatshirt'ler", "position": 2 } ] } } }); ``` ### Dahili reklamı görüntüleme {#adv-view} Veriler, kullanıcı reklam materyallerini görüntülediğinde gönderilmelidir. ```javascript dataLayer.push({ "ecommerce": { "promoView": { "promotions": [ { "id": "BF001", "name": "Efsane Cuma", "creative": "Banner_1", "position": "Slot1" }, { "id": "SUMMER002", "name": "Yaz indirimleri", "creative": "Banner_3", "position": "Slot2" } ] } } }); ``` ### Dahili reklamlara tıklamalar {#adv-click} Veriler, kullanıcı reklam materyali ile tıklama veya başka bir hedef eylem gerçekleştirdiğinde gönderilmelidir. ```javascript dataLayer.push({ "ecommerce": { "promoClick": { "promotions": [ { "id": "BF001", "name": "Efsane Cuma", "creative": "Banner_1", "position": "Slot1" } ] } } }); ``` ### Daha fazla bilgi edinin - [E-ticaret ayarları denetimi](https://www.yandex.com/support/metrica/tr/ecommerce/check.md) - [Sorun çözme](https://www.yandex.com/support/metrica/tr/ecommerce/troubleshooting.md) [Sohbete yaz](https://yandex.com.tr/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}
{% cut "E-posta yaz" %} Lütfen, dikkatli olun: Destek Ekibi kullanıcıları aramaz. Dolayısıyla Yandex Metrica Destek Ekibi adına sizi telefonla arayan yabancıları yok sayın ve talimatlarını kesinlikle izlemeyin.
{% endcut %}
- - -
#| || Faydalı bağlantılar - [Demo sayacı](https://metrica.yandex.com/r/dashboard?) - [Sayaç ekle](https://metrica.yandex.com/add/) - [Ücretsiz sayaç ayarları](https://yandex.com/promo/freeservice/metrica?utm_source=help_metrica_en&utm_medium=cpc&utm_campaign=1) - [Yandex Metrica API'si](https://tech.yandex.com/metrika/) - [Fikir öner](https://yandex.com/support/metrica/troubleshooting/idea.html) - [Telegram sohbeti](https://t.me/yandexmetrika) | Çevrimiçi eğitim - [Yandex Metrica sertifikası al](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links) - [Eğitim kursuna katıl](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links) || |#
[*Параметр]: Bu parametre zorunludur. [*Обязательный_параметр]: Satın alma ile ilgili bilgileri iletmek için zorunlu parametre. [*Указать]: **"id" veya "name" belirtilmesi zorunludur**. [*Поле]: Alanın doldurulması zorunludur.