Метод передачі даних
формат даних
Передані дані повинні відповідати специфікації формату YML (див. Нижче). Допускається публікація в упакованому вигляді за допомогою алгоритму стиснення GNU ZIP (суфікс gz) або упакованих алгоритмом ZIP, проте підтримка цього алгоритму (ZIP) Яндексом може бути скасована в будь-який час. Найменування архіву не повинно називатися «yandex», а також не рекомендується використовувати заголовні букви.
Посилання на сайт Клієнта, що публікуються в складі пропозицій, повинні вести на відповідні "сторінки товару", тобто на сторінки, що містять опис пропонованого товару, його ціну і кнопку "Купити" або "Замовити". Кожному размещаемому пропозицією повинна відповідати окрема сторінка товару.
Сайт Клієнта в цілому і всі сторінки товарів повинні знаходитися в робочому стані і бути доступними будь-якому користувачеві протягом всього терміну розміщення пропозицій про продаж на Яндекс.Маркеті.
На сторінках товару не повинні використовуватися елементи, що призводять до відкриття додаткових вікон браузера (popup, popunder) або переходу на іншу сторінку (redirect) без дозволу користувача.
Опис формату YML
XML документ повинен відповідати наступним формату (DTD):
Загальні зауваження щодо формату, які необхідно враховувати при створенні файлів в стандарті YML
Стандарт XML враховує порядок проходження елементів, тому важливо дотримуватися його відповідно до прикладеним DTD (див. Додаток) або прикладами, наведеними нижче.
Стандарт XML не допускає використання в текстових даних недрукованих символів з ASCII-кодами в діапазоні значень від 0 до 31 (за винятком символів з кодами 9, 10, 13 - табуляція, переклад рядка, повернення каретки). Також цей стандарт вимагає обов'язкової заміни деяких символів (див. Таблицю) на еквівалентні їм символьні примітиви.
Умови заміни в текстових полях
Опис формату повного списку товарів
Заголовок документа (XML header)
Стандартний XML-заголовок з посиланням на файл опису формату (DTD). Заголовок повинен починатися з першого рядка, з нульового символу.
Другий рядок заголовка XML-документа визначає посилання на файл опису формату даних (DTD). Зараз досить лише вказати тільки ім'я файлу shops.dtd. Точний шлях до цього файлу вказувати не треба, так як він розташований на стороні Яндекс.Маркет.
елемент yml_catalog
Будь-XML-документ може містити тільки один кореневий елемент. Формат YML як кореневий використовує елемент yml_catalog. Атрибут date елемента yml_catalog повинен відповідати даті і часу генерації XML-файла на стороні магазину. Дата повинна мати формат YYYY-MM-DD HH: mm.
елемент shop
В елементі shop міститься опис магазину і товарів магазину. Магазин описується наступними полями:
Повне найменування компанії, що володіє магазином. Не публікується, використовується для внутрішньої ідентифікації.
елемент currencies
Елемент currencies задає список курсів валют магазину. Кожна з валют описується окремим елементом currency. Параметр id елемента currency вказує код валюти, а параметр rate - курс валюти до рубля. Якщо параметр rate, описаний в цьому елементі, має значення 'CBRF', то Яндекс.Маркет буде сприймати курс валюти магазину як курс ЦБ РФ.
приклади:
Курс USD і EUR відповідають курсу ЦБ РФ:
курс USD відповідає курсу ЦБ РФ + 3%:
Увага! Як роздільник цілої та дробової частин будь-яких чисел в YML, незалежно від регіональних установок, використовується точка (НЕ кому!). При занадто значному (більше 30%) відміну значення курсу валюти від курсу ЦБ РФ інформаційні матеріали вважаються валідними.
елемент categories
елемент offers
В елементі offers міститься список товарних пропозицій магазинів. Кожне товарна пропозиція описується окремим елементом offer.
Опис елемента offer
Опис товарної пропозиції може бути представлено різними способами. Нижче наведено кілька прикладів.
Опис товарної пропозиції типу "vendor.model" (найбільш зручний варіант з точки зору Яндекс.Маркет):
Опис товарної пропозиції магазину в результатах пошуку:
Принтер НP Color LaserJet 3000
Ціни: 16800 р. ($ 700) в наявності BestShop
Доставка: Москва 150-450 р. в межах МКАД
Код виробника: Q7533A
Країна виробництва: Японія; Гарантія від виробника; A4, 64Mb, 600x600 dpi. USB 2.0, 29стор / хв ч / б / 15стор / хв кол, лотки на 100л і 250л, щільність до 175г / м, до 60000 стр / місяць
Найбільш простий опис:
Опис товарної пропозиції магазину в результатах пошуку:
Ювелірні вироби / Наручний годинник
Золотий наручний годинник
Ціни: 16800р. ($ 700) в наявності BestShop
Доставка: Самовивіз
Код виробника: A1234567B
Країна виробник: Китай; Витончені золотий годинник.
Опис елементів, що входять в елемент
Елементи, що не були описані в прикладах, є резервними і не обробляються.
Яндекс залишає за собою право змінити вид видачі пропозицій, тому не гарантує показ пропозицій в тому вигляді, в якому вони представлені в прикладах.
елемент picture
Правила індексації в пошуковій системі "Яндекс" можна переглянути за посиланням:
Елементи description і name
елементи
Управління розцінками (ставками) через XML
Для вказівки розцінок (ставок) у YML-файлі використовуються наступні атрибути елемента offer:
bid (Oсновной ставка) - діє для всіх місць пріоритетного розміщення пропозицій, якщо не вказана ставка для окремого місця;
cbid (cтавка для карток) - діє тільки для сторінок "Картка моделі" і "Всі пропозиції моделі".
У наведеному вище прикладі ціна переходу з "Блоку Маркету" на основному пошуку Яндекса буде дорівнює 0.23 у.о. (Bid = "23") і зі сторінки "Усі пропозиції моделі" по 0.43 у.о. (Cbid = "43"). Якщо користувач на сторінці "Всі пропозиції моделі" використовував сортування, відмінну від сортування за замовчуванням, то в цьому випадку ціна переходу дорівнює 0.1 у.о. (Фіксованої вартості розміщення).
Приклади і рекомендації
Для аукціонного розміщення у видачі основного пошуку Яндекса блок offer може виглядати, наприклад, наступним чином (bid = "15" - ставка дорівнює 0.15 у.о.):
Якщо ви хочете використовувати аукціонний розміщення лише в картці моделі, тоді використовуйте параметр cbid:
У наведеному вище прикладі ціна переходу буде 0.25 у.о. (Переходи з карток моделей і сторінки "все пропозиції моделі").
Ще раз звертаємо вашу увагу на те, що значення bid. cbid - це розмір розцінки. Її значення повинно бути цілим позитивним числом. Наприклад 21, або 42, або 65.
Увага: перш ніж відправити в Яндекс.Маркет новий YML-файл з встановленими розмірами ставок, рекомендується перевірити його на валідність в Партнерському інтерфейсі в розділі «Перевірка YML файлу».
Опис товарної пропозиції магазину, показане в прикладі результатів пошуку, описаного в цьому документі, може відрізнятися від реальних результатів пошуку.