|
Данный документ без изменений взят с сайта 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) без разрешения пользователя. Описание формата YMLYML (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 – табуляция, перевод строки, возврат каретки) в текстовых полях. Также этот стандарт строго требует заменять в тексте все следующие символы. Условия замены в текстовых полях
Описание формата полного списка товаровЗаголовок документа (XML header)<?xml version="1.0" encoding="windows-1251"?> <!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> Описание магазина и товаров магазина включает в себя следующие поля:
Элемент 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>
В 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 Автор: Александра Маринина
Кажется, невозможно подобрать
ключ к новому, запутанному делу, что предстоит расследовать сотруднику
уголовного розыска Анастасии Каменской. Крупный мафиози Эдуард Денисов дает
сотруднику уголовного розыска Насте Каменской нить к разгадке преступлений.
Описание музыкальной продукции <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
Описание видео продукции: <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> "Гадкий утенок" из провинциального городка покидает свое гнездо, и в компании своей подруги отправляется искать веселой жизни в большой и загадочный город. Фильм о мечтах и реальности, дружбе и юности молодой девушки, приключения которой повторяют судьбы Золушки и героини Джулии Робертс из ставшего классикой фильма "Красотка"... </description> </offer> В результатах поиска:
Фильмы
Свадьба Мюриэл
Цены: 93 р. BestShop Доступность: в наличии Доставка: Россия Носитель: DVD Год издания: 1999 Режиссер: П. Д. Хоган Страна: Австралия Оригинальное название: Muriel's Wedding Главные роли: Тони Колетт (Toni Collette), Рэйчел Грифитс (Rachel Griffiths)
«Гадкий утенок» из
провинциального городка покидает свое гнездо, и в компании своей подруги
отправляется искать веселой жизни в большой и загадочный город. Фильм о мечтах
и реальности, дружбе и юности молодой девушки, приключения которой повторяют
судьбы Золушки и героини Джулии Робертс из ставшего классикой фильма
«Красотка»…
Яндекс оставляет за собой право поменять вид выдачи предложений, поэтому не гарантирует показ предложений в том виде, в котором они представлены в примерах. Тэг 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 символов. Если длина описания выходит за пределы допустимого значения, то текст обрезается и в конце проставляется многоточие. Условия отключения сайта от базы данных Яндекс.МаркетИнтернет-магазин отключается от базы данных Яндекс.Маркет при несоблюдении вышеизложенных требований и условий, описанных в договоре. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|