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 или основната снимка във Вашата продуктова страница — добре е и те да са зададени.

Бележка: Ако Вашият сървър ограничава входящите връзки (firewall, списък с разрешени 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`. Валута е 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 все още не се поддържат. Винаги използвайте текстовата версия на категорията — например "Облекло & аксесоари > Дрехи > Ризи и топове" — или използвайте 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 пазарски асистент?