Přeskočit na hlavní obsah

Jak exportovat produktový feed z různých e-shopových platforem pro MiraAI

Najděte oficiální návod k exportu produktového feedu, zjistěte, jaké tagy Mira AI čte, a propojte feed s Mira AI Shopping Assistantem.

Mira AI Shopping Assistant používá váš produktový feed k doporučování produktů, odpovídání na dotazy k cenám a ověřování dostupnosti. Tento návod vysvětluje, jaké formáty feedů Mira AI přijímá, které tagy čte a kde najdete oficiální návody na export z nejpoužívanějších e-commerce platforem.

Návod jsme rozdělili do následujících částí:


Než začnete

Mira AI přijímá standardní XML produktové feedy — stejný formát, jaký většina e-commerce platforem generuje pro Heuréku, Google Shopping, Zboží.cz a podobné srovnávače. Čím bohatší feed (cena, dostupnost, popis, odkaz, kategorie), tím chytřejší budou doporučení Miry.



Přidání feedu do Smartsuppu:

  1. V builderu asistenta otevřete Zdroje znalostí → XML Produktový katalog a klikněte na Přidat nový zdroj dat.

  2. Zadejte název zdroje.

  3. Vložte úplnou URL adresu vašeho produktového feedu.

  4. V kroku Aktualizace zvolte, jak často se má feed obnovovat.


Tip: Kompletní nastavení najdete v článku Představení Mira AI.


Mira AI váš produktový feed automaticky obnovuje v pravidelných intervalech — změny cen, aktualizace dostupnosti i nové produkty se v chatu objeví bez nutnosti soubor znovu nahrávat.

Poznámka: Mira AI načítá obrázky produktových karet přímo z vašeho XML feedu. Pokud produkt ve feedu obrázek nemá, Mira sáhne po Open Graph nebo hlavním obrázku na stránce produktu — vyplatí se je tedy mít nastavené.

Poznámka: Pokud váš server omezuje příchozí spojení (firewall, IP allowlist), povolte přístup z IP adres, ze kterých Smartsupp feedy stahuje: 94.130.187.58 a 188.245.65.74. Jinak si Mira AI feed nedokáže stáhnout.


Podporované formáty feedů

Mira AI podporuje dva standardní formáty produktových feedů — Heuréka a Google Merchant. Oba se řídí běžnými XML konvencemi:

  • Přípona souboru je .xml nebo .rss.

  • Úplně první řádek musí začínat <?xml ...?> nebo <rss ...>.

  • Všechny produkty obaluje jeden rodičovský tag. Může se jmenovat jakkoliv (např. <SHOP>) — důležitá je jen jeho existence.

  • Každý produkt je zabalený ve vlastním tagu (viz sekce k jednotlivým formátům níže).

Minimální platná kostra vypadá takto:

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

Důležité: Pokud produktu chybí povinný tag, celý produkt se z indexu Miry vynechá — návštěvníci ho v doporučeních neuvidí. Zkontrolujte, že má každý produkt všechny povinné tagy vyplněné.


Struktura Heuréka feedu

U formátu Heuréka čte Mira AI následující tagy. Kompletní specifikaci najdete v oficiální dokumentaci Heuréka XML feedu.

Kategorie

Tagy

Poznámky

Obal produktu (povinný)

SHOPITEM, PRODUCT, PRODUKT

Každý produkt obaluje jeden z těchto tagů.

Popis (povinné)

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

Každý tag musí mít obsah. Prázdné tagy se počítají jako chybějící.

Volitelné

DELIVERY_DATE, PARAM

DELIVERY_DATE: 0 = skladem, 1–7 = dostupné do týdne, cokoliv jiného / chybí = nedostupné. PARAM se může u produktu libovolně opakovat.

Obrázek

IMGURL

Obrázek produktu na kartě. Pokud chybí, Mira sáhne po Open Graph nebo hlavním obrázku na stránce produktu.

Ignorované

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

Tyto tagy Mira AI přeskakuje — ve feedu je můžete nechat pro jiné nástroje.

Tag PARAM nese doplňkový atribut produktu jako pár název–hodnota:

<PARAM>
<PARAM_NAME>Width</PARAM_NAME>
<VAL>100–109 cm</VAL>
</PARAM>


Struktura Google Merchant feedu

U formátu Google Merchant čte Mira AI následující tagy. Kompletní referenci najdete v oficiální specifikaci Google Merchant feedu.

Kategorie

Tagy

Poznámky

Obal produktu (povinný)

item, entry, product

Každý produkt obaluje jeden z těchto tagů.

Popis (povinné)

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

Pro kategorii použijte product_type nebo google_product_category s textovým názvem — číselná ID kategorií zatím nejsou podporována.

Formát ceny

price

Povolený formát: 236 CZK nebo CZK 236. Měna je třípísmenný kód (CZK, EUR, GBP…).

Volitelné

availability

Skladem: in_stock, in stock. Nedostupné: out_of_stock, out of stock, preorder, backorder, cokoliv jiného / chybí.

Obrázek

image_link

Obrázek produktu na kartě. Pokud chybí, Mira sáhne po Open Graph nebo hlavním obrázku na stránce produktu.

Ignorované

id, gtin, checkout_link_template, item_group_id

Tyto tagy Mira AI přeskakuje — ve feedu je můžete nechat pro jiné nástroje.

Poznámka: Číselná ID google_product_category zatím nejsou podporována. Vždy použijte textovou verzi kategorie — např. „Apparel & Accessories > Clothing > Shirts & Tops" — nebo místo toho product_type.


Export feedu podle platformy

Najděte svou e-commerce platformu v tabulce níže a postupujte podle oficiálního návodu na export.

Platforma

Co generuje

Oficiální návod

Shoptet

Heuréka & Google Shopping XML z administrace

Shopsys

Produktové feedy na úrovni platformy s vývojářskou dokumentací

Eshop-rychle

Feedy pro zbožové srovnávače

Upgates

XML export dat s kompletní strukturou produktů

Shoper

Google produktový feed přímo z platformy

Shopware

Google Shopping — přímý export nebo přes doplňky

Shoprenter

Google Shopping & Heuréka feedy

PrestaShop

Google Shopping přes doplňky

Magento

Google Shopping přes rozšíření

WooCommerce

Google Product Feed přes doplňky


Co dál?

💡 Potřebujete poradit? Kontaktujte náš support tým — rádi pomůžeme!

Dostali jste odpověď na svou otázku?