Пазарският асистент 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 все още не се поддържат. Винаги използвайте текстовата версия на категорията — например "Облекло & аксесоари > Дрехи > Ризи & горнища" — или използвайте product_type вместо това.

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

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

Платформа	Какво генерира	Официално ръководство
Shoptet	XML за Heuréka & Google Shopping от административния панел	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 отговорите с персонализирани двойки въпроси&отговори.
Mira AI - наличност на склад — позволете на посетителите да проверяват дали даден продукт е в наличност.
Често задавани въпроси за пазарския асистент Mira AI — често задавани въпроси за Mira AI.

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

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

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