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

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

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

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

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

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

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

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

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

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

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

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`, `ДДС`, `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`	Един от тези тагове обгръща всеки продукт.
Описание (задължително)	`заглавие`, `описание`, `product_type` (или `google_product_category`), `връзка`, `цена`	За категория използвайте `product_type` или `google_product_category` с текстовото име — цифрови ID на категориите все още не се поддържат.
Формат на цената	`цена`	Разрешен формат: `236 CZK` или `CZK 236`. Валута е 3-буквен код (CZK, EUR, GBP…).
Незадължителни полета	`наличност`	В наличност: `in_stock`, `в наличност`. Изчерпано: `out_of_stock`, `изчерпано`, `preorder`, `backorder`, всичко останало / липсващо.
Изображение	`image_link`	Изображение на продукта, показано на картата. Ако липсва, Mira използва Open Graph или основното изображение на продуктовата страница.
Игнорирано	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI пропуска тези тагове — можете да ги оставите в каталога за други инструменти.

Забележка: Числово google_product_category ID са все още не се поддържат. Винаги използвайте текстовата версия на категорията — например "Apparel & Accessories > Clothing > Shirts & Tops" — или използвайте product_type вместо това.

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

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

Платформа	Какво генерира	Официално ръководство
Shoptet	Heuréka & Google Shopping XML от админ панела	XML Feeds • Heuréka XML
Shopsys	Продуктови каталози чрез платформата с документация за разработчици	Product Feeds
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 пазарски асистент?