Mira AI Shopping Assistant wykorzystuje Twój product feed do polecania produktów, odpowiadania na pytania dotyczące cen i sprawdzania dostępności. Ten poradnik wyjaśnia, jakie formaty feedów akceptuje Mira AI, które tagi odczytuje i gdzie znajdziesz oficjalne instrukcje eksportu z najpopularniejszych platform e-commerce.

Podzieliliśmy poradnik na następujące sekcje:

Feed lub web scrape nie działa? Rozwiązywanie problemów ze źródłami wiedzy Mira AI

Zanim zaczniesz

Mira AI akceptuje standardowe product feedy XML – ten sam format generowany przez większość platform e-commerce dla Heuréka, Google Shopping, Zboží.cz i podobnych marketplace’ów. Im bogatszy feed (cena, dostępność, opis, link, kategoria), tym lepsze rekomendacje od Mira AI Shopping Assistant.

Aby dodać feed w Smartsupp:

W kreatorze asystenta otwórz Baza wiedzy → Produkty i kliknij Dodaj.
Wpisz nazwę źródła.
Wklej pełny URL swojego product feedu.
W kroku Aktualizacja wybierz, jak często feed ma być odświeżany.

Wskazówka: Sprawdź Wprowadzenie do Mira AI Shopping Assistant po pełną instrukcję konfiguracji.

Mira AI Shopping Assistant automatycznie odświeża Twój product feed w regularnych odstępach – zmiany cen, aktualizacje dostępności i nowe produkty będą pojawiać się w czacie bez ręcznego wgrywania pliku.

Uwaga: Mira AI Shopping Assistant pobiera zdjęcia produktów do kart bezpośrednio z Twojego XML product feedu. Jeśli jakiś produkt nie ma zdjęcia w feedzie, Mira AI Shopping Assistant korzysta ze zdjęcia Open Graph lub zdjęcia wyróżnionego na stronie produktu – warto mieć je uzupełnione.

Uwaga: Jeśli Twój serwer ogranicza połączenia przychodzące (firewall, biała lista IP), upewnij się, że dostęp z adresów IP Smartsupp (pobieranie feedów) jest dozwolony: 94.130.187.58 i 188.245.65.74. W przeciwnym razie Mira AI Shopping Assistant nie pobierze Twojego product feedu.

Te adresy czasem mogą się zmieniać. Jeśli feed nagle przestaje się aktualizować, sprawdź bieżącą listę w tym artykule lub skontaktuj się z naszym supportem.

Obsługiwane formaty product feedów

Mira AI Shopping Assistant obsługuje dwa standardowe formaty product feedów – Heuréka i Google Merchant. Oba wykorzystują popularne konwencje XML:

Rozszerzenie pliku to .xml lub .rss.
Pierwsza linia musi zaczynać się od <?xml ...?> lub <rss ...>.
Jeden główny tag obejmuje wszystkie produkty. Może mieć dowolną nazwę (np. <SHOP>) – liczy się sam fakt istnienia.
Każdy produkt jest w osobnym tagu (patrz dalsze sekcje dla formatów).

Minimalny poprawny szkielet wygląda tak:

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

Ważne: Jeśli brakuje obowiązkowego tagu w produkcie, cały produkt jest pomijany przez Mira AI Shopping Assistant – odwiedzający go nie zobaczą w rekomendacjach. Upewnij się, że każdy produkt zawiera wszystkie wymagane tagi.

Struktura feedu Heuréka

W formacie Heuréka Mira AI Shopping Assistant odczytuje następujące tagi. Zobacz oficjalną dokumentację XML Heuréka po pełne specyfikacje.

Kategoria	Tagi	Uwagi
Tag główny (obowiązkowy)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Każdy produkt obejmuje jeden z tych tagów.
Opis (obowiązkowy)	`PRODUCTNAME` (lub `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Każdy tag musi być wypełniony. Puste tagi są uznawane za brakujące.
Dobrowolne	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = dostępny od ręki, 1–7 = dostępny w ciągu tygodnia, inne lub brak = niedostępny. `PARAM` można powtarzać dowolnie dużo razy w produkcie.
Zdjęcie	`IMGURL`	Zdjęcie produktu widoczne na karcie. Jeśli go nie ma, Mira AI Shopping Assistant korzysta ze zdjęcia Open Graph lub wyróżnionego na stronie produktu.
Ignorowane	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI Shopping Assistant ignoruje te tagi – możesz zostawić je w feedzie dla innych narzędzi.

Tag PARAM przenosi dodatkowy atrybut produktu jako parę nazwa–wartość:

<PARAM> <PARAM_NAME>Szerokość</PARAM_NAME> <VAL>100–109 cm</VAL> </PARAM>

Struktura feedu Google Merchant

W formacie Google Merchant Mira AI Shopping Assistant odczytuje następujące tagi. Zobacz oficjalne wytyczne Google Merchant po pełną specyfikację.

Kategoria	Tagi	Uwagi
Tag główny (obowiązkowy)	`item`, `entry`, `product`	Każdy produkt obejmuje jeden z tych tagów.
Opis (obowiązkowy)	`title`, `description`, `product_type` (lub `google_product_category`), `link`, `price`	Dla kategorii użyj `product_type` lub `google_product_category` z nazwą tekstową – identyfikatory numeryczne nie są jeszcze obsługiwane.
Format ceny	`price`	Dopuszczalny format: `236 CZK` lub `CZK 236`. Dopuszczalne są także przecinki i kropki, np. `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` lub `1 049,00 CHF`. Waluta to 3-literowy kod (CZK, EUR, GBP…).
Cena promocyjna (opcjonalnie)	`sale_price`, `sale_price_effective_date`	Jeśli obecny jest `sale_price` (ta sama waluta, niższa niż `price`), Mira AI Shopping Assistant podaje cenę promocyjną w odpowiedziach, wyszukiwaniach i kartach produktów. Jeśli jest `sale_price_effective_date`, cena promocyjna jest pokazywana tylko w tym okresie (sprawdzenie w czasie pytania); poza nim lub jeśli zakresu nie da się odczytać, Mira AI Shopping Assistant pokazuje cenę regularną. Istniejące feedy pobiorą ceny promocyjne przy kolejnej aktualizacji.
Dobrowolne	`availability`	Dostępny: `in_stock`, `in stock`. Niedostępny: `out_of_stock`, `out of stock`, `preorder`, `backorder`, inne lub brak.
Zdjęcie	`image_link`	Zdjęcie produktu widoczne na karcie. Brak zdjęcia – Mira AI Shopping Assistant sięga po Open Graph lub zdjęcie wyróżnione na stronie produktu.
Ignorowane	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI Shopping Assistant pomija te tagi – możesz zostawić je w feedzie dla innych narzędzi.

Mira AI Shopping Assistant odczytuje także rozmiary produktów z feedu (tag size) i może wspomnieć o nich w rekomendacjach. Rozmiary pojawią się po odświeżeniu feedu.

Uwaga: Numeryczne identyfikatory google_product_category nie są jeszcze obsługiwane. Zawsze używaj wersji tekstowej kategorii – na przykład "Apparel & Accessories > Clothing > Shirts & Tops" – lub skorzystaj z product_type.

Eksport feedu według platformy

Znajdź swoją platformę e-commerce w tabeli poniżej i skorzystaj z oficjalnego poradnika eksportu.

Platforma	Co generuje	Oficjalny poradnik
Shoptet	Heuréka & Google Shopping XML z panelu administracyjnego	XML Feeds • Heuréka XML
Shopsys	Product feedy tworzone przez platformę (z dokumentacją developerską)	Product Feeds
Eshop-rychle	Feedy dla porównywarek cenowych	Product Export
Upgates	Eksport danych XML (pełna struktura produktu)	Data Export • XML Docs
Shoper	Google product feed bezpośrednio z platformy	Google Feed
Shopware	Google Shopping — eksport bezpośredni lub przez dodatki	Direct Export • Add-ons
Shoprenter	Google Shopping & Heuréka feedy	Google Shopping • Heuréka
PrestaShop	Google Shopping za pomocą dodatków	Add-ons
Magento	Google Shopping przez rozszerzenia	Extensions
WooCommerce	Google Product Feed przez dodatki	Add-ons • Recommended

Co dalej?

Wprowadzenie do Mira AI Shopping Assistant — skonfiguruj Mira AI Shopping Assistant i dodaj swój product feed jako źródło.
Jak zacząć trening Mira AI Shopping Assistant — dostosuj odpowiedzi AI poprzez własne pary Pytanie–Odpowiedź.
Mira AI Shopping Assistant – dostępność produktu w magazynie — pozwól odwiedzającym sprawdzać dostępność towaru.
FAQ Mira AI Shopping Assistant — najczęstsze pytania o Mira AI Shopping Assistant.

💡 Potrzebujesz więcej pomocy? Skontaktuj się z zespołem supportu — z chęcią pomożemy!

Artykuły powiązane

Jak wyeksportować product feedy z różnych platform e-commerce do Mira AI Shopping Assistant?