Требования к XML-фиду

Пример дерева категорий:

<categories>

     <category id="1153308">Одежда</category>

     <category id="1153309" parentId="1153308">Женская одежда</category>

     <category id="1165442" parentId="1153308">Детская одежда</category>

     <category id="1153311" parentId="1165442">Одежда для девочек</category>

     <category id="1153312" parentId="1165442">Одежда для мальчиков</category>

     <category id="1153313" parentId="1165442">Одежда для новорожденных</category>

     <category id="1153310" parentId="1153308">Мужская одежда</category>

</categories>

Теги в XML-фиде:

* теги в фиде должны иметь такие же названия, какие представлены в требованиях к  XML-фиду; однако, на шаге №2 в Генераторе можно переопределить некоторые названия тегов и выбрать свои, если они представляют аналогичные по сути вещи

<offer>

• тег offer должен иметь атрибут id (пример: <offer id="33433148">)

• атрибут тега offer “available” опционален (пример, <offer available="true">) - наличие товара будет проверяться как по наличию товара в фиде, так и по этому атрибуту (если его нет, то только по наличию в фиде)

<model> - тип товара

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

• если нет тега <model>, но указан <param name=”Тип”>, то тип товара будет подтягиваться из этого тега param

<url> - ссылка на товар

• обязателен, - если его нет, то появится ошибка в интерфейсе

<price> - цена

• рекомендован, но опционален - если его нет, то в рекламных объявлениях просто не будет указываться цена (пример:<price>149</price>)

<categoryId> - товарная категория

• обязателен (пример:<categoryId>1179438</categoryId>)

• категория в товаре должна находиться в шапке категорий в фиде, иначе мы не будем обрабатывать такой товар

• если категория у товара не указана или тег пустой (<categoryId></categoryId>), то мы не будем обрабатывать такой товар

• если категорий для товара указано несколько, будет выбрана только одна (первая указанная)

<picture> - ссылка на изображение

• обязателен, если нужны картинки - если его нет, генератор не будет добавлять картинки к рекламным объявлениям (валидацию требованиям Яндекса к картинкам мы делаем внутри генератора - если картинка невалидна, она не будет добавлена к рекламному объявлению)

<name> - краткая информация о товаре

• обязателен, - если его нет, то появится ошибка в интерфейсе

• лучше всего, когда тип товара (например, “шуруповерт” или “платье”) идет в начале тега name, а доп.информация разделена запятыми (либо любыми другими знаками препинания). Всякого рода названия (например, название книги, скажем, “Дети капитана Гранта”) лучше всего указывать в кавычках “”, чтобы Генератор не разделил их на отдельные слова (и не стал рекламировать отдельно детей и гранты)

<vendor> - производитель

• обязателен, если клиенту нужна семантика с производителем

<description> - неструктурированное описание товара

• опционален, но семантика будет лучше, если его указать

• если описание не сильно связано с самим товаром (например, товар - бумажная модель танка, а в описании товара пространно описывается Вторая Мировая, то и семантика будет скорее не про товар, а про войну), то, возможно, лучше не стоит указывать данный тег для обработки

<param> - доп.информация о товаре

• расширяют семантику, можно указать их для обработки генератором на шаге №2 “Обработка полей YML”, нажав на кнопку “+Добавить дополнительные поля “

На шаге №2 “Обработка полей в XML” в Генераторе указываются соответствия между понятными Генератору сущностями и некоторыми тегами в фиде

По умолчанию, в Генераторе используются следующие соответствия:

1. “Название” - тег <name> (краткая информация о товаре)

2. “Производитель” - тег <vendor> (название производителя)

3. “Ссылка” - тег <url> (ссылка на товар)

4. “Изображение” - тег <picture> (ссылка на картинку)

5. “Цена” - тег <price> (цена на товар)

6. “Артикул” - тег <vendorCode> (артикул, обычно в генерации его не используют (но для рекламы некоторых товаров он может быть полезен))

7. “Описание” - тег <description> (неструктурированное описание товара)

8. “Тип” - тег <model> (если ничего не указано в данном поле, но есть тег <param name=”Тип”>, то сущность “Тип” будет подтягиваться из этого тега param). Тип товара, т.е. “книга”, или “платье”, или “носки”

Пример хорошего товара (1):

     <offer id="01" available="true">

       <url>https://some_url.ru&lt;/url&gt;

       <price>549</price>

       <currencyId>RUR</currencyId>

       <categoryId>1183005</categoryId>

       <picture>https://some_url.ru/1018042013.jpg&lt;/picture&gt;

       <name>Сумка для инструментов "Workpro", 6 карманов, 32 х 21 х 23 см</name>

       <vendor>WORKPRO</vendor>

       <description>Профессиональная сумка для инструментов "Workpro" разработана с учетом высоких требований к надежности, безопасности и удобства использования. Материал сумки – износостойкий водоотталкивающий материал: полиэстер 600D. Конструкция сумки позволяет широко открывать ее по всей длине для удобства доступа. В лицевой части сумки вставлен металлический каркас, который позволяет сумке держать форму в раскрытом состоянии. Дно сумки укреплено плотным материалом. Ручки, в месте захвата рукой, имеют округлую форму, с уплотнителем внутри, для более комфортного ношения груженой сумки. Сумка оснащена 6 наружными карманами. Швы сумки надёжно прошиты прочными капроновыми нитями.Современная и практичная конструкция предназначена для длительного использования сумки в качестве хранения и транспортировки инструментов. Рекомендованная допустимая нагрузка 8 кг.Размеры сумки: 320 х 210 х 230 мм</description>

       <param name="Тип">Сумка</param>

       <param name="Материал">Полиэстер,Металл,Капрон,Пластик</param>

       <param name="Орнамент">Надписи</param>

       <param name="Число отделений" unit="шт">6</param>

       <param name="Макс. нагрузка" unit="кг">8</param>

       <param name="Особенности">Водоотталкивающая пропитка,Жесткая вставка в спинке</param>

       <param name="Цвет">черный</param>

     </offer>

Пример хорошего товара (2):

     <offer id="02" available="true">

       <url>https://some_url.ru&lt;/url&gt;

       <price>619</price>

       <currencyId>RUR</currencyId>

       <categoryId>1179438</categoryId>

       <picture>https://some_url.ru/1005978316.jpg&lt;/picture&gt;

       <name>Развивающая игрушка Tiny Love "Волшебный шарик"</name>

       <vendor>Tiny Love</vendor>

       <description>Развивающая игрушка-погремушка Tiny Love "Волшебный шарик" выполнена в виде шара, состоящего из восьми элементов разных цветов, которые свободно перемешаются вокруг оси. Внешняя поверхность цветных элементов покрыта маленькими выпуклыми точками, которые стимулируют нервные окончания на пальчиках вашего малыша. С внутренней стороны элементы шара зеркальные. На оси шара расположен двусторонний шарик с улыбающимися мордочками, который может перемещаться вверх-вниз и вращаться вокруг оси. Внутри шарика находятся мелкие гранулы, гремящие при вращении или тряске. Форма игрушки-погремушки удобна для маленьких детских ручек. Малыш сможет ее держать, трясти и перекладывать из одной ручки в другую.  Игрушка-погремушка "Волшебный шарик" способствует развитию у ребенка цветового и звукового восприятия, тактильных ощущений, мелкой моторики рук.</description>

       <model>Погремушка</model>

       <param name="Возраст ребенка">От 0 месяцев</param>

       <param name="Материал">Пластик</param>

       <param name="Пол">Для девочек</param>

       <param name="Дополнительные функции">Развивающая</param>

     </offer>

Пример хорошего товара (3):

     <offer id="03" available="true">

       <url>https://some_url.ru&lt;/url&gt;

       <price>1399</price>

       <currencyId>RUR</currencyId>

       <categoryId>1153311</categoryId>

       <picture>https://some_url.ru/1024430454.jpg&lt;/picture&gt;

       <name>Платье для девочки Button Blue, цвет: синий.</name>

       <vendor>Button Blue</vendor>

       <description>Платье модного свободного кроя – идеальная повседневная одежда, подходящая и девочкам помладше, и подросткам. Оно позволит чувствовать себя уверенно и выглядеть на все сто, не жертвуя свободой движения и удобством. Если вы хотите недорого купить детское платье, модель от Button Blue станет отличным вариантом. Актуальная форма, привлекательный цвет и прекрасное качество делают это платье прекрасным вариантом на каждый день.</description>

       <param name="Размер" unit="RU">122</param>

       <param name="Тип">Платье</param>

       <param name="Материал">Хлопок,Эластан</param>

       <param name="Сезон">Всесезонное</param>

       <param name="Стиль">Повседневный</param>

       <param name="Пол">Для девочек</param>

       <param name="Возраст">Детская</param>

       <param name="Размер (рост)">122</param>

       <param name="Цвет">синий</param>

     </offer>