Задать вопрос

Часто задаваемые вопросы

Объяснение формата YML

Зарегистрироваться
Объяснение формата YML

Данный документ взят с сайта http://partner.market.yandex.ru/ и изменен в примерах и объяснениях для Рынка Yottos

Заголовок документа (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>

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

Поле

Описание

name

короткое название магазина.

company

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

url

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

Элемент currencies

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

  <currency id="USD" />
  <currency id="EUR" />
  ...
</currencies>

Список курсов валют магазина. Параметр id обозначает код валюты.

Элемент 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) для всех категорий и идентификатор категории более высокого уровня для подкатегорий. Идентификатор категории должен быть уникальным положительным целым числом (целое число не более 9 знаков). Ни у одной категории параметр id не может быть равен "0". Если элемент parentId не указан, то категория считается корневой.

Параметры:

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

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

Элемент offers

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

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

Описание элемента 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>1500</price>
  <currencyId>USD</currencyId>
  <categoryId>6</categoryId>

  <picture>http://best.seller.ru/img/device12345.jpg</picture>
  <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>


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

  Фото Товарное предложение Дата Цена
1

ФОТО
Принтер HP Laser Jet 5100 12.04.2007 1500$

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

 
<offer id="12346" available="true" bid="21">
  <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>

  <name>Принтер HP Laser Jet 1100</name>
  <vendorCode>Q1861A<vendorCode>
  <description>Лазерный принтер, А4, 8 стр. в минуту, разрешение 600х600</description>
</offer>

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

  Фото Товарное предложение Дата Цена
1

ФОТО
Принтер HP Laser Jet 1100 12.04.2007 210.54€

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

элементы

Описание

url

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

price

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

currencyId

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

categoryId

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

picture

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

typePrefix

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

vendor

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

model

Модель

name

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

description

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

vendorCode

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

available

статус доступности товара - в наличии/на заказ

available="false" - товарное предложение на заказ. Магазин готов осуществить поставку товара на указанных условиях в течение месяца (срок может быть больше для товаров, которые всеми участниками рынка поставляются только на заказ).. Те товарные предложения, на которые заказы не принимаются, не должны выгружаться.

available="true" - товарное предложение в наличии. Магазин готов сразу договариваться с покупателем о доставке товара

sales_notes

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

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

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

Книги

 
  <offer id="12342" type="book" available="true" bid="17">
  <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>
  <author>Александра Маринина</author>
  <name>Мужские игры</name>

  <publisher>ЭКСМО - Пресс</publisher>
  <series>Детектив глазами женщины</series>
  <year>1999</year>
  <ISBN>32142143214</ISBN>

  <description>
    Кажется, невозможно подобрать ключ к новому, запутанному делу,
    что предстоит расследовать сотруднику уголовного розыска Анастасии Каменской.
    Крупный мафиози Эдуард Денисов дает сотруднику уголовного розыска Насте
    Каменской нить к разгадке преступлений.
  </description>
</offer>

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

  Фото Товарное предложение Дата Цена
1

ФОТО
Мужские игры
Автор:Александра Маринина
Издательство:ЭКСМО - Пресс
Год:1999
ISBN:32142143214
Серия:Детектив глазами женщины
12.04.2007 65 р.

элемент

Описание

author

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

name

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

publisher

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

series

серия

year

год издания

ISBN

код книги


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

 
<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>
  <artist>Pink Floyd</artist>
  <title>Dark Side Of The Moon, Platinum Disc</title>
  <year>1999<year>

  <media>CD</media>
</offer>

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

  Фото Товарное предложение Дата Цена
1

ФОТО
Dark Side Of The Moon, Platinum Disc
Исполнитель:Pink Floyd
Носитель:CD
Год:1999
12.04.2007 15$

элемент

Описание

artist

исполнитель

title

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

media

носитель


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

 
<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>

  <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>

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

  Фото Товарное предложение Дата Цена
1

ФОТО
Свадьба Мюриэл
Актеры:Тони Колетт (Toni Collette), Рэйчел Грифитс (Rachel Griffiths)
Режиссер:П Дж Хоген
Носитель:DVD
Год:1999
Оригинальное наименование:Muriel's wedding
Страна:Австралия
12.04.2007 93 р.

элемент

Описание

title

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

starring

актеры

director

режиссер

originalName

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

country

страна

year

год

media

носитель


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

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

  <currencyId>USD</currencyId>
  <categoryId>6</categoryId>
  <picture>http://best.seller.ru/img/device12345.jpg</picture>
  <worldRegion>Африка</worldRegion>

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

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

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

</offer>

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

  Фото Товарное предложение Дата Цена
1

ФОТО
Тур Африка Египет Хургада Hilton 5***** SNG ALL на 7 дн.
Страна:Египет
Часть света:Африка
Курорт или город:Хургада
Количество дней:7
Тип комнаты:SNG
Тип питания:ALL
Включено:авиаперелет, трансфер, проживание, питание, страховка
Транспорт:Авиа
Дата:08.01
12.04.2007 958$

элемент

Описание

worldRegion

часть света

country

страна

region

курорт или город

days

количество дней тура

dataTour

даты заездов

name

название отеля (в некоторых случаях наименование тура)

hotel_stars

звезды S отеля 5*****

room

тип комнаты (SNG, DBL......)

meal

тип питания (All, HB......)

included

что включено в стоимость тура

transport

транспорт

description

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


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

 
<offer type="event-ticket"  available="true" bid="13"> 
 <url>url товарного предложения</url>
 <price>10000</price>
 <currencyId>RUR</currencyId>
 <categoryId>3</categoryId> 
 <picture>url картинки товарного предложения</picture>

 <name>Дмитрий Хворостовский и Национальный филармонический
 оркестр России. Дирижер - Владимир Спиваков.</name>
 <place>Московский  международный Дом музыки</place>
 <hall plan="url плана зала">Большой  зал<hall>
 <hall_part>Партер р. 1-5<hall_part>

 <date>31.12.2004 19:00</date> 
 <is_premiere>0<is_premiere>
 <is_kids>0</is_kids>
 <description>описание товарного предложения.</description>

</offer>

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

  Фото Товарное предложение Дата Цена
1

ФОТО
Дмитрий Хворостовский и Национальный филармонический оркестр России. Дирижер - Владимир Спиваков.
Место проведения:Московский международный Дом музыки
Зал:Большой зал
Места:Партер р. 1-5
Дата:31.12 19:00
12.04.2007 10000р.

элемент

Описание

name

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

place

зал

hall plan

Ссылка на картинку версии зала

date

дата и время сеанса ISO 8601: YYYY-MM-DDThh:mm

is_premiere

признак премьерности мероприятия

is_kids

признак детского мероприятия


элемент picture

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

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

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

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

элементы description и name

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

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

При размещении рекламы в партнерской сети Yottos необходимо обратить вниманиеи на ограничение количества символов в рекламных предложениях:

  • Название товара/услуги – не более 35 символов;
  • Описание товара/услуги – не более 70 символов (описание можно увеличить вторым новым предложением, вставленным после начальных 70 символов, как дополнительная информация)
  • Фотография – 150х150 рх;
  • Цена товара/услуги – удобная для пользовательского понимания.

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

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


   
  Главная страница Yottos  
©2006-2018 Yottos