Nápověda menu

XML feed

Co je to XML feed

XML feed je datový formát, který slouží pro uchovávání, zpracování nebo předávání strukturovaných informací mezi systémy. Na jedné straně je zdroj informací, který generuje obsah XML feedu do souboru s koncovkou .xml, a na straně druhé je systém nebo i několik systémů zpracovávajících data z generovaného souboru. My se zaměříme na přenos produktových dat mezi webovým řešením (standardně e-shopem) a Sklikem, abychom mohli efektivně pracovat s dynamickým retargetingem a dynamickým bannerem. U těchto typů kampaní se bez vstupních produktových dat neobejdeme.

Jednotlivé informace do XML zapisujeme ve formě takzvaných tagů, jejichž dvojice vždy otevírá a uzavírá blok s informací a tyto tagy pak tvoří stromovou strukturu celého XML souboru. Sklik nezpracovává XML napřímo, ale využívá zpracování na straně Zboží.cz, na který je datově napojen. Musíme se tak řídit strukturou XML, kterou má Zboží.cz definovánu ve své specifikaci.

Kde získat XML feed

U webových řešení je XML feed předáván formou URL odkazu na konkrétní soubor, jehož obsah je v nastavených intervalech přegenerován s aktuálními daty z nabídky.

Feed je nejčastěji generován přímo z databáze e-shopu. Nevíte-li, jak XML feed získat, poraďte se se svým webmasterem, nebo se obraťte na poskytovatele platformy pro váš e-shop. 

Struktura XML feedu

Správná struktura značek v XML feedu a také množství a korektnost informací, které jsou v nich uvedené, přispívá k efektivitě jakékoli kampaně ve Zboží.cz.

Správnost svého XML feedu si můžete zkontrolovat v našem validátoru. Jednotlivé nabídky XML feedu doporučujeme odřádkovat, v případě výskytu chyby pak validátor může konkrétně informovat, na kterém konkrétním řádku se vyskytuje. 

Při zpracování XML feedu neukládáme duplicitní nabídky, ty posuzujeme podle shodného názvu v tagu PRODUCTNAME a shodné hodnoty v tagu ITEM_ID.

Vytvořený XML feed je vždy třeba nahrát na web tak, aby si z jeho URL adresy mohlo Zboží.cz pravidelně stahovat informace o jednotlivých nabídkách. Frekvenci stahování lze nastavit v rozmezí 1x až 12x denně. Celkový počet nabídek v XML feedu není omezen.

Nepodporujeme XML feedy pro Heureku, Google nákupy, Facebook atd. XML feed musí být dle specifikace Zboží.cz.

Ověření správnosti feedu

XML soubor si můžeme otevřít v textovém editoru nebo některém z webových prohlížečů (Prohlížeč Seznam.cz, Chrome, Mozilla, apod.). Webové prohlížeče obsahují XML parser, který nám obsah přeloží a pokud neobsahuje žádné závažné chyby, zobrazí jej v přehledné struktuře.

Ujistěte se, že obrázky ve feedu jsou funkční a mají podporovaný formát. Tedy JPEG, PNG nebo WEBP. V opačném případě by produktové kampaně nefungovaly správně.

Pozor:

Pokud je XML soubor příliš velký, může ovlivnit funkčnost prohlížeče, či jej dokonce zastavit. Pokud víte, že je XML soubor datově obsáhlý, doporučujeme jej rovnou otevírat v některém ze základních textových editorů – např. v Poznámkovém bloku.

Pro přesnější ověření doporučujeme využít Validátor pro Zboží.cz.

Validátor xml feedu

Vzor XML feedu

<?xml version="1.0" encoding="utf-8"?>
 <!-- kódování zadejte dle použitého typu ("utf-8", "windows-1250" ...). Doporučené a výchozí je utf-8 -->
 <SHOP xmlns="http://www.zbozi.cz/ns/offer/1.0">
 <SHOPITEM>
 <ITEM_ID>62448</ITEM_ID>
 <PRODUCTNAME>Solartent MC234CZ/A premium Beige</PRODUCTNAME>
 <PRODUCT>Stínítko z laminátových prutů Solartent MC234CZ/A premium Berige </PRODUCT>
 <DESCRIPTION>Velmi praktické stínítko s lehkou konstrukcí z laminátových prutů.</DESCRIPTION>
 <CATEGORYTEXT>Dům, byt a zahrada | Zahrada | Stínící technika | Zahradní slunečníky</CATEGORYTEXT>
 <EAN>8594061743744</EAN>
 <PRODUCTNO>MC234CZ/A</PRODUCTNO>
 <MANUFACTURER>Solartent</MANUFACTURER>
 <URL>http://example.com/slunecniky/solartent123</URL>
 <DELIVERY_DATE>0</DELIVERY_DATE>
 <DELIVERY>
 <DELIVERY_ID>DPD_PICKUP</DELIVERY_ID>
 <DELIVERY_PRICE>100</DELIVERY_PRICE>
 <DELIVERY_PRICE_COD>149</DELIVERY_PRICE_COD>
 </DELIVERY>
 <EXTRA_MESSAGE>free_gift</EXTRA_MESSAGE>
 <FREE_GIFT_TEXT>Powerbanka ADATA s kapacitou 12500 mAh</FREE_GIFT_TEXT>
 <EXTRA_MESSAGE>extended_warranty</EXTRA_MESSAGE>
 <PARAM>
 <PARAM_NAME>barva</PARAM_NAME>
 <VAL>Béžová</VAL>
 </PARAM>
 <IMGURL>http://example.com/obrazky/slunecniky/solartent123.jpg</IMGURL>
 <PRICE_VAT>1290</PRICE_VAT>
 <MAX_CPC>6,50</MAX_CPC>
 <MAX_CPC_SEARCH>5,80</MAX_CPC_SEARCH>
 </SHOPITEM>
 <SHOPITEM>
 <!-- popis druhé nabídky... -->
 </SHOPITEM>
 <!-- ... -->
 </SHOP>

Nástroje na optimalizaci XML feedů

V některých případech potřebujeme obsah XML feedu optimalizovat, abychom mohli využít produktová data na maximum. Optimalizaci provádíme úpravou dat, které v XML generujeme a to buď přímo na straně webového řešení nebo je možné využít některý z dostupných nástrojů, který přebírá XML feed přímo z webového řešení a do výstupního XML feedu aplikuje podmínky, které si v nástroji definujeme. Můžeme tak snadno upravovat jednotlivé elementy nabídek.

Cesta dat při optimalizaci XML feedu

Nástroje na optimalizaci XML feedu:

Potřebujete další pomoc?

Pokud si stále nevíte rady, obraťte se na naše specialisty. 95 % vašich dotazů umíme vyřešit do 2 hodin.