Пример дерева категорий:
<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” в Генераторе указываются соответствия между понятными Генератору сущностями и некоторыми тегами в фиде
По умолчанию, в Генераторе используются следующие соответствия:
-
“Название” - тег <name> (краткая информация о товаре)
-
“Производитель” - тег <vendor> (название производителя)
-
“Ссылка” - тег <url> (ссылка на товар)
-
“Изображение” - тег <picture> (ссылка на картинку)
-
“Цена” - тег <price> (цена на товар)
-
“Артикул” - тег <vendorCode> (артикул, обычно в генерации его не используют (но для рекламы некоторых товаров он может быть полезен))
-
“Описание” - тег <description> (неструктурированное описание товара)
-
“Тип” - тег <model> (если ничего не указано в данном поле, но есть тег <param name=”Тип”>, то сущность “Тип” будет подтягиваться из этого тега param). Тип товара, т.е. “книга”, или “платье”, или “носки”
Пример хорошего товара (1):
<offer id="01" available="true">
<url>https://some_url.ru</url>
<price>549</price>
<currencyId>RUR</currencyId>
<categoryId>1183005</categoryId>
<picture>https://some_url.ru/1018042013.jpg</picture>
<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</url>
<price>619</price>
<currencyId>RUR</currencyId>
<categoryId>1179438</categoryId>
<picture>https://some_url.ru/1005978316.jpg</picture>
<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</url>
<price>1399</price>
<currencyId>RUR</currencyId>
<categoryId>1153311</categoryId>
<picture>https://some_url.ru/1024430454.jpg</picture>
<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>