Требования к методу передачи данных

Данный документ является действующим, если расположен по адресу http://partner.market.yandex.ru/legal/tt/.

Дата публикации: 11.02.2013 г.
Дата вступления в силу: 11.02.2013 г.

Содержание

• Методы передачи данных
• Формат данных
• Требования к сайту клиента и ссылкам на страницы сайта
• Описание формата YML
• Общие замечания по формату, которые необходимо учитывать при создании файлов в стандарте YML
• Условия замены в текстовых полях
• Заголовок документа (XML header)
• Элемент yml_catalog
• Элемент shop
• Элемент currencies
• Элемент categories
• Элемент local_delivery_cost
• Элемент offers
• Описание элементов, входящих в элемент <offer>
• Элемент picture
• Элементы description, name и sales_notes
• Элемент adult
• Элемент barcode
• Элемент param
• Управление расценками (ставками) через XML
• Примеры и рекомендации
• Описание текстового формата с разделителями
• Общие требования к формату
• Описание элементов
• Обязательные элементы
• Необязательные элементы
• Отличия текстового формата с разделителями от YML-формата
• Описание формата Excel
• Общие требования к формату
• Описание элементов
• Обязательные элементы
• Необязательные элементы

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

Для передачи данных о товарных предложениях в Яндекс.Маркет можно воспользоваться двумя методами.

1. Ссылка на прайс-лист

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

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

2. Загрузка через Веб-интерфейс клиента

Размещаемые материалы загружаются на сервер Яндекс.Маркета через Веб-интерфейс клиента. Клиент обязуется загрузить актуальные материалы (товарные предложения) через Веб-интерфейс клиента не позднее 30 календарных дней с даты предыдущей загрузки материалов указанным способом.

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

Передаваемые данные должны соответствовать спецификации формата YML (см. Описание формата YML), текстового формата с разделителями (см. Описание текстового формата с разделителями) или формата Excel (см. Описание формата Excel). Допускается публикация в упакованном виде с помощью алгоритма сжатия GNU ZIP (суффикс gz) или упакованных алгоритмом ZIP, однако поддержка этого алгоритма (ZIP) Яндексом может быть отменена в любое время. Наименование архива не должно называться «yandex», а также не рекомендуется использовать заглавные буквы.

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

Ссылки на сайт Клиента, публикуемые в составе товарных предложений, в рамках которых осуществляется реализация товара дистанционным способом, должны вести на соответствующие "страницы товара", т.е. на страницы, содержащие описание предлагаемого товара, его цену и кнопку "Купить" или "Заказать". Каждому размещаемому предложению, в котором опубликована ссылка на сайт Клиента, должна соответствовать отдельная страница товара.
Пользователь должен иметь возможность сделать заказ через сайт магазина, реализующего указанный в товарном предложении товар дистанционным способом. Об оформлении заказа пользователь должен получить подтверждение от Клиента (посредством телефонного звонка и/или электронной почты) в течение 4 рабочих часов с момента его оформления. Автоматически сформированные подтверждения не учитываются.
Сайт Клиента в целом и все страницы товаров должны находиться в рабочем состоянии и быть доступными любому пользователю в течение всего срока размещения предложений о продаже на Яндекс.Маркете.
На страницах товара не должны использоваться элементы, приводящие к открытию дополнительных окон браузера (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, url, phone?, platform?, version?, agency?, email*, currencies, categories, store?, pickup?, delivery?, deliveryIncluded?, local_delivery_cost?, adult?, offers)>
<!ELEMENT company (#PCDATA)>
<!ELEMENT phone (#PCDATA)>

<!ELEMENT currencies (currency+)>
<!ELEMENT currency EMPTY>
<!ATTLIST currency
    id (RUR|RUB|USD|BYR|KZT|EUR|UAH) #REQUIRED
    rate CDATA "1"
    plus CDATA "0">


<!ELEMENT categories (category+)>
<!ELEMENT category (#PCDATA)>
<!ATTLIST category
    id CDATA #REQUIRED
    parentId CDATA #IMPLIED
    tid CDATA #IMPLIED
    yid CDATA #IMPLIED>

<!ELEMENT offers (offer+)>
<!ELEMENT offer (url?, buyurl?, price, wprice?, currencyId, xCategory?, categoryId+, market_category?,
                 picture*, store?, pickup?, delivery?, deliveryIncluded?, local_delivery_cost?, orderingTime?,
                 ((typePrefix?, vendor, vendorCode?, model, (provider, tarifplan?)?) |
                  (author?, name, publisher?, series?, year?, ISBN?, volume?, part?, language?, binding?, page_extent?, table_of_contents?) |
                  (author?, name, publisher?, series?, year?, ISBN?, volume?, part?, language?, table_of_contents?, performed_by?, performance_type?, storage?, format?, recording_length?) |
                  (artist?, title, year?, media?, starring?, director?, originalName?, country?) |
                  (worldRegion?, country?, region?, days, dataTour*, name, hotel_stars?, room?, meal?, 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?, promo?,
                 manufacturer_warranty?, country_of_origin?, downloadable?, adult?, age?,
                 barcode*,
                 param*,
                 related_offer*
                )>
<!ATTLIST offer
    id CDATA #IMPLIED
    group_id CDATA #IMPLIED
    type (vendor.model | book | audiobook | artist.title | tour | ticket | event-ticket) #IMPLIED
    available (true | false) #IMPLIED
    bid CDATA #IMPLIED
    cbid CDATA #IMPLIED>

<!ELEMENT url (#PCDATA)>
<!ELEMENT store (#PCDATA)>
<!ELEMENT email (#PCDATA)>
<!ELEMENT platform (#PCDATA)>
<!ELEMENT version (#PCDATA)>
<!ELEMENT agency (#PCDATA)>
<!ELEMENT buyurl (#PCDATA)>
<!ELEMENT picture (#PCDATA)>
<!ELEMENT pickup (#PCDATA)>
<!ELEMENT delivery (#PCDATA)>
<!ELEMENT deliveryIncluded EMPTY>
<!ELEMENT local_delivery_cost (#PCDATA)>
<!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 market_category (#PCDATA)>
<!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 volume (#PCDATA)>
<!ELEMENT part (#PCDATA)>
<!ELEMENT language (#PCDATA)>
<!ELEMENT binding (#PCDATA)>
<!ELEMENT page_extent (#PCDATA)>
<!ELEMENT table_of_contents (#PCDATA)>
<!ELEMENT performed_by (#PCDATA)>
<!ELEMENT performance_type (#PCDATA)>
<!ELEMENT storage (#PCDATA)>
<!ELEMENT format (#PCDATA)>
<!ELEMENT recording_length (#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 promo (#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 room (#PCDATA)>
<!ELEMENT meal (#PCDATA)>
<!ELEMENT included (#PCDATA)>
<!ELEMENT transport (#PCDATA)>
<!ELEMENT price_min (#PCDATA)>
<!ELEMENT price_max (#PCDATA)>
<!ELEMENT options (#PCDATA)>
<!ELEMENT manufacturer_warranty (#PCDATA)>
<!ELEMENT country_of_origin (#PCDATA)>
<!ELEMENT downloadable (#PCDATA)>
<!ELEMENT adult (#PCDATA)>
<!ELEMENT age (#PCDATA)>
<!ELEMENT barcode (#PCDATA)>
<!ELEMENT param (#PCDATA)>
<!ATTLIST param
    name CDATA #REQUIRED
    unit CDATA #IMPLIED>
<!ELEMENT related_offer (#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). Заголовок должен начинаться с первой строки, с нулевого символа.

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

Элемент yml_catalog

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

Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент yml_catalog. Атрибут date элемента yml_catalog должен соответствовать дате и времени генерации XML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD HH:mm.

Элемент shop

<shop>
  <name>BestShop</name>
  <company>Best online seller Inc.</company>
  <url>http://best.seller.ru/</url>
  <platform>CMS</platform>
  <version>2.3</version>
  <agency>Agency</agency>
  <email>CMS@CMS.ru</email>

  <currencies> ... </currencies>
  <categories> ... </categories>
  <offers> ... </offers>


</shop>

В элементе shop содержится описание магазина и товаров магазина. Магазин описывается следующими полями:

Элемент currencies

<currencies>
  <currency id="RUR" rate="1"/>

  <currency id="USD" rate="23.98"/>
  <currency id="EUR" rate="36.25"/>
  <currency id="UAH" rate="5.6"/>
  <currency id="KZT" rate="0.19"/>
</currencies>

Элемент currencies задает список курсов валют магазина. Каждая из валют описывается отдельным элементом currency. Параметр id элемента currency указывает код валюты, а параметр rate — курс этой валюты к валюте, взятой за единицу. Параметр rate может иметь так же следующие значения: CBRF, NBU, NBK и CB.

CBRF — курс по Центральному банку РФ.

NBU — курс по Национальному банку Украины.

NBK — курс по Национальному банку Казахстана.

СВ — курс по банку той страны, к которой относится магазин по Своему региону, указанному в Партнерском интерфейсе Яндекс.Маркета.

Данные о ценах принимаются в рублях (RUR, RUB), гривнах (UAH), белорусских рублях (BYR), тенге (KZT), долларах (USD) и евро (EUR). На Яндекс.Маркете цены могут отображаться в рублях, гривнах, белорусских рублях и тенге в зависимости от региона пользователя. Если в вашем YML-файле не задан курс для отображаемой валюты, то используется курс Центрального Банка страны, к которой относится регион пользователя. Применяется курс, установленный на текущий день. Курс обновляется ежедневно в 00.00.

Примеры:
Курс USD и EUR соответствуют курсу ЦБ РФ:

<currencies>

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


</currencies>

курс USD соответствует курсу ЦБ РФ + 3%:

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

Курс USD для Украинского магазина

<currencies>
  <currency id="UAH" rate="1"/>
  <currency id="USD" rate="NBU" plus="1"/>
  <currency id="EUR" rate="NBU" plus="3"/>
  ...
</currencies>

Внимание! В качестве разделителя целой и дробной частей любых чисел в YML, независимо от региональных установок, используется точка (не запятая!). При слишком значительном (больше 30%) отличии значения курса валюты от курса ЦБ РФ или НБУ информационные материалы считаются невалидными.

Элемент 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>

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

Параметры:

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

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

Элемент local_delivery_cost

<local_delivery_cost>300</local_delivery_cost>

Элемент offers

<offers>
  <offer>...</offer>
  ...

</offers>

В элементе offers содержится список товарных предложений магазинов. Каждое товарное предложение описывается отдельным элементом offer.

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

У элемента offer могут быть следующие атрибуты: id, type, available, bid, cbid.

В атрибуте id указывается идентификатор товарного предложения. Атрибут может содержать только цифры и латинские буквы. Максимальная длина id — 20 символов. Идентификатор предложения должен быть уникальным среди всех товарных предложений одного прайс-листа. Если у двух и более товарных предложений указать одинаковые атрибуты id, то идентификатор будет присвоен только первому из этих предложений. Для остальных будет выводиться предупреждающее сообщение об отсутствии идентификатора.

В атрибуте type указывается тип описания.

В атрибуте available указывается статус доступности товара:

• «false» — товарное предложение на заказ. Магазин готов принять заказ и осуществить поставку товара в течение согласованного с покупателем срока, не превышающего двух месяцев (за исключением товаров, изготавливаемых на заказ, ориентировочный срок поставки которых оговаривается с покупателем во время заказа).
• «true» — товарное предложение в наличии. Магазин готов сразу договариваться с покупателем о доставке/покупке товара.

В атрибуте bid указывается основная ставка товарного предложения, а в атрибуте cbid — ставка для карточки модели.

В YML существуют несколько типов описаний предложений товаров: "упрощенный", "vendor.model", "book", "audiobook", "artist.title", "tour" и "event-ticket". В зависимости от типа описания используются соответствующие поля, согласно прилагаемой схеме DTD (см. приложение). Товарные предложения, описанные не в соответствии со своим типом, могут не приниматься к публикации.

Описание товарного предложения может быть представлено разными способами. Ниже приведено несколько примеров.

Упрощенное описание:

<offer id="12346" available="true" bid="21">
  <url>http://best.seller.ru/product_page.asp?pid=12348</url>

  <price>699.54</price>
  <currencyId>USD</currencyId>
  <categoryId>6</categoryId>
  <picture>http://best.seller.ru/img/device12345.jpg</picture>
  <store>true</store>
  <pickup>true</pickup>
  <delivery>false</delivery>
  <local_delivery_cost>300</local_delivery_cost>
  <name> Золотые наручные часы </name>
  <vendor> Longines </vendor>
  <vendorCode> A1234567B </vendorCode>
  <description> Изящные золотые часы.</description>
  <sales_notes> Необходима предоплата.</sales_notes>
  <country_of_origin> Швейцария </country_of_origin>

  <barcode>0012345678901</barcode>

</offer>

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

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

<offer id="12341" type="vendor.model" available="true" bid="13">

  <url>http://best.seller.ru/product_page.asp?pid=12344</url>
  <price>700</price>
  <currencyId>USD</currencyId>
  <categoryId> 6 </categoryId >
  < picture>http://best.seller.ru/img/device12345.jpg</picture>
  <store>true</store>
  <pickup>false</pickup>
  <delivery>true</delivery>
  <local_delivery_cost>300</local_delivery_cost>
  <typePrefix> Принтер </typePrefix>
  <vendor> НP </vendor>
  <vendorCode> CH366C </vendorCode>
  <model> Deskjet D2663 </model>
  <description>
    Серия принтеров для людей, которым нужен надежный, простой в использовании цветной принтер для повседневной печати. 
Формат А4. Технология печати: 4-цветная термальная струйная. Разрешение при печати: 4800х1200 т/д.
  </description>
  <sales_notes> Необходима предоплата.</sales_notes>
  <manufacturer_warranty>true</manufacturer_warranty>
  <country_of_origin>Япония</country_of_origin>
  
  <barcode>0123456789012</barcode>

  <param name="Максимальный формат">А4</param>
  <param name="Технология печати">термическая струйная</param>
  <param name="Тип печати">Цветная</param>
  <param name="Количество страниц в месяц" unit="стр">1000</param>
  <param name="Потребляемая мощность" unit="Вт">20</param>
  <param name="Вес" unit="кг">2.73</param>

</offer>

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

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

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

Книги

  <offer id="12342" type="book" available="true" bid="17">
  <url>http://best.seller.ru/product_page.asp?pid=14345</url>
  <price>80</price>
  <currencyId>RUR</currencyId>

  <categoryId>3</categoryId>
  <picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
  <store>true</store>
  <pickup>false</pickup>
  <delivery>true</delivery>
  <local_delivery_cost>300</local_delivery_cost>
  <author>Александра Маринина</author>
  <name>Все не так. В 2 томах. Том 1</name>

  <publisher>ЭКСМО — Пресс</publisher>
  <series>А. Маринина — королева детектива</series>
  <year>2007</year>
  <ISBN>978-5-699-23647-3</ISBN>
  <volume>2</volume>
  <part>1</part>
  <language>rus </language>
  <binding>70x90/32</binding>
  <page_extent>288</page_extent>

  <description>
Все прекрасно в большом патриархальном семействе Руденко. Но — увы! — 
впечатление это обманчиво: каждого из многочисленных (еще)Все прекрасно в 
большом патриархальном семействе Руденко. Но — увы! — впечатление это обманчиво:
 каждого из многочисленных представителей семьи обуревают свои потаенные страсти
 и запретные желания. И потому, когда погибает, причем явно.
  </description>

  <downloadable>false</downloadable>


</offer>

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

Аудиокниги

  <offer id="12342" type="audiobook" available="true" bid="17">
  <url>http://best.seller.ru/product_page.asp?pid=14345</url>
  <price>200</price>
  <currencyId>RUR</currencyId>
  <categoryId>3</categoryId>
  <picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
  <store>true</store>
  <pickup>true</pickup>
  <delivery>true</delivery>
  <author> Владимир Кунин </author>
  <name> Иваnов и Rабинович, или Аj'гоу ту 'Хаjфа!</name>
  <publisher>1С-Паблишинг, Союз</publisher>
  <year>2008</year>
  <ISBN>978-5-9677-0757-5</ISBN>
  <language>ru </language>
  <performed_by> Николай Фоменко </performed_by>
  <performance_type>начитана </performance_type>
..<storage>CD </storage>
..<format>mp3 </format>
..<recording_length>45m23s</recording_length>

  <description> Перу Владимира Кунина принадлежат десятки сценариев к
 кинофильмам, серия книг про КЫСЮ и многое, многое другое.

</description>
  <downloadable>true</downloadable>

</offer>

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

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

<offer id="12345" type="artist.title" available="true" bid="11">

  <url>http://best.seller.ru/product_page.asp?pid=12946</url>
  <price>15</price>
  <currencyId>USD</currencyId>
  <categoryId>2</categoryId>
  <picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
  <store>true</store>
  <pickup>true</pickup>
  <delivery>false</delivery>
  <artist>Pink Floyd</artist>
  <title>Dark Side Of The Moon, Platinum Disc</title>
  <year>1999<year>

  <media>CD</media>
  
  <barcode>1234567890123</barcode>


<description> Dark Side Of The Moon, поставивший мир на уши
 невиданным сочетанием звуков, — это всего-навсего девять 
треков, и даже не все они писались специально для альбома. 
Порывшись по сусекам, участники Pink Floyd мудро сделали 
новое из хорошо забытого старого — песен, которые 
почему-либо не пошли в дело или остались незаконченными. 
Одним из источников вдохновения стали саундтреки 
для кинофильмов, которые группа производила в больших количествах.

</description>


</offer>

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

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

<offer id="12344" type="artist.title" available="true" bid="56">
  <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>
  <store>true</store>
  <pickup>true</pickup>
  <delivery>true</delivery>
  <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>
  
  <barcode>2345678901234</barcode>


</offer>

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

Описание тура

<offer id="12341" type="tour" available="true" bid="71">
  <url>http://best.seller.ru/product_page.asp?pid=12344</url>
  <price>958</price>

  <currencyId>USD</currencyId>
  <categoryId>6</categoryId>
  <picture>http://best.seller.ru/img/device12345.jpg</picture>
  <store>true</store>
  <pickup>false</pickup>
  <delivery>false</delivery>
  <local_delivery_cost>300</local_delivery_cost>
  <worldRegion>Африка</worldRegion>

  <country>Египет</country>
  <region>Хургада</region>
  <days>7</days>
  <dataTour>01/01/03</dataTour>

  <dataTour>08/01/03</dataTour>
  <name>Hilton</name>
  <hotel_stars>5*****</hotel_stars>
  <room>SNG</room>

  <meal>ALL</meal>
  <included>авиаперелет, трансфер, проживание, питание, страховка</included>
  <transport>Авиа</transport>
  <description></description>


</offer>

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

Описание билетов на мероприятия

 <offer id="1234" type="event-ticket"  available="true" bid="13"> 
 <url>url товарного предложения</url>
 <price>100000</price>
 <currencyId>RUR</currencyId>
 <categoryId>3</categoryId> 
 <picture>url картинки товарного предложения</picture>
 <store>true</store>
 <pickup>false</pickup>
 <delivery>true</delivery>
 <local_delivery_cost>300</local_delivery_cost>
 <name>Дмитрий Хворостовский и Национальный филармонический
 оркестр России. Дирижер — Владимир Спиваков.</name>
 <place>Московский  международный Дом музыки</place>
 <hall plan="url плана зала">Большой  зал<hall>
 <hall_part>Партер р. 1-5<hall_part>

 <date>2004-12-31T19:00</date> 
 <is_premiere>0<is_premiere>
 <is_kids>0</is_kids>
 <description>описание товарного предложения.</description>


</offer>

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

Элементы, которые не были описаны в примерах, являются резервными и не обрабатываются.

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

Элемент picture

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

Пример:

<picture>http://best.seller.ru/img/device12345.jpg</picture>
<picture>http://best.seller.ru/img/device123456.jpg</picture>
<picture>http://best.seller.ru/img/device123457.jpg</picture>

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

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

Ссылка на HTML с изображением не допустима.

Элементы description, name и sales_notes

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

В элементах <description>, <name> и <sales_notes> запрещено указывать информацию о доставке, гарантии, месте производства (данная информация указывается при заполнении соответствующих ей элементов).

Элемент adult

Элемент <adult> обязателен для обозначения товара, имеющего отношение к удовлетворению сексуальных потребностей, либо иным образом эксплуатирующего интерес к сексу.

Предложения магазина, помеченные тегом <adult>, будут отображаться на странице выдачи результатов поиска Яндекса в блоке Маркета только при выключенном семейном фильтре и по строго определенным запросам. На поиске Маркета данные предложения будут отображаться только после подтверждения пользователем достижения возраста 18 лет.

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

Например:

<adult>true</adult>
<offers>
    <offers>...</offers>
    ...
</offers>

Например:

<offer>
    ...
    <typePrefix>Вибратор гелевый</typePrefix>
    <vendor>Robotic</vendor>
    <model>Реалистик 9</model>
    ...
    <adult>true</adult>
    ...
<offer>

Элемент barcode

Элемент <barcode> предназначен для передачи численных штрихкодов (баркодов) товара. В теге <barcode> необходимо передавать штрихкоды производителя. Если ваш магазин использует свою внутреннюю систему штрихкодов, отличных от штрихкодов производителей, передавать такие внутренние штрихкоды не нужно.

Один элемент <barcode> должен содержать один штрихкод, при этом в элемент <offer> может быть включено любое количество элементов <barcode>, так как одному товару может соответствовать несколько штрихкодов производителя, указанных в разных системах.

В теге <barcode> могут быть указаны только цифры. Пробелы, символы и буквы при проверке YML-файла будут восприниматься как ошибка.

Штрихкоды могут содержать 8, 12 и 13 цифр. Штрихкоды, содержащие более 13 цифр, используются для маркировки траспортной упаковки товара и для обмена данными между предприятиями. Такие штрихкоды передавать не нужно.

Например:

<offer>
    ...
    <typePrefix>Корпус</typePrefix>
    <vendor>Cooler Master</vendor>
    <model>RС-1100 (Cosmos S)</model>
    ...
    <barcode>4719512011041</barcode>
    <barcode>884102000539</barcode>
    ...
<offer>

Использование элемента <barcode> является опциональным.

Элемент param

Элемент param предназначен для передачи информации о характеристиках товара. Для каждого товарного предложения можно указать несколько элементов param, каждый из которых содержит одну характеристику товара.

Элемент описывается как <param name="NAME" unit="UNIT">VALUE</param> где:

NAME — название параметра;
UNIT — единица измерения (необязательный атрибут);
VALUE — значение параметра.

Например:

<offer>
   ...
   <param name="Тип процессора">Atom</param>
   <param name="Размер оперативной памяти" unit="Мб">2048</param>
   <param name="Типоразмер корпуса">Micro-Tower</param>
   <param name="Объём жесткого диска" unit="Гб">500</param>
  </offer>

Управление расценками (ставками) через XML

Управление ставками приоритета может осуществляться двумя способами — путем указания расценок в YML-файле и при помощи правил, задаваемых в Партнерском интерфейсе. Выбор варианта управления расценками (ставками) производится в Партнерском интерфейсе http://partner.market.yandex.ru в разделе "Управление ставками".

Для указания расценок (ставок) в YML-файле используются следующие атрибуты элемента offer:

bid (oсновная ставка) — действует для всех мест приоритетного размещения предложений, если не указана ставка для отдельного места;
cbid (cтавка для карточек) — действует только для страниц "Карточка модели" и "Все предложения модели".

Если ни один из атрибутов не задан, — для определения цены клика используются фиксированные цены, согласно описанию в "Общих условиях". Если задан bid, но не задан cbid, то считается, что cbid=bid. Если задан cbid, но не задан bid, то bid равен фиксированной цене за клик.

Например:

  <offer id="107" type="vendor.model" bid="23" cbid="43" available="true">
   <url>http://</url>
   <price>55</price>
   <currencyId>USD</currencyId>

   <categoryId>35</categoryId>
   <picture>http://</picture>
   <delivery>false</delivery>   
   <typePrefix>Наушники</typePrefix>
   <vendor>SONY</vendor>

   <model>MDR-CD480</model>
   <description> </description>
  </offer>

В приведенном выше примере цена перехода с "Блока Маркета" на основном поиске Яндекса будет равна 0.23 у.е. (bid="23") и со страницы "Все предложения модели" по 0.43 у.е. (cbid="43"). Если пользователь на странице "Все предложения модели" использовал сортировку, отличную от сортировки по умолчанию, то в этом случае цена перехода равна 0.1 у.е. (фиксированной стоимости размещения).

Примеры и рекомендации

Для аукционного размещения в выдаче основного поиска Яндекса блок offer может выглядеть, например, следующим образом (bid="15" — ставка равна 0.15 у.е.):

  <offer id="107" type="vendor.model" bid="15" available="true">
   <url>http://</url>

   <price>55</price>
   <currencyId>USD</currencyId>
   <categoryId>35</categoryId>
   <picture>http://</picture>
   <delivery>true</delivery>
   <typePrefix>Наушники</typePrefix>
   <vendor>SONY</vendor>
   <model>MDR-CD480</model>
   <description> </description>

  </offer>

В приведенном выше примере цена перехода с мест с возможностью приоритетного размещения будет 0.15 у.е. (переходы с карточек моделей, со страницы "все предложения" модели, с "Блока Маркета" в основном поиске Яндекса и с "Блока Маркета" на сайтах партнеров рекламной сети Яндекса).

Если вы хотите использовать аукционное размещение только в карточке модели, тогда используйте параметр cbid:

  <offer id="107" type="vendor.model" cbid="25" available="true">
   <url>http://</url>

   <price>55</price>
   <currencyId>USD</currencyId>
   <categoryId>35</categoryId>
   <picture>http://</picture>
   <delivery>true</delivery>   
   <typePrefix>Наушники</typePrefix>
   <vendor>SONY</vendor>
   <model>MDR-CD480</model>
   <description> </description>

  </offer>

В приведенном выше примере цена перехода будет 0.25 у.е. (переходы с карточек моделей и страницы "все предложения модели").

Еще раз обращаем ваше внимание на то, что значение bid, cbid — это размер расценки. Ее значение должно быть целым положительным числом. Например 21, или 42, или 65.

Подключение услуги "Приоритет" может быть произведено одним из двух способов: через YML-файл или через Партнерский интерфейс. Выбор способа указания ставок для участия в приоритетном размещении производится в Партнерском интерфейсе магазина (http://partner.market.yandex.ru).

Внимание: прежде чем отправить в Яндекс.Маркет новый YML-файл с установленными размерами ставок, рекомендуется проверить его на валидность в Партнерском интерфейсе в разделе «Проверка YML файла».

Проверка статистики

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

Поэтому, для получения реальной картины эффективности рекламной компании, кроме данных, предоставляемых Яндекс.Маркетом, необходимо учитывать еще и переходы с этих дополнительных источников трафика.

Организовать сбор данных обо всех переходах достаточно просто. Для этого необходимо в URL товарного предложения, подготовленного для показа на Яндекс.Маркете, добавить метку "from=ya" или "from=market" и затем проанализировать логи web-сервера на предмет наличия этого параметра в URL переходов. Таким образом, откуда бы переход ни был совершен, наличие этого параметра в URL позволит однозначно определить пользователей, перешедших по рекламному объявлению.

Пример:

Кроме точных данных о рекламных заходах, анализ логов может дать еще много полезной информации. Например, можно выяснить, на какие товарные предложения часто кликают, но не покупают — их можно убрать с Маркета и таким образом подкорректировать рекламную кампанию. Также возможны и другие варианты анализа.

Примечание

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

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

Текстовый формат с разделителями (например: CSV, TSV) является универсальным форматом при генерации прайс-листа из баз данных или редакторов электронных таблиц (например: Exсel, OpenOffice, Google Docs).

Общие требования к формату

Одна строка текстового файла с разделителями соответствует одной строке электронной таблицы.

В качестве разделителя столбцов используются запятая или точка с запятой (CSV), а также символ табуляции (TSV).

Одна строка файла должна содержать описание одного товарного предложения.

Первая строка файла (заголовок) должна содержать названия элементов, описывающих товарные предложения.

Кодировка файла должна быть UTF-8.

Текстовый формат с разделителями не допускает использование символов переноса и табуляции внутри полей.

Файл не должен содержать пустых столбцов.

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

При чтении заголовка файла проверяются следующие условия: все элементы являются корректными; присутствуют все обязательные элементы; каждый элемент присутствует не более одного раза. При невыполнении одного из этих условий файл отклоняется.

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

Описание элементов

В текстовом формате с разделителями можно использовать следующие элементы: все элементы, входящие в элемент <offer> (см. Элемент offers), кроме элементов categoryID и param; элементы, соответствующие следующим атрибутам элемента <offer>: id, type, available, bid и cbid; элемент category, содержащий имя категории товарного предложения (этот элемент используется вместо элемента categoryId, входящего в <offer>).

Описания элементов совпадают с описаниями соответствующих элементов, входящих в <offer>. Элемент category — категория товарного предложения.

Обязательные элементы

Список обязательных элементов для текстового формата с разделителями совпадает со списком обязательных элементов для <offer> соответствующего типа описания за исключением элемента categoryId, вместо которого используется элемент category.

Необязательные элементы

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

Отличия текстового формата с разделителями от YML-формата

В текстовом формате с разделителями отсутствует возможность передачи характеристик товара, используемых специально для фильтрации товарных предложений в результатах поиска Яндекс.Маркета. В текстовом формате с разделителями нельзя указать свои условия конвертации валют. В YML-формате категории выгружаются в виде "дерева", в текстовом формате с разделителями — "плоским" списком.

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

Формат Excel предназначен для упрощения передачи данных для магазинов, у которых информация об ассортименте хранится в редакторе электронных таблиц Exсel.

Общие требования к формату

Первая строка электронной таблицы должна содержать названия элементов, описывающих товарные предложения.

Одна строка файла должна содержать описание одного товарного предложения.

Файл не должен содержать пустых столбцов.

При чтении заголовка проверяются следующие условия: все элементы являются корректными; присутствуют все обязательные элементы; каждый элемент присутствует не более одного раза. При невыполнении одного из этих условий файл отклоняется.

При передаче данных по ассортименту в формате Excel в партнерском интерфейсе необходимо указать URL главной страницы магазина, а также короткое название магазина, используемое в списке найденных на Яндекс.Маркете.

Описание элементов

В формате Excel можно использовать следующие элементы: все элементы, входящие в элемент <offer> (см. Элемент offers), кроме элементов categoryID и param; элементы, соответствующие следующим атрибутам элемента <offer>: id, type, available, bid и cbid; элемент category, содержащий имя категории товарного предложения (этот элемент используется вместо элемента categoryId, входящего в <offer>).

Описания элементов совпадают с описаниями соответствующих элементов, входящих в <offer>. Элемент category — категория товарного предложения.

Обязательные элементы

Список обязательных элементов для формата Excel совпадает со списком обязательных элементов для <offer> соответствующего типа описания за исключением элемента categoryId, вместо которого используется элемент category.

Необязательные элементы

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