Mira AI асистент покупок використовує ваш продуктовий каталог, щоб рекомендувати товари, відповідати на запитання щодо цін і перевіряти наявність. У цьому посібнику пояснюються формати каталогів, які Mira AI приймає, теги, які вона зчитує, а також наведено посилання на офіційні інструкції з експорту для найпопулярніших платформ електронної комерції.

Ми розділили цей посібник на такі розділи:

Перш ніж почати

Mira AI приймає стандартні XML продуктові каталоги — у тому ж форматі, який більшість платформ електронної комерції створюють для Heuréka, Google Shopping, Zboží.cz та подібних маркетплейсів. Чим багатший ваш каталог (ціна, наявність, опис, посилання, категорія), тим розумнішими будуть рекомендації Mira.

Щоб додати каталог у Smartsupp:

У конструкторі асистента відкрийте База знань → XML продуктовий каталог і натисніть Додати нове джерело.
Введіть назву джерела.
Вставте повний URL вашого продуктового каталогу.
На кроці Оновлення виберіть, як часто каталог має оновлюватися.

Порада: Див. Вступ до Mira AI для повного налаштування.

Mira AI автоматично оновлює ваш продуктовий каталог через регулярні проміжки часу — зміни цін, оновлення наявності та нові товари з’являються в чаті без необхідності повторно завантажувати файл.

Примітка: Mira AI завантажує зображення карток товарів безпосередньо з вашого XML каталогу. Якщо в каталозі для товару немає зображення, Mira використовує Open Graph або рекомендоване зображення на сторінці товару — тому також варто подбати, щоб вони були налаштовані.

Примітка: Якщо ваш сервер обмежує вхідні з’єднання (фаєрвол, список дозволених IP-адрес), переконайтеся, що ви дозволили доступ з IP-адрес для завантаження Продуктового каталогу Smartsupp: 94.130.187.58 та 188.245.65.74. Інакше Mira AI не зможе завантажити ваш продуктовий каталог.

Підтримувані формати Продуктового каталогу

Mira AI підтримує два стандартні формати Продуктового каталогу — Heuréka та Google Merchant. Обидва відповідають загальним XML-конвенціям:

Розширення файлу — .xml або .rss.
Найперша строка має починатися з <?xml ...?> або <rss ...>.
Один батьківський тег охоплює всі товарні позиції. Батьківський тег може мати будь-яку назву (наприклад <SHOP>) — важливим є лише факт його наявності.
Кожен товар обгорнуто в окремий тег позиції (дивіться розділи з описом конкретних форматів нижче).

Мінімальний коректний каркас виглядає так:

<?xml version="1.0" encoding="UTF-8"?> <SHOP> <SHOPITEM> ... </SHOPITEM> <SHOPITEM> ... </SHOPITEM> </SHOP>

Важливо: Якщо обов’язковий тег відсутній у товарі, цей товар повністю пропускається в індексі Mira — відвідувачі не бачитимуть його в рекомендаціях. Переконайтеся, що кожен товар має заповнені всі обов’язкові теги.

Структура каталогу Heuréka

Для формату Heuréka Mira AI зчитує такі теги. Див. офіційну документацію Heuréka щодо XML-фідів для повної специфікації.

Категорія	Теги	Примітки
Обгортка елемента (обов’язково)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Один із цих тегів обгортає кожен товар.
Опис (обов’язково)	`PRODUCTNAME` (або `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Кожен тег має містити вміст. Порожні теги вважаються відсутніми.
Необов’язково	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = у наявності, 1–7 = доступно протягом тижня, будь-що інше / відсутній = недоступно. `PARAM` може повторюватися будь-яку кількість разів для одного товару.
Зображення	`IMGURL`	Зображення товару, яке відображається на картці. Якщо його немає, Mira повертається до Open Graph або основного зображення на сторінці товару.
Ігнорується	`DELIVERY`, `EAN`, `ITEM_ID`, `ПДВ`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI пропускає ці теги — ви можете залишити їх у каталозі для інших інструментів.

Тег PARAM передає додатковий атрибут товару як пару ім’я–значення:

<PARAM> <PARAM_NAME>Width</PARAM_NAME> <VAL>100–109 cm</VAL> </PARAM>

Структура продуктового каталогу Google Merchant

Для формату Google Merchant Mira AI зчитує такі теги. Дивіться офіційну специфікацію продуктового каталогу Google Merchant для повної довідки.

Категорія	Теги	Нотатки
Обгортка елемента (обов’язково)	`item`, `entry`, `product`	Один із цих тегів обгортає кожен товар.
Опис (обов’язково)	`Назва`, `Опис`, `product_type` (або `google_product_category`), `Посилання`, `Ціна`	Для категорії використовуйте `product_type` або `google_product_category` з текстовою назвою — числові ID категорій поки що не підтримуються.
Формат ціни	`ціна`	Дозволений формат: `236 CZK` або `CZK 236`. Валюта — це 3-літерний код (CZK, EUR, GBP…).
Необов’язкові	`Наявність`	У наявності: `in_stock`, `у наявності`. Недоступно: `out_of_stock`, `немає в наявності`, `preorder`, `backorder`, будь-що інше / відсутнє.
Зображення	`image_link`	Зображення товару, яке відображається на картці. Якщо його немає, Mira використовує Open Graph або основне зображення на сторінці товару.
Ігнорується	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI пропускає ці теги — ви можете залишити їх у фіді для інших інструментів.

Примітка: Числове google_product_category ID ще не підтримуються. Завжди використовуйте текстову версію категорії — наприклад "Apparel & Accessories > Clothing > Shirts & Tops" — або використовуйте product_type замість цього.

Експорт фіда за платформою

Знайдіть свою платформу електронної комерції в таблиці нижче та дотримуйтеся офіційної інструкції з експорту.

Платформа	Що вона генерує	Офіційна інструкція
Shoptet	Heuréka & Google Shopping XML з адмін-панелі	XML фіди • Heuréka XML
Shopsys	Продуктові фіди через платформу з документацією для розробників	Продуктові фіди
Eshop-rychle	Фіди для порівняльних торгових сервісів	Експорт товарів
Upgates	Експорт даних XML з повною структурою товару	Експорт даних • Документація XML
Shoper	Google продуктовий фід безпосередньо з платформи	Фід Google
Shopware	Google Shopping — прямий експорт або через додатки	Прямий експорт • Додатки
Shoprenter	Google Shopping & фіди Heuréka	Google Shopping • Heuréka
Prestashop	Google Shopping через додатки	Додатки
Magento	Google Shopping через розширення	Розширення
WooCommerce	Google продуктовий фід через додатки	Додатки • Рекомендовано

Що далі?

Вступ до Mira AI асистента покупок — налаштувати Mira AI і додати свій продуктовий каталог як джерело.
Як почати навчати Mira AI — точно налаштувати відповіді ШІ за допомогою власних пар запитань&відповідей.
Mira AI – наявність товару на складі — дозволяє відвідувачам перевірити, чи є товар у наявності.
FAQ щодо Mira AI асистента покупок — поширені запитання про Mira AI.

💡 Потрібна додаткова допомога? Зв’яжіться з нашою командою підтримки — ми з радістю вам допоможемо!

Схожі статті

Як експортувати продуктові каталоги з різних платформ електронної комерції для Mira AI асистента покупок?