Mira AI пазарски асистент използва Вашия продуктов каталог, за да препоръчва продукти, да отговаря на въпроси относно цена и наличност. В това ръководство ще научите кои формати на каталози приема Mira AI, какви тагове са от значение и ще намерите връзки към официалните инструкции за експортиране за най-популярните платформи за електронна търговия.

Ръководството е структурирано по следния начин:

Каталогът или автоматичното извличане на уеб данни не работят? Отстраняване на проблеми с източниците на знания в Mira AI

Преди да започнете

Mira AI приема стандартни продуктови каталози във формат XML — същия формат, който повечето платформи за електронна търговия създават за Heuréka, Google Shopping, Zboží.cz и други подобни услуги. Колкото по-подробен и актуален е Вашият каталог (цена, наличност, описание, линк, категория), толкова по-прецизни ще бъдат препоръките от Mira AI.

За да добавите каталога към Smartsupp:

В конструктора на асистента отворете База знания → Продукти и изберете Добавяне.
Въведете име на източника.
Поставете пълния URL адрес на Вашия продуктов каталог.
В стъпка Актуализация определете колко често да се обновява каталогът.

Съвет: Вижте Въведение в Mira AI за пълни настройки.

Mira AI автоматично обновява Вашия продуктов каталог на редовни интервали — всички промени в цените, наличността и списъка с продукти се отразяват в чата без нужда от повторно качване на файла.

Забележка: Mira AI зарежда изображенията за продуктовите карти направо от Вашия XML каталог. Ако даден продукт няма изображение в каталога, Mira ще използва Open Graph или основното изображение от продуктовата страница — добра практика е да са налични и там.

Забележка: Ако Вашият сървър ограничава външния достъп (например използвате фаеруол или списък с разрешени IP адреси), уверете се, че достъпът от IP адресите на Smartsupp feed-fetcher: 94.130.187.58 и 188.245.65.74 е разрешен. В противен случай Mira AI няма да има възможност да изтегли Вашия каталог.

Тези IP адреси могат да се променят във времето. Ако каталогът спре да се обновява, проверете статията за актуален списък или се свържете с нашия екип по поддръжката.

Поддържани формати на каталози

Mira AI поддържа два основни формата за продуктови каталози — Heuréka и Google Merchant. И при двата се използват стандартни XML структури:

Файловото разширение трябва да бъде .xml или .rss.
Първият ред е <?xml ...?> или <rss ...>.
Един родителски таг съдържа всички продуктови елементи. Името на тагът не е важно (например <SHOP>), но наличието му е задължително.
Всеки продукт е в отделен таг item (вижте секциите по-долу за примерната структура).

Минимален коректен шаблон изглежда така:

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

Важно: Ако липсва задължителен таг за даден продукт, той няма да се появи в индекса на Mira AI — посетителите няма да го виждат при препоръки. Уверете се, че всички задължителни полета са попълнени за всеки продукт.

Структура на 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 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` само с текстово име; към момента числовите 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`. Валутата е трибуквен код (напр. 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 AI разпознава и продуктови размери от таг size и може да ги включва в препоръките. Ако добавите или промените размери, това ще се отрази автоматично с обновяване на каталога.

Забележка: Числови google_product_category ID все още не се поддържат. Използвайте текстова категория — напр. „Дрехи и аксесоари > Дрехи > Блузи и горнища“ — или вместо това 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 — персонализирайте отговорите на AI с индивидуални Q&A двойки.
Mira AI – наличност на продукти — позволете на посетителите да проверяват дали даден продукт е наличен.
Mira AI пазарски асистент – често задавани въпроси — отговори на най-често срещаните въпроси за Mira AI.

💡 Нуждаете се от още помощ? Свържете се с нашия екип по поддръжка — с радост ще Ви съдействаме!

Свързани статии

Как да експортирате продуктови каталози от различни платформи за електронна търговия за Mira AI пазарски асистент?