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`	Зображення товару на картці. Якщо відсутнє, використовується Open Graph або обране зображення зі сторінки товару.
Ігнорується	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI ігнорує ці теги — їх можна залишити у продуктовому каталозі для інших інструментів.

Тег PARAM містить додаткову характеристику продукту у вигляді пари назва–значення:

<PARAM> <PARAM_NAME>Ширина</PARAM_NAME> <VAL>100–109 см</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` із текстовим іменем — числові ідентифікатори категорій наразі не підтримуються.
Формат ціни	`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`	Зображення продукту на картці. Якщо відсутнє, використовується 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	Продуктові каталоги через платформу з документацією для розробника	Продуктові каталоги
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 — наявність продукту — дозвольте відвідувачам перевіряти наявність продукту.
Mira AI асистент покупок: FAQ — типові питання про Mira AI.

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

Схожі статті

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