Mira AI Shopping Assistant wykorzystuje Twój feed produktowy do polecania produktów, odpowiadania na pytania o ceny i sprawdzania dostępności. Ten przewodnik wyjaśnia formaty feedów obsługiwane przez Mira AI, tagi które odczytuje oraz gdzie znaleźć oficjalne instrukcje eksportu dla najpopularniejszych platform e-commerce.

Przewodnik podzieliliśmy na następujące sekcje:

Zanim zaczniesz

Mira AI akceptuje standardowe feedy produktowe XML — ten sam format, który większość platform e-commerce generuje dla Heuréka, Google Shopping, Zboží.cz i podobnych marketplace'ów. Im bogatszy Twój feed (cena, dostępność, opis, link, kategoria), tym inteligentniejsze będą rekomendacje Miry.

Aby dodać feed w Smartsupp:

Otwórz zakładkę Mira AI Sources i dodaj nowe źródło XML Product feed.
Wpisz nazwę źródła.
Wybierz format feedu (Heuréka lub Google Merchant).
Wklej pełny adres URL feedu produktowego.

Wskazówka: Pełna konfiguracja: Wprowadzenie do Mira AI.

Mira AI automatycznie odświeża Twój feed produktowy w regularnych odstępach czasu — zmiany cen, aktualizacje dostępności i nowe produkty pojawiają się w czacie bez konieczności ponownego przesyłania pliku.

Uwaga: Mira AI ładuje obrazy kart produktowych bezpośrednio z Twojego feedu XML. Jeśli produkt nie ma obrazu w feedzie, Mira użyje zastępczo obrazu Open Graph lub featured ze strony produktu — dlatego warto mieć je również skonfigurowane.

Uwaga: Jeśli Twój serwer ogranicza połączenia przychodzące (firewall, biała lista IP), zezwól na dostęp z adresów IP feed-fetchera Smartsupp: 94.130.187.58 i 188.245.65.74. W przeciwnym razie Mira AI nie będzie mogła pobrać Twojego feedu produktów.

Obsługiwane formaty feedów

Mira AI obsługuje dwa standardowe formaty feedów produktowych — Heuréka i Google Merchant. Oba przestrzegają typowych konwencji XML:

Rozszerzenie pliku to .xml lub .rss.
Pierwsza linia musi zaczynać się od <?xml ...?> lub <rss ...>.
Jeden tag rodzicielski obejmuje wszystkie elementy produktów. Nazwa jest dowolna (np. <SHOP>) — liczy się tylko istnienie.
Każdy produkt jest opakowany własnym tagiem item (zobacz sekcje specyficzne dla formatu poniżej).

Minimalny prawidłowy 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, cały produkt jest wykluczany z indeksu Miry — odwiedzający nie zobaczą go w rekomendacjach. Upewnij się, że każdy produkt ma wypełnione wszystkie obowiązkowe tagi.

Struktura feedu Heuréka

Dla formatu Heuréka, Mira AI odczytuje następujące tagi. Pełną specyfikację znajdziesz w oficjalnej dokumentacji feedu XML Heuréka.

Kategoria	Tagi	Uwagi
Wrapper item (obowiązkowy)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Jeden z tych tagów obejmuje każdy produkt.
Opis (obowiązkowy)	`PRODUCTNAME` (lub `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Każdy tag musi zawierać wartość. Puste tagi liczą się jako brakujące.
Opcjonalne	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = w magazynie, 1–7 = dostępne w ciągu tygodnia, cokolwiek innego / brakujące = niedostępne. `PARAM` może być powtarzany dowolną liczbę razy na produkt.
Obraz	`IMGURL`	Obraz produktu wyświetlany na karcie. Jeśli go brakuje, Mira użyje obrazu Open Graph lub featured ze strony produktu.
Ignorowane	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI pomija te tagi — możesz pozostawić je w feedzie dla innych narzędzi.

Tag PARAM niesie dodatkowy atrybut produktu jako parę nazwa-wartość:

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

Struktura feedu Google Merchant

Dla formatu Google Merchant, Mira AI odczytuje następujące tagi. Pełną referencję znajdziesz w oficjalnej specyfikacji feedu Google Merchant.

Kategoria	Tagi	Uwagi
Wrapper item (obowiązkowy)	`item`, `entry`, `product`	Jeden z tych tagów obejmuje każdy produkt.
Opis (obowiązkowy)	`title`, `description`, `product_type` (lub `google_product_category`), `link`, `price`	Dla kategorii użyj `product_type` lub `google_product_category` z tekstową nazwą — numeryczne ID kategorii nie są jeszcze obsługiwane.
Format ceny	`price`	Dozwolony format: `236 PLN` lub `PLN 236`. Waluta to trzyliterowy kod (PLN, EUR, CZK, GBP…).
Opcjonalne	`availability`	W magazynie: `in_stock`, `in stock`. Niedostępne: `out_of_stock`, `out of stock`, `preorder`, `backorder`, cokolwiek innego / brakujące.
Obraz	`image_link`	Obraz produktu wyświetlany na karcie. Jeśli go brakuje, Mira użyje obrazu Open Graph lub featured ze strony produktu.
Ignorowane	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI pomija te tagi — możesz pozostawić je w feedzie dla innych narzędzi.

Uwaga: Numeryczne ID google_product_category nie są jeszcze obsługiwane. Zawsze używaj tekstowej wersji kategorii — na przykład "Apparel & Accessories > Clothing > Shirts & Tops" — lub użyj product_type zamiast tego.

Eksport feedu według platformy

Znajdź swoją platformę e-commerce w poniższej tabeli i postępuj zgodnie z oficjalnym przewodnikiem eksportu.

Platforma	Co generuje	Oficjalny przewodnik
Shoptet	XML Heuréka i Google Shopping z panelu administracyjnego	Feedy XML • Heuréka XML
Shopsys	Feedy produktowe przez platformę z dokumentacją deweloperską	Feedy produktowe
Eshop-rychle	Feedy dla porównywarek cen	Eksport produktów
Upgates	Eksport danych XML z pełną strukturą produktu	Eksport danych • Dokumentacja XML
Shoper	Feed produktów Google bezpośrednio z platformy	Feed Google
Shopware	Google Shopping — bezpośredni eksport lub przez add-ony	Bezpośredni eksport • Add-ony
Shoprenter	Feedy Google Shopping i Heuréka	Google Shopping • Heuréka
PrestaShop	Google Shopping przez add-ony	Add-ony
Magento	Google Shopping przez rozszerzenia	Rozszerzenia
WooCommerce	Google Product Feed przez add-ony	Add-ony • Polecane

Co dalej?

Wprowadzenie do Mira AI Shopping Assistant — skonfiguruj Mira AI i dodaj swój feed produktowy jako źródło.
Jak zacząć trenować Mira AI — dopracuj odpowiedzi AI za pomocą własnych par Q&A.
Mira AI - dostępność w magazynie — pozwól odwiedzającym sprawdzić, czy produkt jest w magazynie.
Mira AI Shopping Assistant FAQ — częste pytania o Mira AI.

💡 Potrzebujesz dodatkowej pomocy? Skontaktuj się z naszym zespołem wsparcia — chętnie pomożemy!

Artykuły powiązane

FAQ asystenta zakupów Mira AI

Mira AI – dostępność produktów

Jak wyeksportować pliki produktowe z platform e-commerce dla MiraAI