Árukereső špecifikácia feedu
Aby mohlo dôjsť k importu produktov do nášho vyhľadávača, je potrebné mať vytvorený tzv. XML súbor alebo CSV súbor (feed). Ide o jednoduchý dátový formát, pomocou ktorého nám odovzdáte informácie o tovare a jeho cenách. Feed je automaticky generovaný z vašich stránok, a preto jeho vytvorenie alebo úpravy konzultujte so svojím webmasterom.
Váš feed sťahujeme každý deň o 16. hodine, aktualizáciu daných produktov zobrazujeme nasledujúci deň. V prípade potreby skorších aktualizácií odporúčame prémiový balíček.
Povinné polia
| 1 | 2 |
|---|---|
Identifier | Jedinečný identifikátor produktu používaný internetovým obchodom. Jeho hodnota zostáva nezmenená. |
Manufacturer | Názov výrobcu produktu. Voliteľne ho možno zadať aj na začiatok názvu produktu do poľa „Názov“. Príklad: Sony |
| Name | Názov produktu. Na začiatku s veľkým písmenom, použitie ďalších veľkých písmen je povolené iba v odôvodnených prípadoch (napr. skratka). Názov musí obsahovať celý názov produktu. Naopak nesmie obsahovať reklamu. Príklad: Cyber-shot DSC-H10 Ak nemôžete zadať názov výrobcu do samostatného poľa, zadajte ho sem pred názov produktu. Príklad: Sony Cyber-shot DSC-H10 |
| Category | Zaradenie produktu do kategórie. Dokážeme spracovať plynulé, hierarchicky štruktúrované kategórie. Všetky používané kategórie nájdete tu: Príklad: Technika > Spotrebná elektronika > DVD prehrávače |
ProductUrl | Odkaz (URL) na stránku produktu. |
Price | Cena produktu pre koncového používateľa (cena vrátane DPH a ďalších daní, ktoré musí spotrebiteľ zaplatiť za daný produkt). Cena minimálneho množstva, ktoré je možné objednať a je uvedené na stránke produktu. |
| NetPrice | Cena bez DPH |
Ďalšie odporúčané polia
| 1 | 2 |
|---|---|
| ProductNumber | Kód produktu poskytnutý výrobcom. ProductNumber musí byť uvedené vo feede v prípade elektroniky, IT, domácich spotrebičov a v tých kategóriách, kde spracovanie prebieha na základe kódu produktu. Akceptujeme iba kódy produktov používané výrobcom. |
MaxCPCMultiplier | Multiplikátor maximálnej ponuky produktu. Pomocou neho určujete násobenie cenníkovej ceny, t. j. cenu za preklik odporúčanej pozície, ktorú ste ochotní zaplatiť v porovnaní so základnou cenou kategórie. Hodnoty ponúk uvedené vo feede sú systémom Árukereső.hu akceptované, ak spĺňajú nasledujúce podmienky:
Multiplikátor maximálnej ponuky produktu zohľadňujeme iba v prípade produktu, ktorý zobrazujeme na Árukereső. Ak je pre produkt nastavený multiplikátor ponuky v administrácii obchodu aj vo feede, systém zohľadní ponuku z administrácie obchodu. |
| DeliveryCost | Náklady na doručenie produktu domov. Ak sú náklady na dopravu produktu v rámci celej krajiny zdarma, bez ohľadu na hmotnosť a cenu produktu, správne formáty sú: FREE; ingyenes; ingyen; ingyenesen Ak sú náklady na dopravu produktu v rámci celej krajiny stanovené bez ohľadu na hmotnosť a cenu produktu, napr. 700 HUF (suma vrátane DPH), správne formáty sú: 700; 700 Ft |
| DeliveryTime | Dodacia lehota produktu. Produkt bude doručený do tohto počtu pracovných dní odo dňa uskutočnenia objednávky. Údaj je potrebné uvádzať v dňoch. Správne formáty: 2; 2 nap; 2 munkanap (2 pracovné dni – vo feede sa musí zobraziť maďarská verzia). Nesprávne formáty: 1 hét; 2–4 nap; raktáron; készleten (1 týždeň; 2–4 dni; na sklade; skladom). Pre produkty, ktoré je možné odoslať okamžite (alebo nasledujúci pracovný deň), sú správne formáty: 1; 1 nap; 1 munkanap (1 pracovný deň – vo feede sa musí zobraziť maďarská verzia). Ak produkt nie je možné objednať, zadajte do poľa hodnotu „NO“ („NIE“) a výrobok sa na Árukereső.hu nezobrazí. Poskytované informácie sa zobrazujú nasledovne: Tieto údaje môžeme zobraziť iba v prípade, že sa nachádzajú aj na stránke produktu. V prípade produktových stránok obsahujúcich viacero ponúk musí byť jasne identifikovateľné, ku ktorej ponuke sa informácia vzťahuje. mci celej krajiny stanovené bez ohľadu na hmotnosť a cenu produktu, napr. 700 HUF (suma vrátane DPH), správne formáty sú: 700; 700 Ft |
DeliveryTime | Dodacia lehota produktu. Produkt bude doručený do tohto počtu pracovných dní odo dňa uskutočnenia objednávky. Údaj je potrebné uvádzať v dňoch. Správne formáty: 2; 2 nap; 2 munkanap (2 pracovné dni – vo feede sa musí zobraziť maďarská verzia). Nesprávne formáty: 1 hét; 2–4 nap; raktáron; készleten (1 týždeň; 2–4 dni; na sklade; skladom). Pre produkty, ktoré je možné odoslať okamžite (alebo nasledujúci pracovný deň), sú správne formáty: 1; 1 nap; 1 munkanap (1 pracovný deň – vo feede sa musí zobraziť maďarská verzia). Ak produkt nie je možné objednať, zadajte do poľa hodnotu „NO“ („NIE“) a výrobok sa na Árukereső.hu nezobrazí. Poskytované informácie sa zobrazujú nasledovne: Tieto údaje môžeme zobraziť iba v prípade, že sa nachádzajú aj na stránke produktu. V prípade produktových stránok obsahujúcich viacero ponúk musí byť jasne identifikovateľné, ku ktorej ponuke sa informácia vzťahuje. |
| EanCode | Identifikátor produktu poskytnutý výrobcom s minimálne 8 a maximálne 13 číslicami. Musí byť jedinečný. |
| ShoppingDisabled | Zakázanie produktu v službe Árukereső Shopping. V zozname produktov uveďte:
|
EnergyEfficiencyA-G | Trieda energetickej účinnosti produktu platná od 1. 3. 2021, ktorá môže byť A–G. |
EnergyLabelA-G | Odkaz (URL) na obrázok nového energetického štítku výrobku, ktorý nadobudol platnosť 1. 3. 2021. |
DetailedSpecificationA-G | Odkaz (URL) na nový podrobný technický list produktu, ktorý nadobudol platnosť 1. 3. 2021. Žiadame o poskytnutie podrobného dátového listu vo formáte PDF alebo JPG/PNG. |
Description | Popis produktu obsahujúci dôležité parametre, aby zákazníci mohli získať presné informácie. |
ImageUrl | Odkaz (URL) na fotografiu produktu. Ak je obrázok dostupný vo viacerých veľkostiach, odporúčame uviesť odkaz na najlepšiu kvalitu. Minimálna veľkosť, ktorú môžeme zobraziť, je 150 × 150 pixelov. Uveďte skutočný obrázok produktu. Obrázky obsahujúce iba informáciu „Čoskoro bude nahrané“ alebo logo spoločnosti sú považované za neplatné. |
| ImageUrl2 | Odkaz (URL) na fotografiu produktu v prípade, že máte k dispozícii viac obrázkov. |
| Color | Dominantná farba produktu. Pole sa používa iba v kategórii Móda. Pri produkte uveďte iba jednu farbu. Ak má produkt viac farebných variantov, zadajte produkt do feedu s jedinečným identifikátorom a názvom toľkokrát, v koľkých farbách je dostupný. Farbu môžeme akceptovať iba v prípade, že farba produktu na priloženom obrázku zodpovedá farbe uvedenej v tomto poli. Nepoužívajte rovnaký obrázok produktu pre každú verziu. |
| Size | Veľkosť produktu. Pole sa používa iba v kategórii Móda. Pri produkte uveďte iba jednu veľkosť. Ak má produkt viac veľkostných variantov, zadajte produkt do feedu s jedinečným identifikátorom a názvom toľkokrát, v koľkých veľkostiach je dostupný. Náš systém dokáže interpretovať iba veľkosti EU a International (S/M/L); iné veľkosti nemôžeme akceptovať. |
| GroupId | Zoskupenie produktov, ktoré sú vo feede zahrnuté viackrát. Variácie môžu byť spôsobené farbou, veľkosťou, vzorom alebo inými vlastnosťami produktu (napr. veľkosť pamäte). |
| Attributes | Pole vhodné na prenos vlastností produktu. Produkty odoslané s parametrami sú automaticky filtrované v kategóriách. Čím viac informácií poskytnete, tým ľahšie budú vaše produkty dohľadateľné. Charakteristiky produktu môžeme spracovať v XML bez ohľadu na typ zoznamu, a to nasledujúcim spôsobom: |
Špeciálne kategórie
Pre nasledujúce špeciálne kategórie požadujeme iné informácie a tagy: DVD, Knihy, Pneumatiky a Parfémy.
Požiadavky v kategórii Mobilní telefony
| 1 |
|---|
| Můžeme zobrazit pouze ceny, které jsou nezávislé na kartě či poskytovateli služeb a zahrnují kompletní příslušenství (krabice, nabíječka atd.). |
Požiadavky v kategórii DVD FILM
| 1 | 2 |
|---|---|
| Povinná pole: | ReleaseDate – rok vydání filmu OriginalTitle – původní anglický název filmu Name – název filmu v maďarštině Price – hrubá cena produktu; Category – zařazení produktu do kategorie ProductUrl – jedinečná URL adresa produktu |
| Doporučené pole: | Description – stručný popis DVD |
Požiadavky v kategórii KNIHA
| 1 | 2 |
|---|---|
| Povinná pole: | ISBN13 – 13místné číslo (identifikátor produktu, musí být jedinečný) Name – název produktu (Titul knihy) Price – hrubá cena produktu ProductUrl – jedinečná URL adresa produktu Category – zařazení produktu do kategorie |
| Doporučená pole: | ImageUrl – URL link na produktové foto Author – jméno autora knihy Description – stručný popis knihy ReleaseDate – rok vydání Pages – počet stran Weight – hmotnost včetně měrné jednotky (kg, g), např: 1 000 g Language – jazyk |
Požiadavky v kategórii PNEUMATIKY
| 1 | 2 |
|---|---|
| Povinné informace v tagu “Name” | Typ – např. ContiPremiumContact 2 Velikost 1 – např. 205/60 Velikost 2 – např. R16 LI (hmotnostní index) – např. 96 SI (rychlostní index) – např. H Dojezdové/vyztužené pneumatiky – např. RFT, XL |
Názov produktu, ktorý akceptujeme pre túto pneumatiku, je: Continental ContiPremiumContact 2 SSR XL 205/60 R16 96H. Poradie jednotlivých parametrov sa môže meniť, ale výrobca by mal byť prednostne uvedený buď samostatne, alebo na začiatku názvu produktu.
Požiadavky v kategórii slitinové kolo
| 1 | 2 |
|---|---|
| Povinné informace v tagu “Name” | Typ – např. Dark Blade AN Počet šroubů, roztečná kružnice – např. 4/100 Průměr a šířka ráfku – např. 15 × 6,5 Hloubka zasunutí – např. ET38 Velikost středové díry – např. CB72,3 |
Názov produktu, ktorý akceptujeme pre toto alu koleso, je: MOMO Dark Blade AN CB72.3 4/100 15 × 6.5 ET38.
Poradie jednotlivých parametrov sa môže meniť, ale poradie v rámci samotných parametrov sa nesmie meniť. Pre priemer a šírku ráfika nemôžeme akceptovať verziu 6,5 × 15. Výrobca by mal byť uvedený buď samostatne, alebo na začiatku názvu produktu.
Požiadavky v kategórii PARFÉM
| 1 | 2 |
|---|---|
| Povinné informace v tagu “Name” | Manufacturer: HUGO BOSS Název – např. Baldessarini Typ – koncentrace vůně např. EDP Balení – velikost balení např. 75 ml Balení – v případě testerů uveďte v názvu slovo „Tester“ nebo „Teszter“ Cílová skupina: např. muži |
Názov produktu, ktorý akceptujeme pre tento parfém, je: HUGO BOSS Baldessarini EDP 75ml for men
Pre tester: HUGO BOSS Baldessarini EDP 75ml Tester for men
Poradie jednotlivých parametrov sa môže meniť, ale výrobca by mal byť uvedený buď samostatne, alebo na začiatku názvu produktu.
Povinné polia pre Árukereső Marketplace
Povinné polia pre partnerov využívajúcich službu Árukereső Marketplace
| 1 | 2 |
|---|---|
Description | Popis produktu, ktorý obsahuje dôležité parametre, aby zákazníci mohli získať presné informácie. |
| ImageUrl | Odkaz (URL) na fotografiu produktu. Ak je obrázok dostupný vo viacerých veľkostiach, odporúča sa uviesť odkaz na najlepšiu kvalitu. Minimálna veľkosť, ktorú môžeme zobraziť, je 150 × 150 pixelov. Uveďte skutočný obrázok produktu; obrázky typu „Čoskoro bude nahrané“ alebo logo spoločnosti nie sú platné. |
DeliveryTime | Dodacia lehota produktu. Produkt bude doručený do tohto počtu pracovných dní odo dňa uskutočnenia objednávky. Údaj je potrebné uvádzať v dňoch. Správne formáty: 2; 2 nap; 2 munkanap (2 pracovné dni – vo feede sa musí zobraziť maďarská verzia). Nesprávne formáty: 1 hét; 2–4 nap; raktáron; készleten (1 týždeň; 2–4 dni; na sklade; skladom). Pre produkty, ktoré je možné odoslať okamžite (alebo nasledujúci pracovný deň), sú správne formáty: 1; 1 nap; 1 munkanap (1 pracovný deň – vo feede sa musí zobraziť maďarská verzia). Ak produkt nie je možné objednať, zadajte do poľa hodnotu „NO“ („NIE“). V takom prípade sa výrobok na Árukereső.hu nezobrazí. Poskytované informácie sa zobrazujú nasledovne: Raktáron (Skladom), Szállítás: max 3 nap (Dodanie: max. 3 dni), Szállítás: max 1 hét (Dodanie: max. 1 týždeň), Szállítás: max 2 hét (Dodanie: max. 2 týždne), Szállítás: min 2 hét (Dodanie: min. 2 týždne). Tieto údaje môžeme zobraziť iba v prípade, že sa nachádzajú aj na stránke produktu. V prípade produktových stránok obsahujúcich viacero ponúk musí byť jasne identifikovateľné, ku ktorej ponuke sa informácia vzťahuje. |
Aby predajcovia využívajúci službu Árukereső Marketplace mohli zobrazovať ponuky kombinovaných produktov v určitých kategóriách, je okrem názvu používaného výrobcom potrebná aj prítomnosť farby (napríklad: „Huawei P20 lite 64GB DUAL SIM noční černá“, „Slúchadlá JBL T110, biela“, „Nikon Coolpix B500 (fialová)“). Farbu bohužiaľ nie je možné označiť pomocou tagu „Color“, pretože ho je z technických dôvodov možné použiť iba v kategórii móda.
Odporúčané polia pre Árukereső Marketplace
Odporúčané polia pre Árukereső Marketplace
| 1 | 2 |
|---|---|
BasketDisabled | Nezobrazujte produkt v Árukereső Marketplace. V zozname produktov uveďte: 1 ⇒ Ak si neprajete zobrazovať daný produkt na Árukereső Marketplace. 0 (alebo prázdne pole) ⇒ Produkt je možné zobraziť na Árukereső Marketplace. |
FreeDelivery | Doručenie domov zdarma je možné uviesť, ak má produkt doručenie v Maďarsku zdarma, nezávisle od toho, čo je uvedené v tabuľke poplatkov v administrácii obchodu. Zadanie je nepovinné, predvolená hodnota je 0. Poplatok za doručenie sa vypočíta podľa tabuľky poplatkov z administrácie obchodu. V zozname produktov uveďte: 1 ⇒ Ak je poplatok za doručenie produktu v Maďarsku 0 HUF, bez ohľadu na tabuľku poplatkov. |
Oversize | Pre nadrozmerné produkty administrácia umožňuje stanoviť špeciálne poplatky za doručenie. V zozname produktov uveďte: 1 ⇒ Pre produkty, ktoré podliehajú poplatkom za dopravu „nadrozmerných produktov“ uvedeným v tabuľke poplatkov za dopravu. 0 ⇒ Pre všetky ostatné produkty. |
| Weight | Hrubá hmotnosť produktu vrátane základného príslušenstva a balenia. Okrem hmotnosti produktu je povinné uviesť aj meraciu jednotku, ktorá môže byť kg alebo g. Správne formáty: 2 kg; 1 000 g |
| DeliveryCostByProduct | Náklady na doručení daného produktu se vypočítávají na základě počtu stejných položek v košíku. Zadání tohoto tagu je nepovinné a jeho výchozí hodnota je 0. Poplatek za doručení se vypočítá podle tabulky poplatků za doručení z administrace obchodu. 1 ⇒ Určuje produkty, na které se vztahuje poplatek za doručení podle počtu produktů v košíku. 0 ⇒ Nezáleží na tom, kolik produktů bude vloženo do košíku. Náklady na dopravu budou účtovány pouze jednou. |
Formáty súborov
Uvedené dáta je možné odoslať vo formáte CSV/TSV alebo XML.
Použitie formátu CSV/TSV
Pro vyplnění můžete použít čárky, středníky, tabulátory. První řádek by měl obsahovat název polí, ostatní řádky údaje o daném produktu. Oddělovací znak v datovém poli se může objevit pouze v případě, že je dané pole v uvozovkách. V takových případech by měly být uvozovky „escapovány“. Náš systém podporuje jako řešení také zdvojení („“xy““) a zpětné lomítko (\“xy\“). Podobně jako v případě CSV lze i v případě TSV změnit tabulátory v datových polích na „mezeru“. To je důvod, proč je použití TSV v praxi jednodušší. Například funkce „fputcsv“ programovacího jazyka PHP funguje podle výše uvedeného popisu.
Príklad CSV
"category";"manufacturer";"name";"description";"price";"imageurl";"producturl";"deliverytime";"deliverycost";"netprice";"identifier";"eancode"
"Számitógép>Laptop";"HP";"655 C4X91EA LX 2Y";"Processzor: AMD E2-1800 (1700)....";"99900";"http://www.example.com/images/12554.jpg";"http://www.example.com/products.php?id=1231231";"1 munkanap";"2000 Ft";"7866";"1231231";"0887111509581";"<attribute><attribute_name>Memória mérete</attribute_name><attribute_value>4 GB</attribute_value></attribute> <attribute><attribute_name>Kijelző felbontása</attribute_name><attribute_value>1366 x 768</attribute_value></attribute> <attribute><attribute_name>Háttértár kapacitása</attribute_name><attribute_value>500 GB</attribute_value></attribute> <attribute><attribute_name>Bluetooth</attribute_name><attribute_value>Van</attribute_value></attribute>"
"Számitógép>Laptop";"Acer";"Aspire V5-121-C72G32akk Black A358 LX 2Y";"Processzor: AMD C-70 Dual Core (1000).....";"69900";"http://www.example.com/images/12555.jpg";"http://www.example.com/products.php?id=1231232";"5 munkanap";"FREE";"55039";"1231232";"";"<attribute><attribute_name>Memória mérete</attribute_name><attribute_value>2 GB</attribute_value></attribute> <attribute><attribute_name>Kijelző felbontása</attribute_name><attribute_value>1366 x 768</attribute_value></attribute> <attribute><attribute_name>Háttértár kapacitása</attribute_name><attribute_value>320 GB</attribute_value></attribute> <attribute><attribute_name>Bluetooth</attribute_name><attribute_value>Van</attribute_value></attribute>"
"Számitógép>Egér";"Hama";"uRage Illuminated 113722";"Gaming egér precíz kurzorvezérléssel";"6900";"http://www.example.com/images/12556.jpg";"http://www.example.com/products.php?id=1231233";"1 munkanap";"2000 Ft";"5433";"1231233";"4047443184320";"<attribute><attribute_name>Egér típusa</attribute_name><attribute_value>Optikai</attribute_value></attribute> <attribute><attribute_name>Csatlakozás</attribute_name><attribute_value>Usb</attribute_value></attribute> <attribute><attribute_name>Vezeték nélküli</attribute_name><attribute_value>Nem</attribute_value></attribute>"
"Műszaki cikk>Fényképező objektív";"Nikon";"AF-S 50mm f/1.8G JAA015DA";"50 mm-es, FX-formátumú általános objektív (Nikon DX-formátumú SLR géppel használva 75 mm-es).";"69900";"http://www.example.com/images/12551.jpg";"http://www.example.com/products.php?id=1231234";"3 munkanap";"2000 Ft";"55039";"1231234";"0018208021994";"<attribute><attribute_name>Kompatibilis bajonettek</attribute_name><attribute_value>Nikon bajonett</attribute_value></attribute> <attribute><attribute_name>Objektív típusa</attribute_name><attribute_value>Standard objektív</attribute_value></attribute> <attribute><attribute_name>Lamellák száma</attribute_name><attribute_value>7</attribute_value></attribute> <attribute><attribute_name>Gyújtótávolság</attribute_name><attribute_value>50 mm</attribute_value></attribute>"Použitie formátu XML
Feed je možné vytvoriť aj vo formáte XML, v ktorom musia byť všetky produkty obsiahnuté v tagu <products> a </products> a informácie o konkrétnom produkte musia byť zoskupené v tagu <product> a </product>.
Příklad XML:
<?xml version="1.0" encoding="UTF-8" ?>
<Products>
<Product>
<Identifier>00010</Identifier>
<Manufacturer>Samsung</Manufacturer>
<Name>Gear IconX SM-R150</Name>
<ProductUrl>http://www.onoldala.hu/products/00010/sm-r150.html</ProductUrl>
<Price>379,97</Price>
<NetPrice>299,18</NetPrice>
<ImageUrl>http://www.onoldala.hu/images/smr150.jpg</ImageUrl>
<Category>Műszaki cikk - Fülhallgató</Category>
<Description>Kapcsolj környezeti hang üzemmódra, hogy halld a körülötted lévő hangokat is. Így kedvenc zenéid hallgatása mellett is végig a jelenben érezheted magad...</Description>
<DeliveryTime>1 munkanap</DeliveryTime>
<DeliveryCost>990 Ft</DeliveryCost>
<EanCode>8806088369228</EanCode>
<Attributes>
<Attribute>
<Attribute_name>Impedancia</Attribute_name>
<Attribute_value>16 ohm</Attribute_value>
</Attribute>
<Attribute>
<Attribute_name>Hangszínszabályozó</Attribute_name>
<Attribute_value>Nincs</Attribute_value>
</Attribute>
<Attribute>
<Attribute_name>Érzékenység</Attribute_name>
<Attribute_value>89.5 dB</Attribute_value>
</Attribute>
<Attribute>
<Attribute_name>Tömeg (fülhallgatók)</Attribute_name>
<Attribute_value>16 gramm</Attribute_value>
</Attribute>
</Attributes>
</Product>
<Product>
<Identifier>00011</Identifier>
<Manufacturer>Apple</Manufacturer>
<Name>Magic mouse MB829ZM</Name>
<ProductUrl>http://www.onoldala.hu/products/00011/magic-mouse.html</ProductUrl>
<Price>315,00</Price>
<NetPrice>248,03</NetPrice>
<ImageUrl>http://www.onoldala.hu/images/magic-mouse.jpg</ImageUrl>
<Category>Számítástechnika - Egér</Category>
<Description>Apple Magic Mouse Multi-Touch technológiával működik...</Description>
<DeliveryTime>7 munkanap</DeliveryTime>
<DeliveryCost>FREE</DeliveryCost>
<EanCode>0885909934140</EanCode>
<Attributes>
<Attribute>
<Attribute_name>Tömeg</Attribute_name>
<Attribute_value>99 g</Attribute_value>
</Attribute>
<Attribute>
<Attribute_name>Multi-touch</Attribute_name>
<Attribute_value>Igen</Attribute_value>
</Attribute>
<Attribute>
<Attribute_name>Csatlakozók</Attribute_name>
<Attribute_value>Bluetooth, Lightning port, Wireless</Attribute_value>
</Attribute>
</Attributes>
</Product>
</Products>
Cenník
Cenník služieb nájdete priamo na webovej stránke Árukereső.