Подписаться на рассылку

Описание формата YML выгрузки

20.03.2013 49 0
Время на чтение:7 мин. Нет времени читать?

 

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

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

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

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

Заголовок документа (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 оставляет за собой право поменять вид выдачи предложений, поэтому не гарантирует показ предложений в том виде, в котором они представлены в примерах.

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

 

 

Комментарии