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

Разделихме наръчника на следните секции:

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

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

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

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

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

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

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

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

Забележка: Ако Вашият сървър ограничава входящите връзки (файъруол, разрешен списък с IP адреси), уверете се, че Smartsupp има достъп от следните IP адреси: 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 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` с текстово име — цифрови идентификатори на категории все още не се поддържат.
Формат на цената	`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` промоционалната цена се използва само в рамките на посочения период (проверява се към момента на заявката); извън този период или ако той не може да бъде прочетен, Mira използва стандартната цена. Съществуващите каталози поемат промо цените при следващото си обновяване.
Доброволно	`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.

Експортиране на каталог по платформа

Намерете Вашата e-commerce платформа в таблицата по-долу и следвайте официалното ръководство за експортиране.

Платформа	Какво генерира	Официално ръководство
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.

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

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

Как да експортирате продуктови каталози от различни e-commerce платформи за MiraAI пазарски асистент?