Закрыть

Вход на сайт

Войдите на сайт через аккаунт социальных сетей

  • google_title
  • facebook_title
  • mail_title
  • yandex_title

Войдите на сайт с помощью логина и пароля




Забыли пароль?

Если у Вас нет аккаунта - зарегистрируйтесь

Зарегистрироваться

Данный документ без изменений взят с сайта http://partner.market.yandex.ru/ (компания «Яндекс»)

Технические требования

В соответствии с Общими условиями (http://partner.market.yandex.ru/legal/general/) в настоящем документе определены технические требования к структуре и иным характеристикам, в обязательном порядке предъявляемым к Материалам, размещаемым в базе данных Яндекс.Маркет.

Метод передачи данных

Размещаемые материалы должны быть опубликованы на сайте клиента по URL-адресу, согласованному с компанией «Яндекс», и доступны по протоколам HTTP или FTP. Допускается использование стандартной авторизации для автоматического скачивания файла роботом Яндекс.Маркета, при этом данные для авторизации должны также быть согласованы.

В случае изменения URL-адреса и/или авторизационных данных Клиент должен уведомить об этом Яндекс не менее чем за три рабочих дня до изменения.

Формат данных

Передаваемые данные должны соответствовать спецификации формата YML (см. ниже). Допускается публикация в упакованном виде с помощью алгоритма GNU ZIP (суффикс gz). http://www.gzip.org/

Требования к сайту клиента и ссылкам на страницы сайта

Ссылки на сайт Клиента, публикуемые в составе предложений, должны вести на соответствующие «страницы товара», т.е. на страницы, содержащие описание предлагаемого товара, его цену и кнопку «Купить» или «Заказать». Каждому размещаемому предложению должна соответствовать отдельная страница товара.

Сайт клиента в целом и все страницы товаров должны находиться в рабочем состоянии и быть доступными любому пользователю в течение всего срока размещения предложений о продаже на Яндекс.Маркете.

На страницах товара не должны использоваться элементы, приводящие к открытию дополнительных окон браузера (popup, popunder) или переходу на другую страницу (redirect) без разрешения пользователя.

Описание формата YML

YML (Yandex Market Language) – стандарт, разработанный «Яндексом» для принятия и публикации информации в базе данных Яндекс.Маркет. YML основан на стандарте XML (Extensible Markup Language).

XML документ должен соответствовать следующему формату (DTD):

<!ELEMENT yml_catalog (shop)> 
<!ATTLIST yml_catalog 
date CDATA
#REQUIRED> 
<!ELEMENT shop (name, company, phone?, url,
currencies, categories, deliveryIncluded?, offers)> 
<!ELEMENT company (#PCDATA)> 
<!ELEMENT phone (#PCDATA)> 
<!ELEMENT currencies (currency+)> 
<!ELEMENT currency EMPTY> 
<!ATTLIST currency 
id
(RUR|RUB|USD|DM|EUR) #REQUIRED 
rate CDATA
"1"
plus CDATA
"0"> 
<!ELEMENT categories (category+)> 
<!ELEMENT category (#PCDATA)> 
<!ATTLIST category
id CDATA
#REQUIRED
parentId CDATA
"0"
tid CDATA
#IMPLIED
yid CDATA
#IMPLIED> 
<!ELEMENT offers (offer+)> 
<!ELEMENT offer (url, buyurl?, price, wprice?, 
currencyId, xCategory?, categoryId+,
picture?, deliveryIncluded?,
orderingTime?, 
(
( typePrefix?,
vendor, vendorCode?, model, (provider, tarifplan?)?) 
| (author?, name, publisher?, series?, year?, ISBN?)
| (artist?, title, year?, media?, starring?, director?,
originalName?, country?)
| (worldRegion?, country?, region?,
days, dataTour*, name, hotel_stars?,
included, transport, price_min?, price_max?, options?)
| (name, place, hall?, hall_part?, date, is_premiere?, is_kids?)
| (name, vendor?,vendorCode?)
), 
aliases?, 
additional*, description?, sales_notes?
)> 
<!ATTLIST offer
id CDATA
#IMPLIED 
type (vendor.model
| book | artist.title | tour | ticket | event-ticket) #IMPLIED 
bid CDATA
#IMPLIED
cbid CDATA
#IMPLIED> 
<!ELEMENT url (#PCDATA)> 
<!ELEMENT buyurl (#PCDATA)> 
<!ELEMENT picture (#PCDATA)> 
<!ELEMENT deliveryIncluded EMPTY> 
<!ELEMENT orderingTime (onstock?,
ordering, deliveryTime?)> 
<!ELEMENT onstock EMPTY> 
<!ELEMENT ordering (#PCDATA)> 
<!ATTLIST ordering 
hours CDATA
#IMPLIED>
<!ELEMENT deliveryTime EMPTY> 
<!ELEMENT price (#PCDATA)> 
<!ELEMENT wprice (#PCDATA)> 
<!ELEMENT currencyId (#PCDATA)> 
<!ELEMENT categoryId (#PCDATA)> 
<!ATTLIST categoryId 
type (Yandex | Torg | Own)
"Own" > 
<!ELEMENT typePrefix (#PCDATA)> 
<!ELEMENT vendor (#PCDATA)> 
<!ELEMENT vendorCode (#PCDATA)> 
<!ELEMENT model (#PCDATA)> 
<!ELEMENT author (#PCDATA)> 
<!ELEMENT name (#PCDATA)> 
<!ELEMENT publisher (#PCDATA)> 
<!ELEMENT ISBN (#PCDATA)> 
<!ELEMENT series (#PCDATA)> 
<!ELEMENT year (#PCDATA)> 
<!ELEMENT artist (#PCDATA)> 
<!ELEMENT title (#PCDATA)> 
<!ELEMENT media (#PCDATA)> 
<!ELEMENT starring (#PCDATA)> 
<!ELEMENT director (#PCDATA)> 
<!ELEMENT originalName (#PCDATA)> 
<!ELEMENT country (#PCDATA)> 
<!ELEMENT description (#PCDATA)> 
<!ELEMENT sales_notes (#PCDATA)> 
<!ELEMENT aliases (#PCDATA)> 
<!ELEMENT provider (#PCDATA)> 
<!ELEMENT tarifplan (#PCDATA)> 
<!ELEMENT xCategory (#PCDATA)> 
<!ELEMENT additional (#PCDATA)> 
<!ELEMENT worldRegion (#PCDATA)> 
<!ELEMENT region (#PCDATA)> 
<!ELEMENT days (#PCDATA)> 
<!ELEMENT dataTour (#PCDATA)> 
<!ELEMENT hotel_stars (#PCDATA)> 
<!ELEMENT included (#PCDATA)> 
<!ELEMENT transport (#PCDATA)> 
<!ELEMENT price_min (#PCDATA)> 
<!ELEMENT price_max (#PCDATA)> 
<!ELEMENT options (#PCDATA)> 
<!ELEMENT place (#PCDATA)> 
<!ELEMENT hall (#PCDATA)> 
<!ATTLIST hall 
plan CDATA
#IMPLIED>
<!ELEMENT hall_part (#PCDATA)> 
<!ELEMENT is_premiere (#PCDATA)> 
<!ELEMENT is_kids (#PCDATA)> 
<!ELEMENT date (#PCDATA)> 

Общие замечания по формату (необходимо учитывать при создании файлов в стандарте YML)

Стандарт XML учитывает порядок следования элементов, поэтому важно соблюдать его в соответствии с прилагаемым DTD (см. приложение) или примерами, приведенными ниже.

Стандарт XML не допускает появления символов с ASCII-кодами в диапазоне значений от 0 до 31 (за исключением значений 9, 10, 13 – табуляция, перевод строки, возврат каретки) в текстовых полях. Также этот стандарт строго требует заменять в тексте все следующие символы.

Условия замены в текстовых полях

Текст

Замена

"

&quot;

&

&amp;

>

&gt;

<

&lt;

'

&apos;

Описание формата полного списка товаров

Заголовок документа (XML header)

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE yml_catalog SYSTEM "shops.dtd">

Стандартный XML-заголовок со ссылкой на файл описания формата (DTD). Заголовок должен начинаться с первой строки, с нулевого символа. Путь к shops.dtd прописывать не нужно, так как этот файл расположен на стороне Яндекс.Маркета.

Элемент yml_catalog

<yml_catalog date="2000-11-16 20:17">
...
</yml_catalog>

Корневой элемент полного списка товаров магазина должен содержать один элемент, выделенный тэгами <shop> … </shop>. Формат даты YYYY-MM-DD HH:mm. Дата и время, указанные в файле, должны соответствовать дате и времени сгенерированного на стороне магазина файла.

Элемент shop

<shop>
<name>BestShop</name>
<company>Best online seller Inc.</company>
<url>http://best.seller.ru/</url>
<currencies> … </currencies>
<categories> … </categories>
<offers> … </offers>
</shop>

Описание магазина и товаров магазина включает в себя следующие поля:

Поле

Описание

name

короткое название магазина. (То, которое выводится в списке найденных на Яндекс.Маркете товаров. Не более 20 символов). Здесь не должны использоваться слова, не имеющие отношения к наименованию магазина (лучший, дешевый, номер телефона и т.д.)

company

полное наименование компании, владеющей магазином. Не публикуется, используется для внутренней идентификации.

url

url-адрес первой страницы магазина

Элемент currencies

<currencies>
<currency id="RUR" rate="1"/>
<currency id="USD" rate="31.5"/>
<currency id="EUR" rate="30.4"/>
…
</currencies>

Список курсов валют магазина. Параметр id обозначает код валюты, а параметр – курс валюты к рублю. В случае, если параметр rate, описанный в этом элементе, имеет значение ‘CBRF’, то Яндекс.Маркет будет воспринимать курс валюты магазина как курс ЦБ РФ.

<currencies>
<currency id="RUR" rate="1"/>
<currency id="USD" rate="CBRF"/>
<currency id="EUR" rate="CBRF"/>
…
</currencies>

или ЦБ РФ + %

<currencies>
<currency id="RUR" rate="1"/>
<currency id="USD" rate="CBRF" plus="3"/>
<currency id="EUR" rate="CBRF" plus="3"/>
…
</currencies>

(в таком случае Яндекс.Маркет будет пересчитывать по курсу ЦБ РФ +3%, для каждой из валют)

Внимание! В качестве разделителя целой и дробной частей стоимости независимо от региональных установок используется точка (не запятая!).

Элемент categories

<categories>
<category id="1">Книги</category>
<category id="2">Видео</category>
<category id="3" parentId="1">Детективы</category>
<category id="4" parentId="1">Боевики</category>
<category id="5" parentId="2">Комедии</category>
<category id="6">Принтеры</category>
<category id="7">Оргтехника</category>
</categories>

Список категорий магазина. Описание категории должно включать ее идентификатор (параметр id) для всех категорий и идентификатор категории более высокого уровня для подкатегорий. Идентификатор категории должен быть уникальным положительным целым числом. Ни у одной категории параметр id не может быть равен «0». Если элемент parentId не указан, то категория считается корневой.

Параметры:

id – идентификатор Вашей категории товаров

parentId – идентификатор предыдущей по иерархии категории товаров

Элемент offers

<offers>
<offer>…</offer>
…
</offers>

Список товарных предложений магазинов. Содержит элементы типа offer.

Описание элемента offer

Ниже приведены несколько примеров.

Описание товарного предложения через «vendor.model» (наиболее удобный вариант с точки зрения Яндекс.Маркета)

<offer id="12341" type="vendor.model">
<url>http://best.seller.ru/product_page.asp?pid=12344</url>
<price>1500</price>
<currencyId>USD</currencyId>
<categoryId>6</categoryId>
<picture>http://best.seller.ru/img/device12345.jpg</picture>
<orderingTime>
<ordering>В наличии</ordering>
</orderingTime>
<typePrefix>Принтер</typePrefix>
<vendor>HP</vendor>
<vendorCode>Q1861A<vendorCode>
<model>Laser Jet 5100</model>
<description>
Принтер. Формат А4, А3. Технология печати: лазерная. Процессор: 300 МГц.
Память: 32 Мб. Разрешение при печати: 1200х1200 т/д. Скорость печати: А3 11
стр./мин., А4 22 стр./мин. Плотность бумаги: 60-199 г/м2. Нагрузка до 65000
страниц в месяц. Лоток 1: 100 листов. Лоток 2: 250 листов. Лоток 3: 500 листов.
</description>
</offer>

Описание товарного предложения магазина в результатах поиска:

Компьютеры / Принтеры
Принтер HP Laser Jet 5 100
Цены: 56400 р. ($1500) BestShop
Доступность: в наличии
Принтер. Формат А4, А3. Технология печати: лазерная. Процессор: 300 МГц. Память: 32 Мб. Разрешение при печати: 1200х1200 т/д. Скорость печати: А3 11 стр./мин., А4 22 стр./мин. Плотность бумаги: 60-199 г/м2. Нагрузка до 65000 страниц в месяц. Лоток 1: 100 листов. Лоток 2: 250 листов. Лоток 3: 500 листов.

Наиболее простое описание при поиске:

<offer id=”12346”>
<url>http://best.seller.ru/product_page.asp?pid=12348</url>
<price>210.54</price>
<currencyId>EUR</currencyId>
<categoryId>6</categoryId>
<picture>http://best.seller.ru/img/device12345.jpg</picture>
<orderingTime>
<ordering>В наличии</ordering>
</orderingTime>
<name>Принтер HP Laser Jet 1100</name>
<vendorCode>Q1861A<vendorCode>
<description>Лазерный принтер, А4, 8 стр. в минуту, разрешение 600х600</description>
</offer>

Описание товарного предложения магазина в результатах поиска:

Компьютеры / Принтеры
Принтер HP Laser Jet 5 100
Цены: 56400 р. ($1500) BestShop
Доступность: в наличии
Принтер. Формат А4, А3. Технология печати: лазерная. Процессор: 300 МГц. Память: 32 Мб. Разрешение при печати: 1200х1200 т/д. Скорость печати: А3 11 стр./мин., А4 22 стр./мин. Плотность бумаги: 60-199 г/м2. Нагрузка до 65000 страниц в месяц. Лоток 1: 100 листов. Лоток 2: 250 листов. Лоток 3: 500 листов.

Описание тэгов, входящих в элемент <offer>

Тэги

Описание

url

URL-адрес страницы товара

price

цена, по которой данный товар можно приобрести

currencyId

идентификатор валюты товара (RUR,USD,…)

categoryId

идентификатор категории товара (целое число не более 18 знаков). Товарное предложение может принадлежать только одной категории

picture

ссылка на картинку соответствующего товарного предложения. Недопустимо давать ссылку на «заглушку», т.е. на картинку где написано «картинка отсутствует» или на логотип магазина

typePrefix

Группа товаров \ категория

vendor

Производитель

model

Модель

name

наименование товарного предложения

description

описание товарного предложения

vendorCode

код товара (указывается, как правило, код производителя)

orderingTime

статус товара

ordering

состояние заказа («в наличии», «под заказ», «срок формирования заказа»). ordering является тэгом, обозначающим доступность товара на складе магазина. Этот тэг не должен отображать информацию о доставке.

В YML существуют еще несколько типов описаний предложений товаров: <vendor>, <model>, <book>, <artist> и <tour>. В зависимости от типа описания используется соответствующие поля, согласно прилагаемой схемой DTD (см. приложение).

Представление товарных предложений типа «книги» и «медиапродукция», описание которых может быть произведено посредством специализированных элементов:

Книги

<offer id="12342" type="book">
<url>http://best.seller.ru/product_page.asp?pid=14345</url>
<price>65</price>
<currencyId>RUR</currencyId>
<categoryId>3</categoryId>
<picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
<orderingTime>
<ordering>в наличии</ordering>
</orderingTime>
<author>Александра Маринина</author>
<name>Мужские игры</name>
<publisher>ЭКСМО - Пресс</publisher>
<series>Детектив глазами женщины</series>
<year>1999</year>
<ISBN>32142143214</ISBN>
<description>
Кажется, невозможно подобрать ключ к новому, запутанному делу,
что предстоит расследовать сотруднику уголовного розыска Анастасии Каменской.
Крупный мафиози Эдуард Денисов дает сотруднику уголовного розыска Насте
Каменской нить к разгадке преступлений.
</description>
</offer>

Описание товарного предложения магазина в результатах поиска:

Книги / Художественная литература / Детективы
Александра Маринина «Мужские Игры»
Цены: 65 р. BestShop
Доступность: в наличии
Доставка: Россия
Издательство: ЭКСМО-Пресс
Серия: Детектив глазами женщины
Год издания: 1999
ISBN: 32142143214
Автор: Александра Маринина
Кажется, невозможно подобрать ключ к новому, запутанному делу, что предстоит расследовать сотруднику уголовного розыска Анастасии Каменской. Крупный мафиози Эдуард Денисов дает сотруднику уголовного розыска Насте Каменской нить к разгадке преступлений.

Тэг

Описание

author

автор произведения

name

наименование произведения

publisher

издательство

series

серия

year

год издания

ISBN

код книги

Описание музыкальной продукции

<offer id="12345" type="artist.title">
<url>http://best.seller.ru/product_page.asp?pid=12946</url>
<price>150</price>
<currencyId>USD</currencyId>
<categoryId>2</categoryId>
<picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
<artist>Pink Floyd</artist>
<title>Dark Side Of The Moon, Platinum Disc</title>
<year>1999<year>
<media>CD</media>
</offer>

В результатах поиска:

Музыка
Pink Floyd «Dark Side Of The Moon, Platinum Disc»
Цены: 150 р. ($150) BestShop
Доступность: в наличии
Доставка: Россия
Год издания: 1999
Носитель: CD

Тэг

Описание

artist

исполнитель

title

наименование

media

носитель

Описание видео продукции:

<offer id="12344" type="artist.title">
<url>http://best.seller.ru/product_page.asp?pid=92347</url>
<price>93</price>
<currencyId>RUR</currencyId>
<categoryId>2</categoryId>
<picture>http://best.seller.ru/img/device92347.jpg</picture>
<title>Свадьба Мюриэл</title>
<year>1999<year>
<media>DVD<media>
<starring>Тони Колетт (Toni Collette), Рэйчел Грифитс (Rachel Griffiths)</starring>
<director>П Дж Хоген</director>
<originalName>Muriel's wedding</originalName>
<country>Австралия</country>
<description> 
&quot;Гадкий утенок&quot; из провинциального городка покидает свое гнездо, и в
компании своей подруги отправляется искать веселой жизни в большой и загадочный
город. Фильм о мечтах и реальности, дружбе и юности молодой девушки,
приключения которой повторяют судьбы Золушки и героини Джулии Робертс из
ставшего классикой фильма &quot;Красотка&quot;...
</description>
</offer>

В результатах поиска:

Фильмы
Свадьба Мюриэл
Цены: 93 р. BestShop
Доступность: в наличии
Доставка: Россия
Носитель: DVD
Год издания: 1999
Режиссер: П. Д. Хоган
Страна: Австралия
Оригинальное название: Muriel's Wedding
Главные роли: Тони Колетт (Toni Collette), Рэйчел Грифитс (Rachel Griffiths)
«Гадкий утенок» из провинциального городка покидает свое гнездо, и в компании своей подруги отправляется искать веселой жизни в большой и загадочный город. Фильм о мечтах и реальности, дружбе и юности молодой девушки, приключения которой повторяют судьбы Золушки и героини Джулии Робертс из ставшего классикой фильма «Красотка»…

Тэг

Описание

title

название фильма

starring

актеры

director

режиссер

originalName

оригинальное наименование

country

страна

year

год

media

носитель

Яндекс оставляет за собой право поменять вид выдачи предложений, поэтому не гарантирует показ предложений в том виде, в котором они представлены в примерах.

Тэг picture

Для каждого товарного предложения в элементе <offer> можно указать URL-адрес картинки, соответствующей данному товарному предложению.

Пример:<picture>http://best.seller.ru/img/device12345.jpg</picture>

По указанному URL-адресу должна отдаваться картинка формата jpeg, gif или png не меньше чем 100х100. Картинки большего размера будут уменьшены автоматически. Ссылка на HTML с картинкой не допустима.

Для того чтобы рядом с товарным предложением показывалось изображение этого товара, необходимо чтобы на вашем сервере в файле robots.txt изображения были открыты для индексирования.

Правила индексации в поисковой системе «Яндекс» можно посмотреть по ссылке:

http://www.yandex.ru/info/webmaster2.html

Тэги description и name

В полях <description> или <name>, допускается вводить текст длиною не более 255 символов. Если длина описания выходит за пределы допустимого значения, то текст обрезается и в конце проставляется многоточие.

Условия отключения сайта от базы данных Яндекс.Маркет

Интернет-магазин отключается от базы данных Яндекс.Маркет при несоблюдении вышеизложенных требований и условий, описанных в договоре.