Špecifikácia exportu produktov pre dynamický remarketing

Inres podporuje export (feed) remarketingových produktov vo viacerých formátoch. Podporované formáty:

Google merchant XML feed
Heureka.sk 2.0 XML feed vrátane dostupnostného feedu
Pricemania.sk XML feed - pozor, <id> element je pre INRES povinný
INRES CSV - INRES špecifický formát umožňujúci využiť možnosti remarketingu v INRESe na maximum. Zvyšok tohto článku popisuje INRES CSV formát.

INRES CSV

CSV export je vhodné vystaviť na ľubovoľnej URL, kde ho bude INRES pravidelne sťahovať kvôli aktualizácii aktívnych produktov. Pravidelnosť aktualizácie je možné nastaviť od 8 po 24 hodín podľa toho, ako často sa mení zoznam produktov a ich ceny.

Do exportu prosíme uvádzať iba aktívne produkty, ktoré je momentálne na stránkach možné objednať, alebo pred-objednať a iba tie, ktoré majú funkčný obrázok. Tým sa zabezpečí aktuálnosť produktov v kampaniach.

V prípade, že sa vaše produkty a ich ceny menia iba minimálne, napríklad raz za rok, je možné nám dodať (napríklad e-mailom) iba súbor s CSV exportom, ktorý nahráme jednorázovo a potom nie je potrebné CSV export vystaviť na URL adresu. Tento postup však nie je odporúčaný!

Špecifikácia exportu

Formát CSV:

prvý riadok obsahuje hlavičku
každý ďalší riadok obsahuje jeden produkt (produktové riadky)
riadky môžu byť oddelené Linux aj Windows oddeľovačom (0xA \n, 0xD 0xA \r\n)
každý produktový riadok obsahuje všetky stĺpce definované v hlavičke
hodnoty v riadku sú oddelené čiarkou
hodnota stĺpca alebo hlavičky obsahujúca úvodzovky, čiarku alebo nový riadok musí byť uzavretá v úvodzovkách ( "hodnota")
úvodzovky (") v hodnote musia byť zdvojené (" hodnota ""v úvodzovkách"" ")
povinné stĺpce musia byť zadefinované v hlavičke a vyplnené v každom produktovom riadku
nepovinné stĺpce definované v hlavičke musia byť prítomné na každom produktovom riadku, ale môžu obsahovať prázdnu hodnotu
poradie stĺpcov v hlavičke je ľubovoľné, ale každý riadok musí dodržať poradie definované v hlavičke
kódovanie UTF-8

Povinné stĺpce:

ID
- id produktu musí byť jedinečné v rámci exportu
- nesmie byť prázdne
- reťazec, max. 255 znakov
Item Title
- názov produktu
- nesmie byť prázdny
- reťazec, max. 255 znakov
Final URL
- URL prekliku na produkt
- podpora http a https URL
- reťazec, max. 2048 znakov
Image URL
- URL obrázku produktu
- podpora http a https URL
- podpora JPG, PNG a GIF obrázkov
- reťazec, max. 2048 znakov

Nepovinné stĺpce:

Price
- cena v tvare "66.54 EUR"
- kompatibilné s google formátom
- INRES momentálne používa iba hodnotu, mena nie je povinná
- ak je cena zadaná, musí byť >= 0
- oddeľovač desatinných miest môže byť bodka alebo čiarka
Old Price
- ak je nastavená, indikuje, že produkt je v zľave
- použije sa v banneri ako preškrtnutá pôvodná cena pred zľavou
- obmedzenia rovnaké ako pre Price
- pokiaľ je produkt v zľave, určite odporúčame tento parameter využívať, zvyšuje to CTR aj konverzný pomer
Delivery Time
- počet dní potrebných na doručenie
- použije sa na určenie doby dodania
- celé číslo >= 0
- používa sa na zobrazenie textu: “U vás doma už zajtra”, alebo “U vás doma už v utorok”. Odporúčame používať, zvyšuje to konverzný pomer.
Order Deadline Time
- čas, do ktorého je potrebné vykonať objednávku, aby platila doba dodania uvedená v Delivery Time
- ak je aktuálny čas neskorší ako táto hodnota, doba dodania sa predĺži o jeden deň
- 24h čas v tvare "HH:MM"
- ak nie je definovaný, uvažuje sa "24:00" - čas dodania sa nepredlžuje - teda čas objednávky v rámci dňa neovplyvní dĺžku doručenia. Napríklad ak objednávky urobené do 14:00 doručujete ešte v daný deň, pre bannery zobrazené pred 14:00 bude banner obsahovať text “U vás doma už dnes”, pre bannery zobrazené po 14:00 bude obsahovať text “U vás doma už zajtra”.
Delivery Days
- dni v týždni, počas ktorých sa doručuje objednávka
- reťazec z číslic 0-6, každá číslica reprezentuje jeden deň v týždni (0 - nedeľa, 1- pondelok, … , 6 - sobota)
- maximálne 7 znakov
- ak nie sú definované, uvažujú sa pracovné dni "12345"
- podľa tohto parametra sa počíta deň doručenia uvádzaný v inzercii.
Stock
- skladová dostupnosť
- "y", "yes", "true", "t" - na sklade bez informácie o počte kusov
- "n", "no", "false", "f", "0" - nie je na sklade
- celé číslo >= 0 - presný počet kusov na sklade
Stars
- hodnotenie produktu
- celé číslo 0-5
Alt URL 1
- alternatívna URL produktu 1
- môže byť zvolená a použitá formátmi dynamického remarketingu namiesto Final URL
- podpora http a https URL
- reťazec, max. 2048 znakov
Alt URL 2
- alternatívna URL produktu 2
- môže byť zvolená a použitá formátmi dynamického remarketingu namiesto Final URL
- podpora http a https URL
- reťazec, max. 2048 znakov
Alt URL 3
- alternatívna URL produktu 3
- môže byť zvolená a použitá formátmi dynamického remarketingu namiesto Final URL
- podpora http a https URL
- reťazec, max. 2048 znakov
Alt URL 4
- alternatívna URL produktu 4
- môže byť zvolená a použitá formátmi dynamického remarketingu namiesto Final URL
- podpora http a https URL
- reťazec, max. 2048 znakov
Alt URL 5
- alternatívna URL produktu 5
- môže byť zvolená a použitá formátmi dynamického remarketingu namiesto Final URL
- podpora http a https URL
- reťazec, max. 2048 znakov

Príklady

rmk-ex1.csv je jednoduchý (google kompatibilný) export s piatimi produktmi.
rmk-ex2.csv je podobný, ale sú tam použité všetky dostupné stĺpce, konkrétne:
- Prvý riadok definuje starú cenu, dobu dodania 3 dni v prípade objednania do 12:00 a doručovanie v utorok a štvrtok, 3 hviezdičky, 987 kusov na sklade. Názov tiež obsahuje úvodzovky.
- Druhý riadok z nepovinných stĺpcov používa dobu dodania 2 dni, doručovanie len v pondelok a skladovú dostupnosť bez počtu kusov.
- Tretí riadok z nepovinných stĺpcov používa iba skladovú dostupnosť nastavenú na "nie je na sklade".
- Posledný riadok príkladu ex2.csv nepoužíva žiadne nepovinné stĺpce.

V prípade akýchkoľvek otázok k tomuto dokumentu, nasadeniu kódov či exportu produktov sa môžete obrátiť na: Martin Gaži, 0904 133 643, martin.gazi@inres.sk.