XML feed
Také známé jako: XML export, XML soubor, nabídkové XML
XML feed je produktový feed zapsaný ve formátu XML — textovém formátu, kde je každý údaj o produktu uzavřený ve vlastní pojmenované značce. Je to nejrozšířenější formát pro srovnávače a reklamní platformy na českém trhu.
Kdy formát XML řešit
Prakticky vždy, když napojuješ srovnávač nebo reklamní platformu na českém trhu — Heureka, Seznam Nákupy, Glami i Google Shopping pracují s XML. CSV se používá spíš pro interní přenosy a importy, protože se snáz čte v tabulkovém editoru, ale hůř nese vnořené struktury jako varianty a parametry.
Jak XML feed vypadá
Soubor začíná deklarací kódování, pak následuje kořenový prvek a uvnitř jednotlivé produkty. Každé pole má vlastní značku:
<SHOPITEM>
<ITEM_ID>ABC-123</ITEM_ID>
<PRODUCTNAME>Název produktu</PRODUCTNAME>
<PRICE_VAT>1299</PRICE_VAT>
<URL>https://example.cz/produkt</URL>
</SHOPITEM>
Názvy značek určuje specifikace konkrétního kanálu a nedají se volit. Google používá vlastní jmenný prostor s prefixem g:, české srovnávače většinou variantu struktury SHOPITEM.
Popisy produktů obsahují HTML, které by strukturu XML rozbilo. Řeší se to obalením do <![CDATA[ … ]]>, kde se obsah nebere jako značky, nebo převodem znaků na entity.
Nejčastější chyby
- Nezakódované HTML v popisu. Jedna značka
<br>mimo CDATA a validátor odmítne celý soubor. Kanál pak nestáhne nic, ne jen jeden produkt. - Cena s jednotkou nebo s mezerou.
1 299 Kčnení číslo. Kanál pole buď ignoruje, nebo produkt zamítne. - Jiné kódování než UTF-8. Diakritika se rozsype v celém feedu a názvy produktů jsou nečitelné.
- Feed za přihlášením nebo blokovaný. Kanál se k souboru nedostane a napojení tiše přestane fungovat.
- Feed generovaný na požádání u velkého katalogu. Vyprší časový limit a stažení skončí neúplným souborem. U velkých katalogů se feed generuje předem a servíruje jako statický soubor.
Shoptet a Upgates
Upgates. Import i export podporují XML a CSV; maximální velikost importního souboru je 100 MB. XML má povinné jen kořeny <PRODUCTS> a <PRODUCT>, u nově zakládaných produktů navíc <TITLE> a atribut language. HTML se předává přes CDATA nebo entity, číselné hodnoty bez jednotek. Pro test struktury je k dispozici XSD schéma. (Ověř aktuální stav.)
Časté otázky
Proč mi kanál odmítá celý feed kvůli jednomu produktu?
Protože XML je strukturovaný dokument. Chybná značka rozbije parsování a soubor přestane být čitelný jako celek — nejde vzít jen tu platnou část.
Kdy použít CSV místo XML?
U interních přenosů a hromadných importů, kde chceš data otevřít v tabulce. Pro srovnávače a reklamní platformy je standardem XML.
Musí být feed veřejně dostupný?
Kanál se k němu musí dostat. Někteří umí přihlášení nebo přístup přes vyhrazenou adresu, ale nejběžnější je veřejná URL s obtížně uhodnutelnou cestou.
Související pojmy
- Produktový feed – Produktový feed je strukturovaný soubor s daty o produktech e-shopu, kterým se katalog předává externím systémům — srovnávačům, reklamním platformám a marketplace. Externí systém si ho v pravidelných intervalech stahuje a podle něj aktualizuje, co o produktech ví a jak je zobrazuje.
- Import produktů – Import produktů je hromadné vložení nebo aktualizace položek katalogu ze souboru nebo přes rozhraní. Zásadní je párovací klíč — údaj, podle kterého systém pozná, jestli produkt zakládá nový, nebo přepisuje existující.
- Export produktů – Export produktů je vytažení dat z katalogu do souboru nebo rozhraní pro použití jinde — pro srovnávače, pro účetnictví, pro dodavatele nebo jako záloha před hromadnou úpravou. Na rozdíl od feedu nemusí mít pevnou strukturu danou cizím systémem.
- Mapování dat – Mapování dat je určení, které pole zdrojového systému odpovídá kterému poli cílového — a co se má stát s poli, která protějšek nemají. Je to místo, kde se rozhoduje o kvalitě každého importu, exportu i migrace.
- Diagnostika feedu – Diagnostika feedu je pravidelná kontrola toho, kolik produktů kanál z feedu skutečně přijal, kolik jich zamítl a proč. Je to jediný způsob, jak zjistit, že část sortimentu tiše vypadla — počet položek ve feedu totiž neříká nic o tom, kolik se jich reálně zobrazuje.
- API – API je rozhraní, přes které spolu programy komunikují přímo, bez člověka a bez souborů. U e-shopu umožňuje číst a měnit data v reálném čase — vytvořit objednávku, upravit sklad, načíst produkty — na rozdíl od feedu, který je jednosměrný snímek.
Další pojmy ze skupiny Feedy & integrace
- APIAPI je rozhraní, přes které spolu programy komunikují přímo, bez člověka a bez souborů. U e-shopu umožňuje číst a měnit data v reálném čase — vytvořit objednávku, upravit sklad, načíst produkty — na rozdíl od feedu, který je jednosměrný snímek.
- API klíčAPI klíč je přístupový údaj, kterým se integrace prokazuje při komunikaci s rozhraním. Určuje nejen to, kdo se připojuje, ale i co smí — a proto by měl mít každé napojení vlastní klíč s minimem oprávnění.
- Datová migraceDatová migrace je převod obsahu e-shopu z jednoho systému do druhého — produktů, kategorií, zákazníků, objednávek a jejich vzájemných vazeb. Nejtěžší na ní nejsou samotná data, ale vazby mezi nimi a pole, která v cílovém systému nemají protějšek.
- Diagnostika feeduDiagnostika feedu je pravidelná kontrola toho, kolik produktů kanál z feedu skutečně přijal, kolik jich zamítl a proč. Je to jediný způsob, jak zjistit, že část sortimentu tiše vypadla — počet položek ve feedu totiž neříká nic o tom, kolik se jich reálně zobrazuje.
- ERPERP je podnikový systém, ve kterém firma vede sklad, objednávky, fakturaci a účetnictví na jednom místě. U e-shopu bývá zdrojem pravdy o skladu a cenách, zatímco e-shop je prodejní kanál — a rozhodnutí, který systém co určuje, je základ jakéhokoli napojení.
- Export produktůExport produktů je vytažení dat z katalogu do souboru nebo rozhraní pro použití jinde — pro srovnávače, pro účetnictví, pro dodavatele nebo jako záloha před hromadnou úpravou. Na rozdíl od feedu nemusí mít pevnou strukturu danou cizím systémem.