Mira AI Shopping Assistant używa Twojego feedu produktowego do polecania produktów, odpowiadania na pytania o ceny i sprawdzania dostępności. Ten przewodnik wyjaśnia, jakie formaty feedów akceptuje Mira AI, które tagi odczytuje i gdzie znaleźć oficjalne instrukcje eksportu z najpopularniejszych platform e-commerce.

Przewodnik podzieliliśmy na następujące części:

Zanim zaczniesz

Mira AI akceptuje standardowe feedy produktowe XML — ten sam format, który większość platform e-commerce generuje dla Heuréki, Google Shopping, Zboží.cz i podobnych porównywarek. Im bogatszy feed (cena, dostępność, opis, link, kategoria), tym mądrzejsze rekomendacje Miry.

Aby dodać feed w Smartsupp:

W builderze asystenta otwórz Knowledge base → XML Product feed i kliknij Add new source.
Wpisz nazwę źródła.
Wklej pełny adres URL swojego feedu produktowego.
W kroku Update wybierz, jak często feed ma się odświeżać.

Wskazówka: Pełną konfigurację znajdziesz w artykule Wprowadzenie do Mira AI.

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

Uwaga: Mira AI ładuje obrazy kart produktowych bezpośrednio z Twojego feedu XML. Jeśli produkt nie ma obrazu w feedzie, Mira sięga po obraz Open Graph lub wyróżniony ze strony produktu — warto więc mieć je również ustawione.

Uwaga: Jeśli Twój serwer ogranicza połączenia przychodzące (firewall, lista dozwolonych IP), zezwól na dostęp z adresów IP, z których Smartsupp pobiera feedy: 94.130.187.58 i 188.245.65.74. W przeciwnym razie Mira AI nie pobierze Twojego feedu.

Obsługiwane formaty feedów

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

Rozszerzenie pliku to .xml lub .rss.
Pierwsza linia musi zaczynać się od <?xml ...?> lub <rss ...>.
Wszystkie produkty otacza jeden tag nadrzędny. Może nazywać się dowolnie (np. <SHOP>) — liczy się tylko jego istnienie.
Każdy produkt jest opakowany we własny tag (zobacz sekcje dla poszczególnych formatów poniżej).

Minimalny poprawny szkielet wygląda tak:

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

Ważne: Jeśli produktowi brakuje obowiązkowego tagu, cały produkt jest pomijany w indeksie Miry — odwiedzający nie zobaczą go w rekomendacjach. Upewnij się, że każdy produkt ma wypełnione wszystkie wymagane 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
Opakowanie produktu (obowiązkowe)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Jeden z tych tagów otacza każdy produkt.
Opis (obowiązkowe)	`PRODUCTNAME` (or `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Każdy tag musi mieć zawartość. 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 / brak = niedostępne. `PARAM` może się powtarzać dowolną liczbę razy na produkt.
Obraz	`IMGURL`	Obraz produktu na karcie. Jeśli go brakuje, Mira sięga po obraz Open Graph lub wyróżniony ze strony produktu.
Ignorowane	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI pomija te tagi — możesz je zostawić w feedzie dla innych narzędzi.

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

<PARAM> <PARAM_NAME>Width</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ą specyfikację znajdziesz w oficjalnej specyfikacji feedu Google Merchant.

Kategoria	Tagi	Uwagi
Opakowanie produktu (obowiązkowe)	`item`, `entry`, `product`	Jeden z tych tagów otacza każdy produkt.
Opis (obowiązkowe)	`title`, `description`, `product_type` (or `google_product_category`), `link`, `price`	Dla kategorii użyj `product_type` lub `google_product_category` z nazwą tekstową — numeryczne ID kategorii nie są jeszcze obsługiwane.
Format ceny	`price`	Dozwolony format: `236 CZK` lub `CZK 236`. Waluta to 3-literowy kod (CZK, EUR, GBP…).
Opcjonalne	`availability`	W magazynie: `in_stock`, `in stock`. Niedostępne: `out_of_stock`, `out of stock`, `preorder`, `backorder`, cokolwiek innego / brak.
Obraz	`image_link`	Obraz produktu na karcie. Jeśli go brakuje, Mira sięga po obraz Open Graph lub wyróżniony ze strony produktu.
Ignorowane	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI pomija te tagi — możesz je zostawić w feedzie dla innych narzędzi.

Uwaga: Numeryczne ID google_product_category nie są jeszcze obsługiwane. Zawsze używaj tekstowej wersji kategorii — np. „Apparel & Accessories > Clothing > Shirts & Tops" — albo użyj product_type.

Eksport feedu według platformy

Znajdź swoją platformę e-commerce w tabeli poniżej i postępuj zgodnie z oficjalną instrukcją eksportu.

Platforma	Co generuje	Oficjalna instrukcja
Shoptet	XML Heuréka & Google Shopping z panelu administracyjnego	XML Feeds • Heuréka XML
Shopsys	Feedy produktowe na poziomie platformy z dokumentacją deweloperską	Product Feeds
Eshop-rychle	Feedy dla porównywarek cen	Product Export
Upgates	Eksport danych XML z pełną strukturą produktów	Data Export • XML Docs
Shoper	Feed produktowy Google bezpośrednio z platformy	Google Feed
Shopware	Google Shopping — eksport bezpośredni lub przez dodatki	Direct Export • Add-ons
Shoprenter	Feedy Google Shopping & Heuréka	Google Shopping • Heuréka
PrestaShop	Google Shopping przez dodatki	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 Mirę AI i dodaj feed produktowy jako źródło.
Jak zacząć trenować Mirę AI — dopracuj odpowiedzi AI własnymi parami pytanie–odpowiedź.
Mira AI – dostępność magazynowa — pozwól odwiedzającym sprawdzić, czy produkt jest dostępny.
FAQ Mira AI Shopping Assistant — częste pytania o Mirę AI.

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

Artykuły powiązane

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