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 зчитує наведені нижче теги. Перегляньте Офіційну документацію каталогу XML Heuréka Щоб ознайомитися з повною специфікацією.

Категорія	Теги	Примітки
Обгортка елемента (Обов’язкова)	`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`. Валюта позначається 3-літерним кодом (CZK, EUR, GBP…).
Необов’язкові	`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 ID Поки що не підтримуються. Завжди використовуйте текстову версію категорії — наприклад "Apparel & Accessories > Clothing > Shirts & Tops" — або використовуйте product_type Натомість.

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

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

Платформа	Що вона створює	Офіційний посібник
Shoptet	XML Heuréka & Google Shopping з панелі адміністратора	Каталоги XML • XML Heuréka
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 Product Feed через додатки	Додатки • Рекомендовані

Що далі?

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

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

Схожі статті

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