Význam a požadavky na jednotlivé elementy


IDENTIFIKAČNÍ ČÍSLO (ID) *

ID je unikátní označení produktu v rámci e-shopu. Toto označení se nesmí měnit v průběhu spolupráce, jinak může dojít ke ztrátě historie produktu a také ke ztrátě pozice. Pokud se v XML feedu objeví více produktů se stejným ID, nedojde k aktualizaci dat, jelikož feed bude vyhodnocen jako chybný. 

V elementu je možné uvádět čísla, malá a velká písmena bez diakritiky a speciální znaky jako pomlčky a podtržítka.

Uvedení tohoto elementu je povinné.

Specifikace XML feedu Element
Heureka/Zboží <ITEM_ID>15a-diRE</ITEM_ID>
Google  <g:id>15a-diRE</g:id>
Compari/Árukereső: <identifier>15a-diRE</identifier>
Ceneo id=“15a-diRE″

OZNAČENÍ VARIANT

Označení variant produktu. Produkty, které jsou variantami jednoho produktu, mají unikátní ITEM_ID a mají stejné ITEMGROUP_ID.

Uvedení tohoto elementu je doporučené.

Specifikace XML feedu Element
Heureka/Zboží <ITEMGROUP_ID>ZD563</ITEMGROUP_ID>
Google  <g:item_group_id>ZD563</g:item_group_id>
Compari/Árukereső: <GroupId>ZD563</GroupId>
Ceneo v rámci specifikace není definováno

NÁZEV PRODUKTU *

Přesný název produktu. Pro správné zařazení do katalogu je třeba mít název produktu dostatečně popisný. Není vhodné uvedení jednoslovného názvu produktu, např. názvem kolekce či edice.

Název produktu může obsahovat označení výrobce či značky, ale nikoli název obchodu nebo URL adresu obchodu. Název by také neměl obsahovat informace jako skladem, výprodej, akce, doprava zdarma atp.

Uvedení tohoto elementu je povinné. 

Specifikace XML feedu Element

Heureka/Zboží

<PRODUCTNAME>Jednolůžková postel Merida 90 x 200 cm</PRODUCTNAME>
Google  <title>Jednolůžková postel Merida 90 x 200 cm</title>
Compari/Árukereső <Name>Jednolůžková postel Merida 90 x 200 cm</Name>
Ceneo <name>Jednolůžková postel Merida 90 x 200 cm</name>

POPISEK PRODUKTU *

Popisek produktu. Informace uvedené v něm by měly přímo reflektovat danou variantu produktu. Zde je dobré uvádět relevantní klíčová slova, která pomohou produkt zařadit i do filtrů. Popisek by měl být dostatečně podrobný, aby dokázal návštěvníkům podat dostatek informací pro rozhodnutí o koupi produktu.

V rámci popisu není povoleno uvádět:

  • kontaktní údaje,
  • odkazy,
  • jakákoli jiná reklamní sdělení.

Formátování popisku se nemusí importem dat z XML feedu zcela odstranit. Mohou být zachovány znaky kódu, a proto je zapotřebí posílat popisek bez formátování a odkazů (např. na další produkty či kontakty). Prověřit zobrazování textu lze na detailu produktu v katalogu FAVI. Obecně se do systému FAVI propisuje toto formátování textu:

Oddělení odstavce:
<p>text odstavce</p>

Přechod na nový řádek:
<br>nový řádek

Text kurzívou:
<i>text kurzívou</i>
<em>text kurzívou</em>

Tučné písmo:
<b>text je tučně.</b>
<strong>text je tučně.</strong>

Seznam v bodech:
<ul>
<li>Bod 1</li>
<li>Bod 2</li>
<li>Bod 3</li>
</ul>

Číslovaný seznam:
<ol>
<li>Bod 1</li>
<li>Bod 2</li>
<li>Bod 3</li>
</ol>

Jiné formátování není z XML feedu přebíráno. Další větší úpravy a formátování mohou text rozbít či znekvalitnit.

Uvedení tohoto elementu je povinné.

Specifikace XML feedu

Element

Heureka/Zboží

<DESCRIPTION>Masivní postel MERIDA v provedení buk patří …</DESCRIPTION>
Google <g:description>Masivní postel MERIDA v provedení buk patří …</g:description>

Compari/Árukereső

<Description>Masivní postel MERIDA v provedení buk patří …</Description>

Ceneo

<desc><![CDATA[Masivní postel MERIDA v provedení buk patří …]]></desc>


KATEGORIE *

Kategorie produktu. Kategorie primárně určuje zařazení produktu v katalogu, a proto je třeba ji uvádět co nejpřesněji. Zasílat je možné kategorie dle stromu kategorií FAVI a nebo lze také uvádět vlastní kategorie, jsou-li dostatečně podrobné. Do zápisu kategorie je žádoucí uvádět vždy celou cestu k produktu, např: Dětský pokoj > Dětské postele > Dětské postýlky. 

Do katalogu FAVI se automaticky načtou všechny produkty, které jsou uvedeny v XML feedu s vhodnou kategorií, validním odkazem, dostatečně velkým obrázkem a uvedenou cenou.

Pokud produkt nemá uvedenou kategorii, do katalogu se nenačte. 

Stromy kategorií pro všechny země jsou dostupné zde: 

Zamítnuty budou v rámci importu i tyto kategorie:

  • kategorie nehodící se do katalogu, 
  • kategorie uvedené velmi obecně (např. jako slevy, výprodej, akce apod.), 
  • kategorie, které nejsou v odpovídajícím jazyce. 

Kategorie by se neměly často měnit. Změnou kategorií dojde k vyřazení produktů z katalogu do doby, než jsou nově zaslané kategorie opětovně schválené. 

Uvedení tohoto elementu je povinné.

Specifikace XML feedu

Element

Heureka/Zboží

<CATEGORYTEXT>Ložnice > Postele</CATEGORYTEXT>

Google 

<g:google_product_category>Ložnice > Postele</g:google_product_category>

<g:product_type>Ložnice > Postele>jednolůžkové</g:product_type>

Compari/Árukereső

<Category>Ložnice > Postele</Category>

Ceneo

<cat>
<![CDATA[Ložnice > Postele]]>
</cat>

Pozn. V rámci Google feedu nezpracujeme číselně uvedené kategorie. V případě, že je zasílán element g:google_product_category i g:product_type, systém FAVI pro zařazení produktu přednostně vezme v potaz g: product_type.


CENA PRODUKTU (S DPH) *

Konečná prodejní cena včetně DPH. Systém zpracuje ceny uvedené pouze v těchto formátech: 

  • 8 000
  • 8000
  • 8000,70
  • 8000.70

Tečku neuvádějte jako oddělovač pro tisíce a miliony. Je určena pouze k oddělení desetinných míst. 

Systém automaticky nepřepočítává ceny pokud jsou uvedeny v jiné měně (i když je cena s měnou zaslána. např. ve tvaru 100 EUR). Měnu vždy automaticky systém přidává na základě platné měny dané země.

Uvedení tohoto elementu je povinné. 

Specifikace XML feedu Element
Heureka/Zboží <PRICE_VAT>4500</PRICE_VAT>
Google  <g:price>5500</g:price>
pokud je produkt ve slevě, uvádějte <g:sale_price>4500</g:sale_price>
Compari/Árukereső: <Price>4500</Price>
Ceneo price=“4500″

Pozn. Slevy u produktů v katalogu FAVI generuje automaticky systém na základě uložené historie základní ceny. Dojde-li ke snížení ceny v XML feedu, sníží se cena i u produktu na FAVI a vypočítá se výše slevy. Informace o slevách tedy nepřebíráme z žádného speciálního zápisu v XML feedu.


URL *

Specifikuje odkaz na produktovou stránku v e-shopu. Na landing page produktu musí být uvedena cena produktu, jeho dostupnost, bližší informace o produktu a tlačítko k zakoupení nebo objednání produktu.

URL adresa musí být v rámci XML feedu unikátní. I jednotlivé varianty jednoho produktu by měly mít vlastní url adresu.

Zaslaná adresa musí být validní tzn.:

  • nesmí obsahovat mezery,
  • diakritiku,
  • zvláštní znaky musí být nahrazeny odpovídajícími entitami (kombinace znaku procenta a dvojciferné hexadecimální číslice), jinak nedojde k načtení produktu do katalogu.

Uvedení tohoto elementu je povinné.

Specifikace XML feedu Element
Heureka/Zboží <URL>https://www.url.cz/merida.html#/90x200_cm</URL>
Google <link>https://www.url.cz/merida.html#/90x200_cm</link>
Compari/Árukereső: <Product_url>https://www.url.cz/merida.html#/90x200_cm</Product_url>
Ceneo url=“https://www.url.cz/merida.html#/90x200_cm″

HLAVNÍ OBRÁZEK *

Hlavní obrázek produktu, jako jedna z nejdůležitějších informací XML feedu, musí splňovat následující kritéria: 

1) Produkt na hlavním obrázku nesmí být v rozporu s jeho specifikací – to znamená s jeho názvem nebo popisemTýká se to zejména případů, kdy je obrázek produktu vůči jeho specifikaci:

  • v jiném dekoru či barvě (židle v dekoru buk by neměla mít na obrázku židli v dekoru ořech),
  • v jiné velikosti (samolepka v rozměru 25 x 25 cm by neměla být na obrázku znázorněna přes celou stěnu apod.)
  • zobrazený i s jinými produktynež je za prodávanou cenu k dispozici (např. celou sestavu do ložnice, i když za danou cenu je pouze skříň, případně celou sadu stůl s židlemi, když za danou cenu je pouze stůl nebo když je produkt zobrazovaný i s jeho jinou barevnou variantou). Jinými slovy, na hlavním obrázku může být uveden produkt jen v počtu, který je k prodeji. Případně bude tolerována číslice, která označuje počet stejných výrobků v jednom balení (sadě). Číslice však nesmí přesahovat přes produkt, nebo být jinak rušivá (nejlepší je uvedení v rohu obrázku).

2) Produkt na hlavním obrázku musí být vyobrazen reálnou fotografií a tedy ne jen náčrtem nebo ilustrací.

3) Hlavní obrázek musí být v rozlišení minimálně 600 x 600 px. Doporučené je ale zasílat co největší dostupnou velikost, ideálně nad 1000 x 1000 px.

4) Produkt na hlavním obrázku musí být zobrazen celý a tedy nejen jeho určitá část nebo detail.

5) Ideální je, pokud je produkt zobrazen na bílém pozadí. Pokud je výrobek zasazen do interiéru, produkt musí na obrázku dominovat tak, aby zákazník na první pohled věděl, o jaký produkt se jedná.

6) Hlavní obrázek nesmí obsahovat žádný dodatečný text nebo jiné grafické úpravy (ikony, vodoznaky, loga, označení 1 + 1, sleva, sada, set, mašličky apod.).

7) Hlavním obrázkem nesmí být pouze barevně vyplněný čtverec (takovýto produkt není brán jako reálný).

8) Vyhněte se zasazení obrázku do barevného orámování.

Pokud obrázek nesplňuje výše uvedená kritéria, může být blokován v zobrazování. Všechny dodatečné obrázky, které jsou k dispozici (nákresy, detaily, interiérové a kompoziční fotografie) je vhodné posílat jako alternativní obrázky, které se budou zobrazovat na detailu produktu přímo v katalogu FAVI.

Pokud je produkt kvůli nesplnění některého z kritérií uvádění obrázků blokován v zobrazování a systém zaznamená úpravu obrázku, dojde k novému posouzení obrázku a případnému vrácení produktu do katalogu. Pro změnu obrázku je však třeba změnit i URL adresu v XML feedu. K načtení nového obrázku dojde pouze v případě, že systém zaznamená změnu URL. Pokud ke změně nedojde, je zachován původní obrázek.

Co se týče samotné URL adresy pro hlavní (i alternativní) produktový obrázek, musí splňovat následující podmínky:

  • URL adresa obrázku nesmí obsahovat mezery, správně by měla být mezera nahrazena znakem „%20“,
  • URL adresa obrázku nesmí obsahovat diakritiku,
  • URL adresa obrázku nesmí být blokována. Pokud systém FAVI obrázek nestáhne z důvodu blokace URL serverem, produkt se do katalogu nenačte. 

Je třeba myslet na to, že při případné aktualizaci obrázku u doposud načteného produktu a nedostupnosti jeho nové URL, URL s diakritikou nebo mezerami, dojde k zneaktivnění produktu v rámci katalogu

Uvedení tohoto elementu je povinné.

Specifikace XML feedu

Element

Heureka/Zboží

<IMGURL>https://www.url.cz/postel-merida.jpg</IMGURL>

Google 

<g:image_link>https://www.url.cz/postel-merida.jpg</g:image_link>

Compari/Árukereső

<Image_url>https://www.url.cz/postel-merida.jpg</Image_url>

Ceneo

<imgs><main url=“https://www.url.cz/postel-merida.jpg“/></imgs>


ALTERNATIVNÍ OBRÁZKY

URL adresa pro alternativní obrázek produktu. Další zaslané fotografie jsou zobrazeny na detailu produktu. Počet alternativních obrázků je omezen na 20. 

Do alternativních obrázků je vhodné poskytovat:

  • fotografie produktu v interiéru,
  • fotografie produktu v kompozici s jinými produkty (např. ze stejné kolekce),
  • produkt z různých úhlů,
  • detailnější části produktu,
  • nákresy s uvedením rozměrů atp. 

Uvedení tohoto elementu je velmi doporučené.

Specifikace XML feedu Element
Heureka/Zboží <IMGURL_ALTERNATIVE>https://www.url.cz/merida2.jpg</IMGURL_ALTERNATIVE>
Google  <g:additional_image_link>https://www.url.cz/merida2.jpg<g:additional_image_link>
Compari/Árukereső: <Image_url_2>https://www.url.cz/merida2.jpg</Image_url_2>
Ceneo

<imgs><i url=“https://www.url.cz/merida2.jpg“/></imgs>


PARAMETRY

Parametry k produktu. Informace poskytované formou parametrů jsou na detailu produktu zobrazené v tabulce. Čím více parametrů k výrobku zašlete, tím lépe. Uvádějte především specifikace produktu, které nejsou zřejmé z obrázku. 

Mezi velmi doporučené parametry patří: materiál, barva, dekor, styl, rozměry a další vlastnosti typické pro produkt. 

Uvedení parametrů je velmi doporučené.

XML feed specification Element
Heureka/Zboží <PARAM>
  <PARAM_NAME>Výška</PARAM_NAME>
  <VAL>95 cm</VAL>
</PARAM>
Google

<g:color>hnědá</g:color>
<g:material>masivní dřevo, buk</g:material>
<g:pattern>pruhované</g:pattern>

<g:product_detail>
 <g:section_name>Rozměry</g:section_name>
  <g:attribute_name>Výška</g:attribute_name>
  <g:attribute_value>95 cm</g:attribute_value>
</g:product_detail>

Compari/Árukereső:

<Attributes>
  <Attribute>
    <Attribute_name>Výška</Attribute_name>
    <Attribute_value>95 cm</Attribute_value>
  </Attribute>
</Attributes>

Ceneo  <attrs>
   <a name=“Výška“>
   <95 cm>
   </a>
</attrs>

Níže uvedený parametr slouží k odlišení českých výrobků v katalogu. U produktů s tímto parametrem se v katalogu zobrazí česká vlajka.  

<PARAM>
  <PARAM_NAME>Specifikace</PARAM_NAME>
  <VAL>český výrobek</VAL>
</PARAM>

Pro zobrazení německé vlaječky zadávejte:

<PARAM>
  <PARAM_NAME>Specifikace</PARAM_NAME>
  <VAL>německý výrobek</VAL>
</PARAM>


DOBA DODÁNÍ *

Doba odeslání produktu ve dnech od obdržení platby při platbě předem a nebo v případě dobírky od přijetí objednávky. 

Jako produkty skladem jsou v katalogu označeny produkty, které:

  • mají v DELIVERY_DATE zadanou hodnotu 0, 1, 2 a nebo 3 (Heureka/Zboží),
  • mají uvedenou hodnotu in stock v elementu availability (Google feed),
  • mají v Delivery_Time zadanou hodnotu 0, 1, 2 a nebo 3 (Compari/Árukereső),
  • mají uvedenou hodnotu avail=“1″ (Ceneo).

Ostatní hodnoty jsou zohledněny do celkového skóre produktu, proto skladovost určitě doporučujeme uvádět. Je ale nutné, aby zaslaná hodnota odpovídala dodací době, která je uvedena na e-shopu po prokliku z FAVI.

Do elementu doby dodání je třeba uvádět jednu číselnou hodnotu a nikoli rozmezí. 

Uvedení tohoto elementu je povinné. 

Specifikace XML feedu Element
Heureka/Zboží <DELIVERY_DATE>0</DELIVERY_DATE>
Google <g:availability>in stock</g:availability>
Compari/Árukereső: <Delivery_Time>0</Delivery_Time>
Ceneo

avail=“1″


MOŽNOSTI DOPRAVY

Specifikace možností doručení produktu. 

U jednoho produktu může být více způsobů doručení. 

Štítek s dopravou zdarma se u produktu zobrazí tehdy, je-li uvedena jedna z platných možností dopravy s cenou 0.

Uvedení tohoto elementu je velmi doporučené.

Specifikace XML feedu Element
Heureka/Zboží <DELIVERY>
   <DELIVERY_ID>PPL</DELIVERY_ID>
   <DELIVERY_PRICE>0</DELIVERY_PRICE>
   <DELIVERY_PRICE_COD>20</DELIVERY_PRICE_COD>
</DELIVERY>
Google  <g:shipping>
   <g:price>0 CZK</g:price>
</g:shipping>
Compari/Árukereső:

<Delivery_Cost>FREE</Delivery_Cost>

or the following designation: gratuit, gratis, fara cost, ingyenes; ingyen, ingyenesen.

Ceneo není specifikováno

Pozn. Forma dopravy VLASTNI_PREPRAVA slouží k označení dopravy, kdy se rozváží zboží firemními vozy a nikoliv k tomu, že si zboží kupující sám vyzvedne u prodejce. 


VÝROBCE

Označuje výrobce produktu.

Uvedení tohoto elementu je velmi doporučené.

Specifikace XML feedu Element
Heureka/Zboží <MANUFACTURER>Truhlářství XYZ</MANUFACTURER>
Google  <g:brand>Truhlářství XYZ</g:brand>
Compari/Árukereső: <Manufacturer>Truhlářství XYZ</Manufacturer>
Ceneo <attrs>
   <a name=“Výrobce“>
   <![CDATA[Truhlářství XYZ]]>
   </a>
</attrs>

 


* označuje povinný element