Рекомендації щодо формування xml з товарами

Приклад: https://multisearch.io/ua/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>		Ні

Оптимізація