Specifikace
Význam jednotlivých značek
Nepovinná, nutno uvádět pouze pokud používáte jiné kódování než UTF-8. České Windows typicky ukládají soubory v kódování windows-1250.
je nutné uvést přesné znění
Uvádějte s parametrem xmlns=“http://www.zbozi.cz/ns/offer/1.0″, který značí, že jde o XML feed vytvořený podle aktuální specifikace.
<SHOP xmlns="http://www.zbozi.cz/ns/offer/1.0"> <SHOPITEM><!-- ... --></SHOPITEM> <SHOPITEM><!-- ... --></SHOPITEM> <!-- ... --> </SHOP>
Následující značky popisují vlastnosti položky ve vašem feedu, přidávají se dovnitř elementu.
<SHOPITEM> ... </SHOPITEM>
doporučená délka 70 znaků, maximum 255 znaků
Obecné pojmenování výrobku z pohledu spotřebitele bez rozšiřujících údajů eshopu. Musí obsahovat všechny potřebné údaje tak, aby byla nabídka pomocí názvu odlišitelná od ostatních nabídek v XML feedu, a řídí se jednotnou šablonou rozlišenou pro různé kategorie produktů (viz Pravidla pojmenování nabídek). Základní šablona platná pro většinu kategorií je
Výrobce (Produktová řada) Produktové označení Varianta
Do názvu uveďte skutečného výrobce dílu, nikoli značku, se kterou jsou vaše produkty kompatibilní. Informace o kompatibilitě s určitými značkami můžete uvést do atributu ‘popis’ <DESCRIPTION>.
<PRODUCTNAME>SONY Playstation 3 320GB</PRODUCTNAME>
doporučená délka 250-1024 znaků
Textový popis jednotlivé nabídky ve formátu čistého textu s odřádkováním odstavců. Musí obsahovat výhradně informace o výrobku v českém jazyce. Začátek popisu by měl v několika větách obsahovat hlavní výhody daného produktu.
Popis nesmí obsahovat:
- reklamní texty a slogany týkající se internetového obchodu
- nadměrně se opakující klíčová slova nebo fráze (dvakrát či vícekrát za sebou)
V popisku není žádoucí opakovat název výrobce, modelové označení výrobku. Nevkládejte zde také informace týkající se dárků, pro ně je určena značka EXTRA_MESSAGE. Není povolena nadměrná interpunkce, použití emotikonů nebo ukončení věty třemi tečkami. Za tečkami a čárkami musí být mezery, jak je běžné v českých textech.
<DESCRIPTION>Herní konzole s vysokým výkonem a obrovskou nabídkou her...</DESCRIPTION>
URL adresa, která odkazuje na stránku nabídky v e-shopu.
URL nesmí obsahovat znaky české diakritiky, mezery a jiné nestandardní znaky.
Každá nabídka, včetně jejích variant, musí mít svou unikátní URL adresu.
Tagování URL pomocí UTM parametrů při biddování ze Zboží.cz.
<URL>http://example.com/slunecniky/solartent123</URL>
číselná hodnota, max. dvě desetinná místa
Konečná cena v Kč včetně DPH a poplatků. Při uvedení více desetinných míst budou přebytečná desetinná místa odříznuta. Pro oddělení řádu korun a haléřů je možné použít desetinnou čárku i tečku.
<PRICE_VAT>5786</PRICE_VAT> <PRICE_VAT>5786.90</PRICE_VAT> <PRICE_VAT>5786,35</PRICE_VAT>
celé číslo nebo datum ve formátu RRRR-MM-DD
pro bazarové položky je povinné uvádět hodnotu 0 (skladem)
Doba vyřízení objednávky musí být uváděna jako doba od přijetí objednávky do expedice zboží. Číselná hodnota je systémem automaticky převáděna na textové vyjádření. U předobjednávek a připravovaných produktů uvádějte datum uvedení na trh ve formátu RRRR-MM-DD.
Podporované hodnoty v tagu DELIVERY_DATE
Hodnota 0 (skladem)
Přípustná hodnota na webu e-shopu
- skladem
- skladem u dodavatele, expedice do 24 hodin
- skladem v expedičním skladu, expedice do 24 hodin
- skladem na prodejně
- ihned (k odběru)
- expedice do 24 hodin
- počet kusů > 0
Hodnota 1-3 (do 3 dnů)
Přípustná hodnota na webu e-shopu
- skladem (expedice do 3 pracovních dnů)
- obvykle skladem
- skladem u dodavatele
- obvykle do 3 dnů
- 1-3 dny
Hodnota 4-7 (do týdne)
Přípustná hodnota na webu e-shopu
- skladem, dodání do 4-7 pracovních dnů
- do 7 dnů
- skladem (expedice do týdne)
- obvykle skladem
- obvykle expedujeme do 7 dnů
- 4-7 dnů
- do týdne
Hodnota 8 a více (za více než týden)
Přípustná hodnota na webu e-shopu
- 8 a více dní
- na objednávku
- do 30 dní
Datum ve formátu RRRR-MM-DD (za více než týden)
Přípustná hodnota na webu e-shopu
- předobjednávka + datum uvedení na trh
- připravujeme + datum uvedení na trh
- vychází + datum uvedení na trh
Hodnota -1 (neznámá dostupnost)
Přípustná hodnota na webu e-shopu
- neznámá
<DELIVERY_DATE>0</DELIVERY_DATE> <DELIVERY_DATE>3</DELIVERY_DATE> <DELIVERY_DATE>25</DELIVERY_DATE> <DELIVERY_DATE>2017-12-24</DELIVERY_DATE>
doporučujeme uvádět
bazarové nabídky musí mít minimální velikost obrázku 800×600 px, tzn. i u obrázků na výšku musí mít kratší strana 800px
URL adresa obrázku, který nabídku věrně zobrazuje. Součástí obrázku nesmí být vodoznaky, loga obchodů, reklamní nápisy ani jiné výrazné grafické prvky. Obrázek může být ve formátu JPEG, PNG nebo WEBP, ostatní formáty nejsou podporovány. Doporučený rozměr obrázku je alespoň 425×440 px (v případě nestandardních obrázků je potřeba dodržet alespoň 1 z rozměrů). Pokud změníte obrázek bez změny IMGURL, na Zboží.cz zůstává původní obrázek.
<IMGURL>http://example.com/obrazky/slunecniky/solartent123.jpg</IMGURL>
doporučujeme uvádět, značku je možné opakovat
akceptujeme pouze prvních 20 obrázků
Další URL adresy obrázků, které nabídku věrně zobrazují. Takto označené obrázky bereme jako další a budou zobrazeny na detailu nabídky a budou použity i pro produktové karty.
Obrázek může být ve formátu JPEG, PNG nebo WEBP, ostatní formáty nejsou podporovány. Doporučený rozměr obrázku je alespoň 425×440 px (v případě nestandardních obrázků je potřeba dodržet alespoň 1 z rozměrů), stejně jako u IMGURL. Pokud změníte obrázek bez změny IMGURL_ALTERNATIVE, na Zboží.cz zůstává původní obrázek.
<IMGURL_ALTERNATIVE>http://example.com/obrazky/destnik1/solartent123.jpg</IMGURL_ALTERNATIVE> <IMGURL_ALTERNATIVE>http://example.com/obrazky/destnik2/solartent123.jpg</IMGURL_ALTERNATIVE> <IMGURL_ALTERNATIVE>http://example.com/obrazky/destnik3/solartent123.jpg</IMGURL_ALTERNATIVE>
maximální zobrazovaná délka 64 znaků
Název nabídky, který musí odpovídat její povaze. Musí obsahovat všechny potřebné údaje, aby byla nabídka pomocí názvu odlišitelná od ostatních nabídek v XML feedu. Může obsahovat informace, které jsou specifické pro daný obchod, např. „+ dárek zdarma“. Jde ve své podstatě o rozvětvenou značku PRODUCTNAME včetně přívlastků. Tento název bude použit v případě, že se nabídka nespáruje a bude se zobrazovat v nabídkách.
Do názvu uveďte skutečného výrobce dílu, nikoli značku, se kterou jsou vaše produkty kompatibilní. Informace o kompatibilitě s určitými značkami můžete uvést do atributu ‘popis’ [description].
Název nesmí obsahovat:
- reklamní slogany a superlativy (např. „nejlevnější obchod“)
- nadměrně se opakující klíčová slova či fráze (dvakrát či vícekrát za sebou)
- nadměrnou interpunkci, emotikony, tři tečky a vykřičníky
- informace, které přímo nesouvisí s nabídkou
Maximální zobrazovaná délka je 64 znaků, přičemž za tečkami a čárkami musejí být mezery, jak je běžné v českých textech. V názvu položky zboží smí být pouze jeden vykřičník. Před vykřičníkem nesmí být mezera.
Výrobce konkrétní nabídky, pomáhá při filtraci značky v konkrétní kategorii. Podmínky pro založení značky naleznete v sekci značky na Zboží.cz.
<MANUFACTURER>Apple</MANUFACTURER> <MANUFACTURER>Bosch</MANUFACTURER> <MANUFACTURER>Dell</MANUFACTURER>
Na Zboží.cz máme definovaný seznam dopravců a sítí výdejních míst, které podporujeme. Dopravcem může být i eshop sám (podporujeme pouze dopravce s dopravou po celé ČR), stejně tak může prezentovat síť svých výdejních míst.
Podporované hodnoty výdejních míst
Název | DELIVERY_ID |
AlzaBox | ALZABOX |
Balíkovna | CESKA_POSTA_BALIKOVNA |
Česká pošta | CESKA_POSTA_NA_POSTU |
DPD Pickup | DPD_PICKUP |
GLS Parcelshop | GLS_PARCELSHOP |
PPL ParcelShop | PPL_PARCELSHOP |
Toptrans Depo | TOPTRANS_DEPO |
WE|DO Point | WEDO_POINT |
Zásilkovna | ZASILKOVNA |
Vlastní výdejní místa | VLASTNI_VYDEJNI_MISTA |
Podporované hodnoty dopravců
Název | DELIVERY_ID |
123 kurýr | 123_KURYR |
Česká pošta | CESKA_POSTA |
Balíkovna na adresu | BALIKOVNA_NA_ADRESU |
DB_SCHENKER | DB_SCHENKER |
DPD | DPD |
DHL | DHL |
DSV | DSV |
Emons | EMONS |
FOFR | FOFR |
Gebrüder Weiss | GEBRUDER_WEISS |
Geis | GEIS |
GLS | GLS |
HDS | HDS |
WE|DO HOME | WEDO_HOME |
Náš kurýr | NAS_KURYR |
MESSENGER | MESSENGER |
PPL | PPL |
TNT | TNT |
TOPTRANS | TOPTRANS |
UPS | UPS |
FedEx | FEDEX |
Raben Logistics | RABEN_LOGISTICS |
RHENUS | RHENUS |
Zásilkovna (na adresu) | ZASILKOVNA_NA_ADRESU |
Vlastní přeprava | VLASTNI_PREPRAVA |
DELIVERY_ID identifikátor dopravce nebo sítě výdejních míst ze seznamu podporovaných
DELIVERY_PRICE cena s DPH za dopravu nebo vyzvednutí položky při platbě předem
DELIVERY_PRICE_COD cena s DPH za dopravu nebo vyzvednutí položky při platbě na dobírku
Vlastní přepravu je možné uvést pouze v případě, že zásilku můžete doručit po celé České republice.
Pokud pro nabídku, dopravce nebo výdejní místo není dobírka možná, by neměl být tag DELIVERY_PRICE_COD u nabídky uveden. Stejně tak pokud není možné nabídku na výdejní místo nebo konkrétním dopravcem doručit, nesmí být u této nabídky tag uveden (např. nadrozměrné položky).
<DELIVERY> <DELIVERY_ID>DPD_PICKUP</DELIVERY_ID> <DELIVERY_PRICE>100</DELIVERY_PRICE> <DELIVERY_PRICE_COD>149</DELIVERY_PRICE_COD> </DELIVERY>
povinné pro všechny bazarové nabídky
Unikátní identifikátor (alfanumerické znaky) nabídky v rámci eshopu, typicky např. ID položky ve skladovém systému, je povolena jakákoli kombinace znaků [0-9, a-z, A-Z, _ , -], tedy čísel nula až devět, malých a velkých písmen bez diakritiky, a také podtržítka a pomlčky.
Díky této značce budete schopni vždy jednoznačně identifikovat nabídku a sledovat její historii a výkon v rámci služby Zboží.cz, i když se změní její URL či název. Proto je klíčové, aby zůstala stejná i v případě změny názvu stejného výrobku inzerovaného v nabídce, XML feedu a jeho URL nebo e-shopového řešení. V případě, že se změní nabídka na jiný inzerovaný výrobek a to i v případě změny barvy, velikosti atd. je zapotřebí změnit ITEM_ID, aby se nabídka automaticky odpárovala z neodpovídající produktové karty.
<ITEM_ID>62448</ITEM_ID> <ITEM_ID>Ohpai9Aecuux</ITEM_ID>
maximální délka 500 znaků
Samostatné nabídky budeme moci zařadit do výpisu příslušné kategorie pouze v případě, u nichž je uveden CATEGORYTEXT, který bude odpovídat názvu kategorií z našeho číselníku.
V XML feedu je povoleno u jedné nabídky uvádět pouze 10 hodnot tagu CATEGORYTEXT.
Strojově čitelný strom kategorií Zboží.cz je průběžně aktualizovaný na adrese https://www.zbozi.cz/static/categories.json či ke stažení ve formátu pro MS Excel https://www.zbozi.cz/static/categories.csv.
Do feedu je potřeba uvádět kompletní cestu kategorie ze stromu kategorií Zboží.cz. Jako oddělovač slouží svislá čára | (tzv. pipe)
<CATEGORYTEXT>Foto | Fotoaparáty a videokamery | Digitální fotoaparáty | Digitální kompakty</CATEGORYTEXT> <CATEGORYTEXT>Foto | Fotoaparáty a videokamery | Blesky</CATEGORYTEXT>
číselná hodnota, max. dvě desetinná místa
Nejnižší cena za posledních 30 dní před začátkem slevy v Kč včetně DPH a poplatků. Při uvedení více desetinných míst budou přebytečná desetinná místa odříznuta. Pro oddělení řádu korun a haléřů je možné použít desetinnou čárku i tečku.
Podmínky, pro zobrazení informace o slevě:
- je správně zadaná prodejní (zlevněná) <PRICE_VAT>
- cena v akci je nižší než nejnižší prodejní cena za posledních 30 dní před začátkem slevové akce
- sleva není starší než 30 dní
- výše slevy je v rozmezí 5% – 90%
Informace o slevě se zobrazí v detailech produktů, stejně jako u příslušné nabídky ve Zboží inzerátech.
<PRICE_BEFORE_DISCOUNT>5786</PRICE_BEFORE_DISCOUNT> <PRICE_BEFORE_DISCOUNT>5786.90</PRICE_BEFORE_DISCOUNT> <PRICE_BEFORE_DISCOUNT>5786,35</PRICE_BEFORE_DISCOUNT>
Slouží k uvedení informace o možnosti využití slevového kódu na uplatnění slevy pro konkrétní nabídku. Informace o slevovém kuponu se zobrazí u nabídek na Zboží.cz a ve Zboží inzerátech.
Pravidla pro slevový kupon
– kupon musí být v e-shope viditelně uveden
– využití kuponu na straně e-shopu není ničím dalším podmíněno
– musí být platný pro danou nabídku, u které je uveden
– pro plošnou slevu může být využít stejný kupon u všech nabídek
Značka <SALES_VOUCHER> má následující povinné atributy:
<CODE>
string
Kód, který uživatel zadá ve vašem e-shopu. Může být kombinace textu s číslem, maximálně v délce 24 znaků. Pro optimální zobrazení a použití doporučujeme kratší řetězec, do 12 znaků.
<PRICE_WITH_VOUCHER>
číselná hodnota, v Kč, max. dvě desetinná místa
Zlevněná cena po uplatnění slevového kuponu.
<DATE_FROM>
Datum od kdy kupon platí
<DATE_TO>
Datum do kdy kupon platí
Oba datumy se uvádí ve formátu RRRR-MM-DD
<TEXT>
maximální délka je 128 znaků
Obsahuje popis akce, slevy, ke ktere je kupon vázán.
<SALES_VOUCHER> <CODE>SLEVA10</CODE> <PRICE_WITH_VOUCHER>9999</PRICE_WITH_VOUCHER> <DATE_FROM>2024-04-01T00:00:00</DATE_FROM> <DATE_TO>2024-04-30T23:59:59</DATE_TO> <TEXT>Týden značky, dodatečná sleva 10 % na vybrané TV a soundbary platí do 31. 3. 2024 nebo do vyprodání zásob.</TEXT> </SALES_VOUCHER>
možné opakovat
Slouží k uvedení doplňkových informací o nabídce. Podporované hodnoty se zobrazují u nabídek na Zboží.cz. Informace o vybrané EXTRA_MESSSAGE musí být uvedena na vašem webu.
Texty (např. „Dárek zdarma“) se také zobrazují u dané nabídky ve Zboží inzerátech a Dynamickém banneru Skliku. Zároveň se ve Zboží inzerátech u nabídky zobrazí štítek „Akce“.
EXTRA_MESSAGE v produktovém detailu – zobrazujeme více výhod najednou.
Podporované hodnoty <EXTRA_MESSAGE>
Hodnota | Text zobrazovaný na Zboží.cz |
free_gift | Dárek zdarma |
extended_warranty | Prodloužená záruka |
voucher | Voucher na další nákup |
free_accessories | Příslušenství zdarma |
free_case | Pouzdro zdarma |
free_installation | Montáž zdarma |
extended_return | Prodloužená doba na vrácení |
free_return | Vrácení s dopravou zdarma |
premium_installation | Odborná instalace spotřebiče |
appliance_pickup | Odvoz starého spotřebiče |
authorized_service | Autorizovaný servis |
split_payment | Možnost nákupu na splátky |
pay_later | Možnost odložené platby |
gift_package | Dárkové balení |
custom | Jiné |
- dárek zdarma (free_gift)
- příslušenství zdarma (free_accessories)
- voucher na další nákup (voucher)
- jiné (custom)
FREE_GIFT_TEXT, FREE_ACCESSORIES_TEXT, VOUCHER_TEXT rozšíří EXTRA_MESSAGE o textovou informaci s omezením na 160 znaků, kde lze uvést, o jaký konkrétní dárek nebo příslušenství se jedná.
CUSTOM_TEXT lze použít na rozšíření EXTRA_MESSAGE o textovou informaci o dalších doplňkových službách poskytovaných u nabídky, které nejsou explicitně uvedeny ve zbylých hodnotách značky. Do popisu je možné uvést více služeb do maximálního počtu 160 znaků.
Hodnota tagu | Příklad volitelného textu |
FREE_GIFT_TEXT | Obal na mobilní telefon |
FREE_ACCESSORIES_TEXT | Originální síťový kabel kompatibilní s tímto zařízením |
VOUCHER_TEXT | 100 Kč na další nákup |
CUSTOM_TEXT | Výnos do patra, Věrnostní program |
Aby se daná EXTRA_MESSAGE s textovou informací zobrazila na webu, je podmíněno přítomností příslušné EXTRA_MESSAGE ve feedu. Jedná se o volitelné nové tagy. Maximální četnost není limitována.
<EXTRA_MESSAGE>free_gift</EXTRA_MESSAGE> <FREE_GIFT_TEXT>Powerbanka ADATA s kapacitou 12500 mAh</FREE_GIFT_TEXT>
GTIN, Global Trade Item Number – Globální číslo obchodní položky
Akceptováno je osmi-, dvanácti-, třinácti-, nebo čtrnáctimístné číslo bez mezer.
Globální číslo obchodní položky GTIN (často nesprávně nazývané EAN) je určeno k mezinárodní identifikaci obchodních položek v následujících formátech:
GTIN-8 – 8 číslic, kóduje se v čárovém kódu EAN-8
GTIN-13 – 13 číslic, kóduje se v čárovém kódu EAN-13
GTIN-14 – 14 číslic, kóduje se v čárovém kódu ITF-14, GS1-128 nebo GS1 DataBar
V USA a Kanadě se používá GTIN-12 (12 číslic) pro čárové kódy UPC-A a UPC-E.
Nástroj pro výpočet kontrolních číslic naleznete zde: https://www.gs1cz.org/vypocet-kontrolni-cislice
<EAN>8594061743744</EAN>
strukturovaná značka, možné opakovat
Dodatečné parametry, které mohou být použity k filtrování produktů na webu Zboží.cz.
Značka <PARAM>
má následující podznačky:
<PARAM_NAME>
povinné, název parametru
např. délka, objem, velikost, barva, určení
<VAL>
povinné, hodnota parametru
např. 110, 500, XXL, černé, dětské
<UNIT>
nepovinné, jednotka parametru
např. cm, ml, GB, MHz
Parametry produktů rozlišované pro jednotlivé kategorie si můžete stáhnout ve formátu CSV (kódování UTF-8) nebo JSON.
<PARAM> <PARAM_NAME>FM rádio</PARAM_NAME> <VAL>Ano</VAL> </PARAM> <PARAM> <PARAM_NAME>velikost paměti</PARAM_NAME> <VAL>32</VAL> <UNIT>GB</UNIT> </PARAM> <PARAM> <PARAM_NAME>barva</PARAM_NAME> <VAL>černá</VAL> </PARAM> <PARAM> <PARAM_NAME>rozlišení</PARAM_NAME> <VAL>1920 x 1080 (FHD)</VAL> </PARAM>
povinné pro všechny erotické nabídky
Tímto tagem se označují všechny erotické nabídky.
Chcete-li, aby se vaše erotické nabídky zobrazovaly v erotických kategoriích, použijte u nich tag EROTIC s hodnotou 1 a zároveň vyplňte tag CATEGORYTEXT.
<EROTIC>1</EROTIC>
povinné pro všechny bazarové, rozbalené a repasované nabídky (nabídky se budou zobrazovat na službě Sbazar a ve Zboží inzerátech)
new – nové zboží (nepovinný tag)
open_box (rozbalené) – zboží rozbalené za účelem předvádění či focení pro e-shop nebo vrácené jinými zákazníky. Žádné nebo jen drobné stopy používání. Kompletní příslušenství. Nemusí mít originální obal. Zákonná záruka.
used (použité) – zboží se stopami používání. Plně funkční. Obsah balení nemusí být kompletní, obsahuje ale příslušenství nutné k provozu. Může mít poškozený nebo neoriginální obal. Obrázek by měl zobrazovat reálný stav, neměl by být ilustrační. Zákonná záruka.
refurbished (repasované) – odborně opravené nebo renovované zboží. Může mít stopy používání, je ale plně funkční. Obrázek by měl zobrazovat reálný stav, neměl by být ilustrační. Zákonná záruka.
Aby se mohly inzeráty na Sbazaru vydávat, je třeba splňovat pravidla pro inzerci rozbaleného a použitého zboží.
<CONDITION>new</CONDITION> <CONDITION>open_box</CONDITION> <CONDITION>used</CONDITION> <CONDITION>refurbished</CONDITION>
povinné pro všechny bazarové, rozbalené a repasované nabídky
doporučená délka cca 200 znaků, maximum 2000 znaků
Textový popis stavu zboží. Nejedná se o popis nabídky!
Popis závad inzerované nabídky, tedy čím se stav nabízeného zboží liší od zcela nového výrobku, včetně stavu balení či přiloženého příslušenství.
Příklad:
<CONDITION_DESC>Vráceno ve lhůtě 14 dnů. Prasklý plastový kryt vysavače v zadní části, v příslušenství chybí vůně do vysavače. Originální obalový materiál je lehce potrhaný.</CONDITION_DESC>
povinné pro všechny bazarové, rozbalené a repasované nabídky
Číselná hodnota musí vyjadřovat počet měsíců záruky, kterou e-shop garantuje při zakoupení zboží.
Doživotní záruka: 999
Příklad:
<WARRANTY>12</WARRANTY>
Označení produktu uváděné výrobcem (Manufacturer Part Number, MPN). Tímto označením výrobce jedinečným způsobem identifikuje produkt. Akceptována je libovolná kombinace čísel a písmen.
<PRODUCTNO>MC234CZ/A</PRODUCTNO> <PRODUCTNO>VGNNS31S/S.CEZ</PRODUCTNO> <PRODUCTNO>60002456</PRODUCTNO> <PRODUCTNO>8834A001AA</PRODUCTNO>
Mezinárodní standardní číslo knihy ve formátu ISBN-10 nebo ISBN-13. Akceptováno je desetimístné nebo třináctimístné číslo, buď bez mezer, nebo může být jako oddělovač skupin použita mezera či pomlčka. Oddělovače však nesmějí být kombinovány.
<ISBN>9781444102451</ISBN> <ISBN>978-1-78038-067-4</ISBN> <ISBN>978 1 86201 559 3</ISBN>
Označuje skupinu nabídek, které vzájemně představují varianty. Variantou považujeme všechny nabídky stejného výrobce, řady, názvu a se shodnou cenovou úrovní, přičemž se liší odchylkou jednoho parametru.
Např.
Název Nordblanc Sprinter NBLC59 červené
Varianta 42
Výjimkou jsou případy, kdy je variantní vazba stanovena přímo výrobcem či je definována přístupem trhu k segmentu.
Např.
Název Apple iPhone 5S
Varianta 16 GB Stříbrný
Pro označení skupiny variantních nabídek je povolena jakákoli kombinace maximálně 36 znaků [0-9, a-z, A-Z, _ , -] tedy čísel nula až devět, malých a velkých písmen bez diakritiky, podtržítka a pomlčky.
Tato značka je velmi důležitá při tvorbě variant jednotlivých nabídek a její uvádění významně přispívá ke zkvalitnění dodávaných dat i prezentace nabídek ve službě Zboží.cz. V sekci Oblečení a móda lze pomocí tagu <ITEMGROUP_ID> slučovat přímo skupiny nabídek a je možné tak přispět k přehlednějšímu náhledu na nabídky.
Příklad struktury XML feedu při označení variant pomocí ITEMGROUP_ID:
<SHOPITEM> <PRODUCTNAME>Apple iPod Touch (5. gen.) 16GB - Space Gray</PRODUCTNAME> <!-- ... --> <ITEMGROUP_ID>oerjn641ern</ITEMGROUP_ID> </SHOPITEM> <SHOPITEM> <PRODUCTNAME>Apple iPod Touch (5. gen.) 32GB Pink</PRODUCTNAME> <!-- ... --> <ITEMGROUP_ID>oerjn641ern</ITEMGROUP_ID> </SHOPITEM> <SHOPITEM> <PRODUCTNAME>Apple iPod Touch (5. gen.) 64GB Blue</PRODUCTNAME> <!-- ... --> <ITEMGROUP_ID>oerjn641ern</ITEMGROUP_ID> </SHOPITEM>
číselná hodnota, max. dvě desetinná místa
Prodejní cena | Cena za proklik |
do 200 Kč | 0,60 Kč |
do 500 Kč | 1,20 Kč |
do 1 000 Kč | 1,80 Kč |
do 2 500 Kč | 2,40 Kč |
do 10 000 Kč | 3,00 Kč |
nad 10 000 Kč | 3,60 Kč |
Každoročně v období hlavní sezóny (od října do ledna) je cena za proklik účtovaná podle sezónního ceníku. Sezónní ceník pro rok 2024/2025 připravujeme.
Poznámka: Pokud si e-shop nastaví maximální cenu za proklik, kterou je ochoten pro danou nabídku v produktu nebo fulltextu zaplatit, systém spočítá cenu prokliku, která je nutná k udržení na dané pozici (second-price). Použije-li zákazník řazení od nejlevnější nabídky, účtuje se pouze ceníková cena.
<MAX_CPC>23.50</MAX_CPC>
číselná hodnota, max. dvě desetinná místa
Prodejní cena | Cena za proklik |
do 200 Kč | 0,60 Kč |
do 500 Kč | 1,20 Kč |
do 1 000 Kč | 1,80 Kč |
do 2 500 Kč | 2,40 Kč |
do 10 000 Kč | 3,00 Kč |
nad 10 000 Kč | 3,60 Kč |
Každoročně v období hlavní sezóny (od října do ledna) je cena za proklik účtovaná podle sezónního ceníku. Sezónní ceník pro rok 2024/2025 připravujeme.
Poznámka: Pokud si e-shop nastaví maximální cenu za proklik, kterou je ochoten pro danou nabídku zaplatit, systém spočítá cenu prokliku, která je nutná k udržení na dané pozici (second-price). Použije-li zákazník řazení od nejlevnější nabídky, účtuje se pouze ceníková cena.
<MAX_CPC_SEARCH>23.50</MAX_CPC_SEARCH>
možné opakovat
Identifikátor výdejního místa, ve kterém je nabídka skladem k okamžitému osobnímu odběru. Na takovém výdejním místě musí být možné výrobek prohlédnout, vyzkoušet a případně reklamovat. Je-li identifikátor vyplněn a u nabídky je zároveň ve značce DELIVERY_DATE uvedena hodnota 0 (skladem), na webu Zboží.cz je možné ji dohledat pomocí filtru „Na prodejně“.
Identifikátor výdejního místa je ID z Firmy.cz. V administraci Zboží.cz v záložce „Sortiment“ – „Doprava“ – vpravo 3 tečky – „Nastavení míst“ – „Identifikátor“. Zde naleznete přehled ID Firmy.cz, které se použije jako identifikátor do XML feedu.
<SHOPITEM> <!-- ... --> <SHOP_DEPOTS>554875</SHOP_DEPOTS> </SHOPITEM> <SHOPITEM> <!-- ... --> <SHOP_DEPOTS>554875</SHOP_DEPOTS> <SHOP_DEPOTS>12822045</SHOP_DEPOTS> </SHOPITEM>
Název značky.
Tato značka slouží v XML feedu pro specifické případy licencování značky (Hello Kitty, Star Wars), nebo samostatné značky jednoho výrobce.
Např.
výrobce Henkel, značky Persil, Ariel, Perwoll
výrobce Coca-Cola, značky Coca-Cola, Fanta, Sprite, Kinley, Schweppes
maximálně 250 znaků
Označí vybrané nabídky libovolným textem a tím z nich vytvoří skupinu (např.: podle prodejnosti, sezóny, slevy…). Tento tag slouží k filtraci nabídek pro Dynamický banner a Dynamický retargeting na službě Sklik. Pro každou nabídku lze mít jeden <CUSTOM_LABEL_0>
, <CUSTOM_LABEL_1>.
<SHOPITEM>
<PRODUCTNAME>Slunečník Solartent premium Beige</PRODUCTNAME>
<!-- ... -->
<CUSTOM_LABEL_0>Letni akce</CUSTOM_LABEL_0>
<CUSTOM_LABEL_1>Vysoká prodejnost</CUSTOM_LABEL_1>
</SHOPITEM>
maximálně 25 znaků
Tato hodnota se zobrazuje uživatelům u dané nabídky v Dynamickém banneru a Dynamickém retargetingu Skliku. Na rozdíl od značek <CUSTOM_LABEL_0>
a <CUSTOM_LABEL_1>
s ní není možné filtrovat v produktových skupinách v Skliku.
Příklady hodnot
sleva, výprodej, novinka, bestseller, montáž zdarma, Řecko – Rhodos, zbývá 12 kusů, viz dynamický banner na službě Sklik.
Pro každou nabídku lze mít jeden <CUSTOM_LABEL_3>
.
<SHOPITEM> <PRODUCTNAME>Slunečník Solartent premium Beige</PRODUCTNAME> <!-- ... --> <CUSTOM_LABEL_0>Letni akce</CUSTOM_LABEL_0> <CUSTOM_LABEL_1>Vysoká prodejnost</CUSTOM_LABEL_1> <CUSTOM_LABEL_3>Výprodej</CUSTOM_LABEL_3> </SHOPITEM>
k použití pro rozšiřování produktové databáze; jednotlivé části jsou oddělované znakem pipe |
Řada a její podřada definovaná dle výrobce. Typicky jde o rodinu produktů, které výrobce sdružil pod jednotný název.
Např.
Latitude
iPod | iPod Touch
ThinkPad | Edge
k použití pro rozšiřování produktové databáze; datum a čas ve formátu RRRR-MM-DDTHH:MM:SS
Datum oficiálního zahájení prodeje výrobku pro Českou republiku. Uvádí se ve formátu RRRR-MM-DDTHH:MM:SS, při neuvedení času se bere půlnoc.
<RELEASE_DATE>2015-04-27T09:18:46</RELEASE_DATE> <RELEASE_DATE>2015-03-14</RELEASE_DATE>
XML feed bez povinných tagů není možné pro inzerci na Zboží.cz využít.
Všechny doporučené tagy zvyšují kvalitu vašeho XML feedu a tím i kvalitu vaší kampaně na Zboží.cz. Zároveň se zvýší pravděpodobnost zobrazení vašich nabídek ve výsledcích hledání.