Рекомендации по формированию xml с товарами

Пример: https://multisearch.io/examples/products.xml

Мультиязычность

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

Структура фида

Заголовок xml фида

Должен содержать версию и кодировку XML utf-8
Пример:

<?xml version="1.0" encoding="utf-8"?>

Блок <shop>

Тег (атрибут)ОписаниеПримерОбязательный тег
<name>Название интернет-магазина<name>Example.com</name>Нет
<url>Ссылка на главную страницу интернет-магазина<url>https://example.com</url>Нет
<currencies>Валюта магазина<currencies>
<currency id="USD" rate="1"/>
</currencies>		Нет
<presences>Возможные статусы наличия, располагаются в порядке желаемой приоритетности при ранжировании<presences>
<presence>В наличии</presence>
<presence>Под заказ</presence>
<presence>Нет в наличии</presence>
</presences>		Нет

Блок <categories>

Тег (атрибут)ОписаниеПримерОбязательный тег
<category [id]>Уникальный идентификатор категории<category id="2" ordering="30" parentId="1" url="https://example.com/laptop/">Ноутбуки</category>Да
<category [url]>Адрес страницы категории (для перехода с категорий в результатах поиска на категории в интернет-магазине)Нет
<category [parentId]>Уникальный идентификатор родительской категорииНет
<category [ordering]>Дополнительное ранжирование результатов (чем ближе к 1, тем выше товары категории, можно настроить и обратную сортировку). Значение ordering категории применяется, если ordering не передается для offerНет

Блок <offers>

Тег (атрибут)ОписаниеПримерОбязательный тег
<offer>offer id - уникальный идентификатор товара или услуги
offer available - значение наличия товара (true/false). При отсутствии - учитывается true		<offer available="true" id="39430">Да
<offer [group_id]>Группирует все предложения, которые являются вариациями одной модели и отличаются одним параметром - размером, цветом и т. д. В фид добавляются все товары группы с атрибутом group_id. Для основного товара id и group_id будут одинаковыми, для модификаций - разными. Поиск будет работать по всем товарам группы, а отображаться будет только основной товар.Основной товар:
<offer available="true" id="39430" group_id="39430">

Товар-модификация:
<offer available="true" id="39431" group_id="39430">		Нет
<name>Наименование товара или услуги<name>Ноутбук Asus X756UQ (X756UQ-T4205D) Dark Brown</name>Да
<url>Адрес страницы товара или услуги<url>https://example.com/laptop-asus/asus_t4205d_dark_brown/</url>Да (для плагина)
Нет (для API)
<picture>Ссылка на фото. Укажите путь к картинке с размером, приближенным к 160x160px. Чем меньше размер - хуже качество картинок в результатах, чем больше - замедляется загрузка картинок<picture>https://example.com/products/509.jpg</picture>Нет
<categoryId>Код товарной категории, которой принадлежит позиция<categoryId>2</categoryId>Да
<currencyId>Код валюты, представляется в виде USD, UAH, EUR<currencyId>USD</currencyId>Нет
<price>Цена товара<price>1100</price>Нет
<oldprice>Значение старой цены до скидки. Для отображения перечеркнутой цены и новой цены<oldprice>1200</oldprice>Нет
<price_min>Цена “от”. Передача минимальной цены товарной позиции<price_min>1100</price_min>Нет
<vendor>Производитель (бренд) товара<vendor>Asus</vendor>Нет
<vendorCode>Артикул товара. Если в элементе
<offer id="39430"> атрибут id не является артикулом		<vendorCode>X756UQ-T4205D</vendorCode>Нет
<presence>Текстовое отображение наличия товара (Склад, Есть в наличии, Нет в наличии, Наличие уточняйте …). Результаты будут выше показывать по наличию от первого к последнему<presence>Есть в наличии</presence>Нет
<createdAt>Дата создания товара. Выше будут отображаться более свежие товары<createdAt>2018-01-28 22:01:54</createdAt>Нет
<label>Значение типа товара (Новинка, Хит, Скидка…). Для приоритетного отображения в выдаче спец. предложений<label>Лучшая цена</label>Нет
<description>Описание товара<description>Высокая вычислительная мощь нового ноутбука X-серии от ASUS гарантирует быструю работу любых, даже самых ресурсоемких, приложений.</description>Нет
<param>Характеристики товара<param name="Оптический привод">DVD Super Multi</param>Нет
<param filter="true">Фильтрация по характеристикам товара в результатах выдачи - filter=true (добавить к тегу param, что отвечает за характеристики товара)
(Дополнительная интеграция "Динамические фильтры")		<param filter="true" name="Процессор">Двухъядерный Intel Core i7-7500U (2.7 - 3.5 ГГц)</param>

Передача нескольких значений одного фильтра отдельными тегами, например:
<param filter="true" name="Цвет">Черный</param>
<param filter="true" name="Цвет">Белый</param>		Нет
<ordering>Настраиваемое дополнительное ранжирование результатов (чем ближе к 1, тем выше товары категории; можно настроить и обратную сортировку). Рекомендуемый диапазон: 1-1000<ordering>123</ordering>Нет
<keywords>Ключевые фразы (поисковые запросы) для приоритетной выдачи<keywords>Ноутбук для офиса, игровой ноутбук</keywords>Нет
<code>Код поставщика, тег можно использовать для поиска по разным кодам<code>4205D</code>Нет
<snippet>Вывод дополнительной информации под названием товара в результатах поиска (для плагина). Значение поля не участвует в поиске<snippet>Код: 4205D</snippet>Нет
<shops>Вывод разных цен и наличия товаров в разных регионах (магазинах).
<shop id="" presence="" price="" oldprice="" />
(данное значение необходимо передавать для каждого товара, где id - айди магазина)
(Дополнительная интеграция "Региональность")		<shops>
<shop id="1" oldprice="1200" presence="true" price="1100"/>
<shop id="2" presence="true" price="1100"/>
</shops>		Нет
Элемент с несколькими значениями укажите как несколько элементов последовательно<categoryId>14</category>
<categoryId>25</category>
<label>Новинка</label>
<label>Хит</label>
<code>4205D</code>
<code>12345D</code>		Нет

Оптимизация