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ő/Pazaruvaj <identifier>15a-diRE</identifier>
Ceneo id=“15a-diRE″
Jeftinije/Ceneje <![CDATA[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ő/Pazaruvaj <GroupId>ZD563</GroupId>
Ceneo v rámci specifikace není definováno
Jeftinije/Ceneje 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.

Produkty se do kategorií v našem katalogu zařadí primárně právě na základě názvu produktu, tedy ideálně by měl název produktu obsahovat základní specifikaci produktu, zejména určení, jako například: dětské povlečení (tedy není vhodné uvést například pouze povlečení, pokud je to dětské povlečení.), zahradní židle, jídelní židle a podobně.

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ő/Pazaruvaj <Name>Jednolůžková postel Merida 90 x 200 cm</Name>
Ceneo <name>Jednolůžková postel Merida 90 x 200 cm</name>
Jeftinije/Ceneje <name><![CDATA[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í,
  • emotikony.

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ő/Pazaruvaj

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

Ceneo

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

Jeftinije/Ceneje

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


KATEGORIE *

Kategorie produktu. Kategorie 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ő/Pazaruvaj

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

Ceneo

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

Jeftinije/Ceneje

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

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ő/Pazaruvaj <Price>4500</Price>
Ceneo price=“4500″
Jeftinije/Ceneje <price>659.90</price>

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ő/Pazaruvaj <Product_url>https://www.url.cz/merida.html#/90x200_cm</Product_url>
Ceneo url=“https://www.url.cz/merida.html#/90x200_cm″
Jeftinije/Ceneje <link><![CDATA[https://www.url.cz/merida.html#/90x200_cm]]></link>

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) Zasílejte obrázky v souborovém formátu PNG nebo JPEG.

4)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.

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

6) 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á.

7) 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.).

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

9) 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. 
  • URL adresa obrázku musí být zabezpečena https certifikátem.

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ő/Pazaruvaj

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

Ceneo

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

Jeftinije/Ceneje

<mainImage><![CDATA[https://www.url.cz/postel-merida.jpg]]></mainImage>


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. 

Všechny URL adresy na alternativní obrázky musí být zabezpečeny https certifikátem

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ő/Pazaruvaj <Image_url_2>https://www.url.cz/merida2.jpg</Image_url_2>
Ceneo

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

Jeftinije/Ceneje

<moreImages><![CDATA[https://www.url.cz/merida2.jpg,https://www.url.com/merida3.jpg]]
></moreImages>


PARAMETRY

Parametry k produktu. Parametry jsou konkrétní specifika jednotlivých produktů. Čí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.

Více informací o tom, jak parametry specifikovat najdete zde. Některé parametry navíc slouží k zařazení produktů do filtrů

Zákazník který filtruje je obecně blíže konverzi. Abyste o takové zákazníky nepřišli, zkontrolujte, jakým způsobem aktuálně parametry posíláte. Pro zobrazení vašich produktů ve filtru rozměrů zasílejte rozměry v samostatných parametrech - výška zvlášť, šířka zvlášť, hloubka zvlášť, atd. Jiné zápisy v jednom elementu neakceptujeme. Doporučené rozměry v každé kategorii naleznete v rámci seznamu kategorií zde.

Obecné zásady pro parametry 

  1. Neposílejte více hodnot parametrů, pokud se netýkají dané varianty produktu, viz příklad (dekory, další dostupné velikosti a barvy), hlavní fotografie produktu musí korespondovat s popisem i parametry,
  2. parametry nemusí být zadané přesně jako je náš filtr v kategorii. Napárujeme i jiné znění, pokud jej obdržíme u vícero klientů,
  3. uvádějte jednotky k číselným hodnotám (cm, mm, l, ..),
  4. každý produkt byl měl obsahovat svá konkrétní specifika a hodnoty parametrů by se neměly duplikovat, viz příklad,
  5. hodnoty parametrů ano x ne zpracujeme, ale hodnoty 0 x 1 nikoliv,
  6. posílejte parametry co nejvíce konkrétně a neuvádějte více hodnot na více řádcích, 
  7. parametry je nutné vždy přeložit do jazyka dané země.
  8. rozměry je nutné zaslat v samostatných parametrech - výška zvlášť, šířka zvlášť, hloubka zvlášť atd.

Zaslané parametry také zobrazujeme v tabulce na detailu produktu. Začínají se zobrazovat, pokud jich pošlete 3 a více.

Uvedení parametrů je velmi doporučené.

Specifikace XML feedu 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ő/Pazaruvaj

<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>
Jeftinije/Ceneje <attributes>
<name><![CDATA[Výška]]></name>
<values>
<value><![CDATA[95 cm]]></value>
</values>
</attribute>
</attributes>

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"  nebo "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>

Více o zobrazení dostupnosti produktů naleznete případně i ZDE.

Google

<g:availability>in stock</g:availability>

nebo

<g:availability>in_ stock</g:availability>

Compari/Árukereső/Pazaruvaj <Delivery_Time>0</Delivery_Time>
Ceneo

avail=“1″

Jeftinije/Ceneje

<stock>in stock</stock>


MOŽNOSTI DOPRAVY

Specifikace možností doručení produktů zákazníkovi.

U jednoho produktu může být více způsobů doručení a vhodné je uvést i cenu dopravy. Díky tomu dojde ke zvýšení celkového skóre produktu.

Do kvalitativního skóre produktů zohledňujeme pouze doručení domů, na odběrná místa nikoliv. 

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

Pokud nemáte možnost doplnit údaje o ceně dopravy do XML feedu, informace je možné doplnit skrz přehled Vašeho obchodu v záložce Nastavení > Doprava. Zde je možné doplnit následující informace, které se automaticky připíší ke všem produktům naráz: 

  • Cena nejlevnější dopravy na adresu
  • Doprava zdarma pro produkty od 

Doplnění skrz přehled obchodu doporučujeme v případě sjednocených cen pro kompletní portfolio produktů. Pokud se v cenách dopravy vyskytují výjimky, údaje je nutné doplnit v XML feedu.

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ő/Pazaruvaj

<Delivery_Cost>FREE</Delivery_Cost>

nebo také následující označení: gratuit, gratis, fara cost; ingyenes, ingyen, ingyenesen; безплатно, безплатен, безплатна.

Ceneo není specifikováno
Jeftinije/Ceneje <deliveryCost>0</deliveryCost>

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. 


GTIN (EAN)

Globální číslo obchodní položky. Jedná se o unikátní číslo specifického produktu. V případě, kdy vaše produkty číslo GTIN nemají, můžete je získat na stránkách systému GS1 nebo Barcodes.

V rámci tohoto elementu nikdy neuvádějte interní číselná označení produktů, ale pouze oficiální kódy zboží.

GTIN je naším systémem uznaný jako platný, pokud splňuje následující:

  1. skládá se pouze z 8, 12, 13, nebo 14 číslic
  2. musí projít oficiálním výpočtem kontrolních číslic (např.: https://www.gs1.org/services/how-calculate-check-digit-manually)
  3. nesmí obsahovat předpony pro hodnoty kupónů (více zde: Postup odstranění problému: Nepodporovaná hodnota kupónu: GTIN [gtin])

Uvedení tohoto elementu je velmi doporučené.

Specifikace XML feedu

Element

Heureka/Zboží

<EAN>6417182041488</EAN>

Google

<g:gtin>6417182041488</g:gtin>

Compari/Árukereső/Pazaruvaj

<EAN_code>6417182041488</EAN_code>

Ceneo

<a name=“EAN“>
<![CDATA[6417182041488 ]]>
</a> 

Jeftinije/Ceneje

<EAN><![CDATA[8806088059785]]></EAN>

 


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ő/Pazaruvaj <Manufacturer>Truhlářství XYZ</Manufacturer>
Ceneo <attrs>
   <a name=“Výrobce“>
   <![CDATA[Truhlářství XYZ]]>
   </a>
</attrs>
Jeftinije/Ceneje <brand><![CDATA[Truhlářství XYZ]]></brand>

 


* označuje povinný element