Przejdź do głównej zawartości

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

Znajdź oficjalny przewodnik eksportu feedu produktowego, sprawdź jakie tagi czyta Mira AI i połącz feed z Mira AI.

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 formaty feedów, które Mira AI akceptuje, tagi, które czyta, i gdzie znaleźć oficjalne instrukcje eksportu z najpopularniejszych platform e-commerce.

Podzieliliśmy ten przewodnik na następujące sekcje:


Zanim zaczniesz

Mira AI przyjmuje standardowe feedy produktowe XML — ten sam format, jaki 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.

Wskazówka: Gdy masz już URL feedu, wklej go jako źródło typu Feed produktowy XML w zakładce Sources Mira AI — pełną konfigurację znajdziesz we Wprowadzeniu do Mira AI.

Uwaga: Obrazy w product card w czacie są ładowane ze strony produktu (przez link parser), nie z samego feedu. Upewnij się, że Twoje strony produktów mają poprawne obrazy Open Graph lub featured.


Obsługiwane formaty feedów

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

  • Rozszerzenie pliku to .xml lub .rss.

  • Pierwsza linia musi zaczynać się od <?xml ...?> lub <rss ...>.

  • Jeden tag nadrzędny otacza wszystkie elementy produktów. Tag nadrzędny może mieć dowolną nazwę (np. <SHOP>) — liczy się tylko jego istnienie.

  • Każdy produkt jest otoczony 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 w produkcie 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 wszystkie wymagane tagi wypełnione.


Struktura feedu Heuréka

W formacie Heuréka Mira AI czyta następujące tagi. Pełną specyfikację znajdziesz w oficjalnej dokumentacji feedu XML Heuréka.

Kategoria

Tagi

Uwagi

Item wrapper (obowiązkowe)

SHOPITEM, PRODUCT, PRODUKT

Jeden z tych tagów otacza każdy produkt.

Opis (obowiązkowe)

PRODUCTNAME (lub PRODUCT), DESCRIPTION, URL, PRICE_VAT, CATEGORYTEXT

Każdy tag musi zawierać treść. Puste tagi liczą się jako brakujące.

Opcjonalne

DELIVERY_DATE, PARAM

DELIVERY_DATE: 0 = w magazynie, 1–7 = dostępny w ciągu tygodnia, cokolwiek innego / brak = niedostępny. PARAM może powtarzać się dowolną liczbę razy na produkt.

Ignorowane

DELIVERY, EAN, ITEM_ID, IMGURL, VAT, ITEMGROUP_ID, ACCESSORY, MANUFACTURER

Mira AI pomija te tagi — możesz zostawić 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

W formacie Google Merchant Mira AI czyta następujące tagi. Pełne odniesienie znajdziesz w oficjalnej specyfikacji feedu Google Merchant.

Kategoria

Tagi

Uwagi

Item wrapper (obowiązkowe)

item, entry, product

Jeden z tych tagów otacza każdy produkt.

Opis (obowiązkowe)

title, description, product_type (lub google_product_category), link, price

W przypadku 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ępny: out_of_stock, out of stock, preorder, backorder, cokolwiek innego / brak.

Ignorowane

id, gtin, checkout_link_template, image_link, item_group_id

Mira AI pomija te tagi — możesz zostawić je 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 na liście poniżej i postępuj zgodnie z oficjalnym przewodnikiem eksportu.

Shoptet

Shoptet generuje standardowe feedy XML bezpośrednio z panelu admina — przydatne zarówno dla Google Shopping, jak i Heuréki.

Shopsys

Shopsys eksportuje feedy produktowe przez platformę z czytelną dokumentacją dla deweloperów.

Eshoprychle (eshop-rychle)

Eshop-rychle ma szczegółowe instrukcje eksportu feedów do porównywarek cen.

Upgates

Upgates obsługuje eksport danych z e-sklepów, a dokumentacja obejmuje pełną strukturę XML produktu.

Shoper

Shoper ułatwia generowanie feedu produktowego Google bezpośrednio z platformy.

Shopware

Shopware pozwala eksportować feedy Google Shopping bezpośrednio przez platformę lub przez add-ony.

Shoprenter

Shoprenter obsługuje eksport feedów Google Shopping i Heuréki, z kompleksowymi wskazówkami w help centrum.

PrestaShop

PrestaShop oferuje kilka add-onów do eksportu produktów do Google Shopping. Oto popularna opcja:

Magento

Magento ma kilka rozszerzeń do eksportu feedów produktowych, w tym tę popularną opcję:

WooCommerce

WooCommerce obsługuje eksport feedu produktowego Google przez add-ony. Dokumentacja WooCommerce zaleca oficjalny Google Product Feed add-on.


Co dalej?

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

Czy to odpowiedziało na twoje pytanie?