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

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

Каталог або веб-скрейпінг не працюють? Вирішення проблем із джерелами знань Mira AI

Перед початком

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

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

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

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

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

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

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

Ці IP-адреси час від часу можуть змінюватися. Якщо каталог перестав оновлюватися — перевірте цю статтю для актуального списку або зверніться до нашої служби підтримки.

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

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`, `VAT`, `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`	Кожен продукт огортається одним із цих тегів.
Опис (обов’язково)	`title`, `description`, `product_type` (або `google_product_category`), `link`, `price`	Для категорії використовуйте `product_type` або `google_product_category` з текстовою назвою — числові ID категорій поки не підтримуються.
Формат ціни	`price`	Допустимі формати: `236 CZK` чи `CZK 236`. Десятковий та роздільник тисяч також приймаються, наприклад `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` або `1 049,00 CHF`. Валюта — 3 літери (CZK, EUR, GBP...).
Ціна зі знижкою (опційно)	`sale_price`, `sale_price_effective_date`	Якщо присутній `sale_price` тією ж валютою й менший за `price` — Mira згадує ціну зі знижкою у відповідях, пошуку й картках. З `sale_price_effective_date` знижка діє лише в цьому діапазоні дат (перевіряється на момент питання), поза ним/нерозпізнаному — використовується базова ціна. Існуючі каталоги підхоплять знижку після наступного оновлення.
Необов'язково	`availability`	В наявності: `in_stock`, `in stock`. Недоступно: `out_of_stock`, `out of stock`, `preorder`, `backorder`, інші значення/відсутній.
Зображення	`image_link`	Зображення товару на картці. Якщо відсутнє — Mira підтягує Open Graph чи основну картинку зі сторінки товару.
Ігнорується	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI ігнорує ці теги — їх можна залишати для інших інструментів.

Mira також зчитує розміри продуктів із каталогу (тег size), і може згадувати їх у рекомендаціях. Розміри з'являться після оновлення каталогу.

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

Експорт каталогу за платформою

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

Платформа	Що генерує	Офіційна інструкція
Shoptet	Heuréka & Google Shopping XML з адмінпанелі	XML каталоги • Heuréka XML
Shopsys	Продуктові каталоги через платформу з документацією для розробників	Product Feeds
Eshop-rychle	Каталоги для порівняльних платформ	Експорт товарів
Upgates	XML-експорт з усією структурою товару	Експорт даних • Документація по XML
Shoper	Google продуктовий каталог прямо з платформи	Google Feed
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 — відкоригуйте відповіді AI парою власних запитань і відповідей.
Mira AI - наявність товару — дозвольте відвідувачам перевіряти, чи є товар у наявності.
FAQ Mira AI асистента покупок — відповіді на типові запитання про Mira AI.

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

Схожі статті

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