Асистент покупок 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>Ширина</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` (три літери коду валюти: 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	Каталоги товарів через платформу + документація для розробників	Каталоги товарів
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 Product Feed за допомогою додатків	Додатки • Рекомендовано

Що далі?

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

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

Схожі статті

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