Uygulama tanıtımı için YML feed gereksinimler

Her ürünün benzersiz bir tanımlayıcısı olmalıdır.
Farklı feed’lerdeki aynı ürünün tanımlayıcıları aynı olmalıdır (farklı türdeki feed’lerde de). Örneğin, aynı ürün Yandex Market feed’inde ve Google Shopping feed’inde aynı tanımlayıcıya sahip olmalıdır.

YML, Yandex tarafından geliştirilen bir formattır. Herhangi bir XML belgesi yalnızca bir kök öge içerebilir. YML formatı, kök olarak <yml_catalog> ögesini kullanır. <yml_catalog> öğesinin date niteliği, müşteri tarafında YML dosyasının oluşturulma tarih ve saatine uygun olmalıdır. Tarih formatı YYYY-AA-GG sasa:dkdk olmalıdır.

Ürün teklifleri listesi <offers> ögesinde yer alır. Her ürün teklifi ayrı bir <offer> unsuruyla tanımlanır. <currencies> ve <categories> unsurlarının <shop> (unsurundaki) ürün teklifleri listesinden önce belirtilmesi gerekir. <shop> içine dahil olan öğeler hakkında daha fazla bilgi Yandex Market Yardım’da.

Teklif açıklama türleri

Teklif açıklamaları iki türlüdür: basit ve serbest. Teklif açıklama türleri yalnızca ürün adının iletilme şekliyle farklılık gösterir:

Basit türdeki tekliflerde ürün adı tek bir <name> ögesiyle iletilir;
Serbest türdeki tekliflerde ürün adı üç öge ile iletilir: <typePrefix>, <vendor> ve <model>.

Basit ve serbest türler için ögelerin aynı anda kullanıldığı bir kombinasyon türü uygulanabilir. Avantaj: Daha fazla öge ile daha alakalı bir reklam oluşturma.

Basit tür	Serbest tür	Kombinasyon tür
`<name>`Samsung Galaxy S22 Ultra 8/128 GB, mavi`</name>`	`<typePrefix>`Akıllı Telefon`</typePrefix>` `<vendor>`Samsung`</vendor>` `<model>`Galaxy S22 Ultra 8/128 GB, mavi`</model>`	`<name>`Samsung Galaxy S22 Ultra 8/128 GB, mavi`</name>` `<typePrefix>`Akıllı Telefon`</typePrefix>` `<vendor>`Samsung`</vendor>` `<model>`Galaxy S22 Ultra 8/128 GB, mavi`</model>`

Bir feed içinde aynı anda basit ve serbest türde teklifler bulunabilir.

Teklif örnekleri

Basit açıklama türü

Serbest tür açıklaması (vendor.model)

Temel, daha basit açıklama türü.

Örnek:

  <offer id="0123456" available="true">
    <url>https://app.appsflyer.com/com.your.app?advertising_id={google_aid%}&amp;pid=yandexdirect_int&amp;clickid=%{logid}&amp;deep_link_value=yourapp%3A%2F%2Fproduct%2F016116</url>
     <price>1620.00</price>
     <oldprice>1800.00</oldprice>
     <currencyId>RUB</currencyId>
     <categoryId>19</categoryId>
     <picture>https://site.ru/images/1.png</picture>
     <picture>https://site.ru/images/2.png</picture>
     <store>false</store>
     <pickup>true</pickup>
     <delivery>false</delivery>
     <name>ESET NOD32 Platinum Edition antivirüs programı</name>
     <vendor>Eset</vendor>
     <vendorCode>NOD32-ENA-NS(BOX)-2-1</vendorCode>
     <description>ESET NOD32 Platinum Edition antivirüs programı - 2 yıllık lisans NOD32-ENA-NS(BOX)-2-1</description>
     <video>http://89.123.45.678/catalog/video/19/6.MP4</video>
     <sales_notes>Ödeme: Nakit, banka havalesi, banka kartları, kredi</sales_notes>
     <manufacturer_warranty>true</manufacturer_warranty>
     <country_of_origin>Rusya</country_of_origin>
     <age unit="year">18</age>
   </offer>

Bu açıklama türü en uygun ve evrensel olanıdır, çoğu kategori için ürün açıklamaları için önerilir.

Örnek:

  <offer id="1234567" type="vendor.model" available="true">
    <url>https://app.appsflyer.com/com.your.app?advertising_id={google_aid%}&amp;pid=yandexdirect_int&amp;clickid=%{logid}&amp;deep_link_value=yourapp%3A%2F%2Fproduct%2F016116</url>
    <price>889.00</price>
    <oldprice>17000.00</oldprice>
    <currencyId>RUR</currencyId>
    <categoryId>1111</categoryId>
    <picture>https://site.ru/images/1.png</picture>
    <picture>https://site.ru/images/2.png</picture>
    <store>false</store>
    <pickup>false</pickup>
    <delivery>true</delivery>
    <typePrefix>Yazıcı</typePrefix>
    <vendor>НP</vendor>
    <model>Deskjet D2663</model>
    <description>Günlük baskı için güvenilir ve kullanımı kolay bir renkli yazıcıya ihtiyaç duyanlara yönelik yazıcı serisi...</description>
    <sales_notes>Ön ödeme gereklidir.</sales_notes>
    <manufacturer_warranty>true</manufacturer_warranty>
    <country_of_origin>Japonya</country_of_origin>
  </offer>

Öge nitelikleri <offer>

type özniteliği yalnızca bir değere sahip olabilir – “vendor.model”, bu da teklifin serbest türde olduğunu belirtir.

Serbest tür: <offer id="1234567" type="vendor.model" available="true">
Basit tür: <offer id="0123456" available="true">

type özniteliği, Yandex Direct robotunun feed’i yüklerken hangi ögelerin varlığını kontrol edeceğini etkiler:

type özniteliğini iletmiyorsanız – teklif basit türde olur. Robot, <name> ögesinin mevcut olup olmadığını kontrol eder. Bu öge yoksa teklif göz ardı edilir ve ürün için reklam oluşturulmaz.

type özniteliğini iletirsiniz – teklif serbest türde olur. <vendor> ve <model> unsurlarının varlığı zorunludur. Bu ögeler yoksa hata oluşur ve teklif göz ardı edilir, reklamlar oluşturulmaz.

Nitelik	Açıklama	Filtre ayarları için kullanılabilir	Zorunlu öge
`id`	Ürün tanımlayıcısı. Her ürün için tanımlayıcılar benzersiz olmalıdır. `ID` değeri sayısal, alfabetik veya alfanümerik olabilir. Semboller kullanılabilir. Maksimum uzunluk — 100 karakter. Öneri Eğer filtreyi ayarlamayı planlıyorsanız, sadece sayısal değerleri `ID` kullanın. Örnek 18295 1223abc a12b34fq	evet	evet
`type`	Teklif açıklaması türü. Değer `vendor.model.` olmalıdır. Eğer `type` niteliğini aktarıyorsanız, serbest türde bir açıklama türü kullandığınızı belirtirsiniz. Direct, `<vendor>` ve `<model>` ögelerinin var olup olmadığını kontrol eder. Bunlar yoksa teklif göz ardı edilir ve ürün için reklamlar oluşturulmaz.	hayır	serbest açıklama türü için
`available`	Ürünü satın alma imkânı: `true` – ürün stokta var; `false` – ürün stokta yok. Varsayılan olarak, Yandex Direct sistemi, feed’de bulunan tüm ürünlerin stokta olduğunu varsayar. Eğer feed’de stokta olmayan ürünler varsa, her teklif için `available` özniteliğini belirtmek gerekir. Bu sayede reklam oluşturmak için teklifleri filtreleyebilirsiniz. Feed’de belirtilen ürün stok bilgileri, geçiş sayfasındaki ve satın alma sayfalarındaki bilgilerle eşleşmelidir.	evet	Ürün stoku filtresi kullanılıyorsa zorunludur

Şurada yer alan unsurlar: <offer>

Öge

Açıklama

Filtre ayarları için kullanılabilir

Zorunlu öge

name

Ürün veya hizmet adı. Uzunluk — en fazla 56 karakter.

Basitleştirilmiş teklif adında, üretici adı ve kodu, kullanıcı için önemli olan temel özellikler belirtilmelidir.

Ürün adını oluşturmak için evrensel bir formül kullanılabilir: NE + KİM + MODEL ve MODİFİKASYON, burada:

“NE” – ürün kategorisi (türü) veya alt kategorisi;
“KİM” – üretici, marka, ürün markası;
“MODEL” – ürün adı, seri, koleksiyon, ürün kodu;
“MODİFİKASYON” – ürünün en önemli özellikleri.

Yandex Direct’in reklamları doğru bir şekilde oluşturabilmesi için, ürün adı geçiş sayfasında belirtilenle aynı olmalıdır.

Ad, “ücretsiz teslimat” gibi bir reklam metni içermemelidir. Ayrıca, büyük harflerle yazılmamalı ve dikkat çekmek için özel semboller kullanılmamalıdır.

Örnek

<name>Samsung Galaxy S22 Ultra 8/128 GB, mavi</name>
<name>NOW – B-50 vitamin kompleksi, 100 kapsül</name>
<name>Uzun dar kesim siyah triko elbise büstiyer</name>
<name>Loft Sarı kanepe eurobook mekanizmalı Monolit fabrika</name>

evet

Basitleştirilmiş tür için

typePrefix

Ürün türü / kategorisi.

Ürün türünü belirtirken, üreticinin bu ürünü nasıl konumlandırdığına göre hareket edin. Örneğin, “cep telefonu”, “çamaşır makinesi”, “köşe kanepe takımı”. Ürün türü için çok genel bir tanım ve belirsiz kelimeler kullanmayın.

Örnek

Adidas Spor Ayakkabı (VLNEO) V RACER NYLON

<typePrefix>Spor Ayakkabısı</typePrefix>
Apple iPhone 15 Pro 1TB Doğal Titanyum Akıllı Telefon

<typePrefix>Akıllı Telefon</typePrefix>

evet

serbest tür için

vendor

Üretici veya marka (ticari marka). Markanın doğru belirtilmesi, kullanıcıların rahatlığı için önemlidir ve satışların etkinliğine katkıda bulunur.

Kendi üretiminiz olan bir ürünü veya diğer üreticilerin markasız ürünlerini satıyorsanız, yalnızca kendi markanızın adını belirtin.

Örnek

Adidas Spor Ayakkabı (VLNEO) V RACER NYLON

<vendor>Adidas</vendor>
Apple iPhone 15 Pro 1TB Doğal Titanyum Akıllı Telefon

<vendor>Apple</vendor>

evet

serbest tür için

model

Model ve önemli parametreler (örneğin ad, model indeksi, modifikasyon özellikleri vb.).

Örnek

Adidas Spor Ayakkabı (VLNEO) V RACER NYLON

<model>(VLNEO) V RACER NYLON</model>
Apple iPhone 15 Pro 1TB Doğal Titanyum Akıllı Telefon

<model>iPhone 15 Pro 1TB Natural Titanium</model>

evet

serbest tür için

categoryId

Kullanıcı tarafından atanan ürün kategorisi kimliği (en fazla 18 haneli pozitif tam sayı). Ürün teklifi yalnızca bir kategoriye ait olabilir.

Örnek

<categoryId>12345</categoryId>

evet

<offer> ögesi yalnızca bir <categoryId> ögesi içerebilir.

url

“Yeni kullanıcı kazanımı“ hedefli kampanyalar için

Standart bir izleme bağlantısı veya OneLink biçiminde bir izleme bağlantısı. İzleme bağlantısına ertelenmiş derin bağlantı eklerseniz, kullanıcı uygulamayı yükledikten hemen sonra ürün kartına yönlendirilir.
“Yeniden hedefleme“ hedefli kampanyalar için

Derin bağlantılar ve yeniden hedefleme ilişkilendirme desteği içeren izleme bağlantıları ekleyin.

iOS'te derin bağlantıların doğru çalışması için Universal Links teknolojisini destekleyen izleme bağlantılarını kullanmanız gerekir.

Bağlantının maksimum uzunluğu – 2048 karakter.

Kiril alfabesi bağlantılarına izin verilir. (Kiril alfabesi bağlantılarını Punycode ile dönüştürmenizi öneririz.) URL adresi RFC 3986 standardına göre oluşturulur.

Örnek

<url>https://app.appsflyer.com/com.your.app?advertising_id={google_aid}&pid=yandexdirect_int&clickid={logid}&deep_link_value=yourapp%3A%2F%2Fproduct%2F016116<url>

URL’de karakterler nasıl kodlanır?

Metindeki karakter	YML dosyası için kod
`"`	`"`
`&`	`&`
`>`	`>`
`<`	`<`
`'`	`'`

URL boşluk içermemelidir. Bunlar %20 ile dönüştürülmelidir.

evet

picture

Görsel bağlantısı.

Feed’e 5 görsel eklemenizi öneririz. Örneğin, farklı açılardan veya iç mekânlarda. Ürün, görselin toplam alanının en az 2/3’ünü kaplamalıdır.

YAN’da tek ürünlü bir banner, bir döngü formatında gösterilebilir. Eğer formatta sadece bir görsel gösterilebiliyorsa, ilk resim seçilir — ancak bu resmin genişliği ve yüksekliği bloğun boyutlarından büyük veya eşit olmalıdır. İlk resim bu gerekliliklere uymuyorsa, bir sonraki değerlendirilir.

Ürünün, beyaz bir arka plan üzerinde, en az bir piksel beyaz çerçeveli, metin ve parlak yazı tiplerinin olmadığı bir görüntüsünü kullanın. Resim URL’sine http veya https ön ekini ekleyin.

Teknik gereklilikler:

piksel boyutu – her bir kenar için en az 450;
format — JPG, PNG, WebP veya GIF;
maksimum dosya boyutu – 10 MB.

Reklam görselini nasıl değiştirebilirim?

Yandex robotunun reklamlardaki ürün görselini güncellemesi için, feed’deki bağlantıyı değiştirmeniz gerekir. Örneğin:

Mevcut görsel bağlantısı – <picture>https://ikea.ru/images/1.png</picture>
Yeni görsel bağlantısı – <picture>https://ikea.ru/images/1-new.png</picture>

hayır

evet

description

Ürün açıklaması. Uzunluk — en fazla 81 karakter.

Kullanıcının seçim yapmasına yardımcı olan ürünün önemli özelliklerinin ayrıntılı açıklamasını iletin.

Açıklama, “ücretsiz teslimat” gibi reklam metni, mağaza web sitesi bağlantıları, satış bilgileri ve rakipler, diğer ürünler ve aksesuarlar hakkında bilgi içermemelidir.

Örnek

<description>EVS 500 bağımsız yay bloğu bazlı, orta sertlikte tek taraflı yatak. Dolgu malzemeleri: poliüretan köpük ve lateksli Hindistan cevizi lifi. Ölçü: 90x195 cm, yükseklik: 17 cm. Tek yatak yeri için maksimum ağırlık: 100 kg.</description>

evet

sales_notes

Sipariş bilgisi:

Minimum sipariş tutarı, minimum ürün partisi, ön ödeme gerekliliği;
Ödeme seçenekleri, kampanya ve indirim açıklamaları.

Örnek

<sales_notes>Nakit, MIR, Visa / Mastercard, banka havalesi</sales_notes>
<sales_notes>Ön ödeme gereklidir</sales_notes>
<sales_notes>%60’a varan indirimler</sales_notes>

hayır

param

Ürün özellikleri ve parametrelerinin iletimi.

name özniteliğinde parametre adını belirtmek zorunludur.

Direct, sorgu seçerken aşağıdaki 4 tür param ögesini dikkate alır: malzeme, renk, cinsiyet, boyut. Başlıklar ve metinler manuel olarak yönetiliyorsa, param reklamların oluşturulmasını etkilemez. Otomatik oluşturma kullanılıyorsa, teklif unsurlarına dayalı olarak, param dâhil olmak üzere birkaç metin varyasyonu oluşturulur.

Üretici, örneğin mineral purple gibi kendi renk tanımlarını kullanıyorsa, bu rengin genel kabul görmüş adını da iletin.

Örnek

Renk:

<param name="Цвет">gri</param>

<param name="Цвет">grey</param>
Malzeme:

<param name="Материал">alüminyum</param>

<param name="Материал">titanyum</param>
Ölçü (giyim):

<param name="Размер" unit="INT">S</param>

<param name="Размер" unit="RU">40</param>

Ölçü verilirken ölçü tablosunu belirtmek zorunludur: RU, EU, US, INT – uluslararası tanımlar (giyim için: XS, S, M, L, XL, XXL, 2XL vb.; sütyenler için: AA, A, B, C vb.).
Ölçüler:

<param name="Ширина" unit="cm">180</param>

<param name="Глубина" unit="cm">70</param>

<param name="Высота" unit="cm">90</param>

Ürünün boyutları genişlik, derinlik, yükseklik ve çap üzerinden iletilebilir. Bu durumda ölçü birimlerini belirtmek zorunludur: mm, cm, m.
Cinsiyet:

<param name="Пол">kadın</param>

Örneğin:

kadın, kadınlar için

erkek, erkekler için

unisex, erkekler ve kadınlar için

hayır

price

Bu ürünün satın alınabileceği fiyat.

Format: tam veya kesirli sayı.

Tam ve kesirli kısmın ayırıcısı: nokta.

Fiyat sıfıra eşit olmamalı ve uygulamadaki ürün fiyatına uygun olmalıdır.

Örnek

<price>1234</price>
<price>1234.56</price>

evet

oldprice

Ürünün eski fiyatı, yeni fiyattan (price) mutlaka daha yüksek olmalıdır.

Format: tam veya kesirli sayı.

Tam ve kesirli kısmın ayırıcısı: nokta.

Fiyat sıfıra eşit olmamalıdır.

Uygulamada hem eski hem de mevcut fiyat belirtilmelidir.

Reklam, feed’de price ve oldprice etiketleri varsa ve aralarındaki fark %5 veya daha fazla ise indirim gösterebilir.

Örnek

<price>1620</price>

<oldprice>1800</oldprice>
İndirim miktarını göstermiyoruz çünkü price ve oldprice arasındaki fark %5’ten az:

<price>1760</price>

<oldprice>1800</oldprice>

evet

hayır

currencyId

Para birimi kodu.

Desteklenen değerler

RUR, RUB, USD, EUR, UAH, KZT, BYN, GBP, TRY, ALL, AFN, ARS, AWG, AUD, AZN, BBD, BZD, BMD, BOB, BAM, BWP, BGN, BRL, BND, KHR, CAD, KYD, CLP, CNY, COP, CRC, HRK, CUP, CZK, DKK, DOP, XCD, EGP, SVC, FKP, FJD, GHS, GIP, GTQ, GYD, HNL, HKD, HUF, ISK, INR, IDR, IRR, ILS, JMD, JPY, KPW, KRW, KGS, LAK, LBP, LRD, MKD, MYR, MUR, MXN, MNT, MAD, MZN, NAD, NPR, ANG, NZD, NIO, NGN, NOK, OMR, PKR, PAB, PYG, PEN, PHP, PLN, QAR, RON, SHP, SAR, RSD, SCR, SGD, SBD, SOS, ZAR, LKR, SEK, CHF, SRD, SYP, TWD, THB, TTD, AED, UYU, UZS, VEF, VND, YER, MDL, TJS, GEL, AMD, BHD, KWD.

hayır

evet

video

Ürünle ilgili video bağlantısı.

Not

Video http protokolü olan bir yerde barındırılıyorsa, https protokolü olan kaynaklarda gösterilmeyecektir.

Sabit bir kamera ile çekilmiş bir video kullanmak daha iyidir.

İçerik önerileri:

Ürün hakkında, marka hakkında değil.
Aşırı yazı, vinyet, bulanıklık olmadan, videoda bir düğmeye basılabileceği veya sesle etkileşim kurulabileceği yanılsaması yaratmadan.
Videonun ilk karesinde ürünü ve teklifin avantajlarını gösterin.
Videoyu markalayın – videolara şirket logosu ekleyin.

Her ürün için ayrı videolar hazırlayın: böylece başlık ve reklam metniyle uyumlu olacaklardır. Bir ürün için yalnızca bir video olabilir.

Yalnızca YAN'da gösterimler.

Örnek

<video>http://example.ru/catalog/video/19/6.MP4</video>

hayır

vendorCode

Ürün kodu (üretici kodu belirtilir).

Örnek

<vendorCode>A4068LM-12SG</vendorCode>

hayır

market_category

Ürün kategorisi.

evet

hayır

store

Ürünü perakende mağazadan satın alma imkânı:

evet, 1, +, true – ürün perakende mağazadan satın alınabilir;
hayır, 0, −, false – perakende mağazadan satın alma imkânı yok.

evet

hayır

pickup

Teslimat noktalarından kendi kendine teslim alma imkânı:

evet, 1, +, true – ürün kendi kendine teslim alınabilir;
hayır, 0, −, false – elden teslim alma imkânı yok.

evet

hayır

delivery

Ürünün kurye ile teslim edilme imkânı:

evet, 1, +, true – kurye ile teslimat mümkün;
hayır, 0, −, false – ürün kurye ile teslim edilemez.

hayır

manufacturer_warranty

Garanti varlığı:

evet, 1, +, true – ürün resmî garantiye sahiptir;
hayır, 0, −, false – ürün resmî garantiye sahip değildir.

evet

hayır

country_of_origin

Ürünün üretildiği ülke.

Örnek

<country_of_origin>Rusya</country_of_origin>
<country_of_origin>Belarus</country_of_origin>
<country_of_origin>Vietnam</country_of_origin>

hayır

age

Ürünün yaş kategorisi.

Negatif olmayan tam sayı; “+” önekiyle veya onsuz belirtilebilir. “+” kullanılıyorsa, sayıdan önce gelmelidir.

Belirli yaş gruplarına yönelik ürünler için belirtmenizi öneririz.

Örnek

<age>+6</age>
<age>18</age>

evet

hayır

adult

Ürün “yetişkinler için” kategorisine aittir:

evet, 1, +, true – evet;
hayır, 0, −, false – hayır.

evet

hayır

downloadable

Ürünü indirme imkânı:

evet, 1, +, true – ürün indirilebilir;
hayır, 0, −, false – ürün indirilemez.

hayır

custom_label_0
custom_label_1
custom_label_2
custom_label_3
custom_label_4

Özelleştirilmiş ögeler. Rastgele açıklama. Latince ve Kiril alfabesi harfleri, rakamlar. Bir ögenin uzunluğu – 175 karaktere kadar.

Özelleştirilmiş feed unsurları yalnızca filtre oluşturmak için kullanılabilir. Kreatiflerin oluşturulmasını etkilemezler. Filtreler, standart filtrelerin sağlanmadığı belirli parametrelere göre teklifleri segmentlere ayırmak için kullanılır. Örneğin, belirli bir kampanyaya ait ürünler için bir filtre ayarlayabilirsiniz.

evet

hayır

custom_score

Özelleştirilmiş öge. Değer — sıfır veya herhangi bir pozitif tam sayı.

Özelleştirilmiş feed unsurları yalnızca filtre oluşturmak için kullanılabilir. Kreatiflerin oluşturulmasını etkilemezler. Filtreler, standart filtrelerin sağlanmadığı belirli parametrelere göre teklifleri segmentlere ayırmak için kullanılır. Örneğin, teklifin karlılığına göre filtreleyebilirsiniz.

evet

hayır

Başka sorunuz var mı?

Dikkat

Müşteri Hizmetleri uzmanı, siz hangi kullanıcı adından iletişime geçtiyseniz yalnızca o kullanıcı adından başlatılmış olan kampanyalarla ilgili danışmanlık verebilir. Kullanıcı adı, ya.ru’yu komşu tarayıcı sekmesinde açarsanız görülebilir. Uzman, verilerinize yalnızca talebi işlerken erişebilecektir.

QR kodu taratın veya giriş için bağlantıya tıklayın.

Bize ulaşın

Uygulama tanıtımı için YML feed gereksinimler

Başka sorunuz var mı?

Faydalı bağlantılar

Yasal belgeler

Daha fazla bilgi edinin

Yazı yararlı oldu mu?