Špecifikácia HTML5 bannerov

Kompletná HTML 5 stránka (banner) musí byť odoslaná v ZIP archíve. Požiadavky na ZIP archív:

Veľkosť rozbaleného archívu nesmie presiahnuť hodnotu uvedenú na formulári formátu
Archív nesmie obsahovať viac ako 75 súborov a adresárov
Adresárová štruktúra archívu nesmie byť hlbšia ako 5 úrovní
Archív musí obsahovať práve jeden .html súbor. Tento súbor bude umiestnený do iframe tagu.
Archív môže tiež obsahovať nasledujúce typy súborov:

css
js
gif
png
jpg
jpeg
svg
ttf
otf
woff
woff2

HTML súbor v archíve musí spĺňať:

Mal by obsahovať deklaráciu <!DOCTYPE html>
Musí obsahovať <html> tag
Musí obsahovať <body> tag
Mal by obsahovať typ kóddovania (<meta charset=... > tag)

HTTPS

Banner musí fungovať aj pri vložení na zabezpečené stránky (https protokol). Banner nesmie používať žiadne http://... URL, pretože tieto nebudú fungovať na https stránkach.

Pre URL odkazujúce na skripty, obrázky, apod. použité v banneri musí platiť:

Typ URL	Prípustný tvar URL
Odkaz na súbor, ktorý je súčasťou banneru (je v ZIP archíve)	Relatívna URL, napr: image.jpg images/img.png
Odkaz na externý súbor	Absolútna https URL, napr: https://myserver.com/image.jpg Absolútna URL bez protokolu, napr: //myserver.com/image.jpg

Typ URL

Prípustný tvar URL

Odkaz na súbor, ktorý je súčasťou banneru (je v ZIP archíve)

Relatívna URL, napr:

image.jpg
images/img.png

Odkaz na externý súbor

Absolútna https URL, napr:

https://myserver.com/image.jpg

Absolútna URL bez protokolu, napr:

//myserver.com/image.jpg

Preklik

Banner by nemal obsahovať žiadny preklik (<a>, onclick event, ...), INRES nastaví celú plochu banneru ako kliknuteľnú automaticky
V prípade špeciálnych požiadaviek na preklik (napr. preklik len nad časťou banneru) je možné preklik riešiť na strane banneru nasledujúcim spôsobom:
- Po kliknutí na banner musí byť v novom okne prehliadača otvorená meracia URL INRESu
- Táto URL je dostupná v JS premennej window.parent.inres_click_url v tele banneru
- Ak premenná window.parent.inres_click_url nie je použitá v tele HTML súboru, celá plocha banneru bude nastavená ako kliknuteľná automaticky
- Dynamický preklik - ak to nastavenia formátu povoľujú, banner môže použiť tzv. dynamický preklik - cieľovú URL prekliku určí kód samotného banneru s podporou merania prekliku cez INRES. Banner musí v tomto prípade naimplementovať preklik s použitím premennej window.parent.inres_click_url tak, že do meracej URL v tejto premennej doplní cieľovú URL pomocou JS kódu nasledujúcim spôsobom:
  
  var myClickUrl = window.parent.inres_click_url + '&follow=' + encodeURIComponent('http://www.example.com/');
  
  Potom po kliknutí banner musí takto upravenú URL otvoriť v novom okne prehliadača.

Smart banner

Smart banner je HTML5 banner použitý v smart remarketingovej kampani. Pre tento banner platia podobné pravidlá, ako pre ostatné HTML5 bannery s nasledujúcimi rozdielmi:

Dáta dynamického remarketingu - banner má k dispozícii zoznam produktov, ktoré videl návštevník stránky, ktorému sa banner práve zobrazuje
Smart dáta - banner má k dispozícii smart dáta asociované s návštevníkom stránky, ktorému sa banner práve zobrazuje
Preklik - plocha banneru nie je nastavená ako kliknuteľná automaticky, banner musí implementovať preklik

Dáta dynamického remarketingu

V tele banneru je k dispozícii JS premenná window.parent.inres_dynamic_remarketing_data. Je to pole produktov dynamického remarketingu, ktoré videl návštevník stránky. Každý prvok poľa reprezentuje jeden produkt ako objekt. Pole môže byť aj prázdne. Produkt nemusí obsahovať všetky informácie, nepovinné položky nemusia byť definované. Zoznam položiek produktu:

Povinné položky
- title - reťazec, názov produktu so zakódovanými HTML entitami - znaky < > " & sú nahradené zodpovedajúcimi HTML entitami (< > " &). Tento text možno vložiť priamo do HTML kódu.
- titleRaw - reťazec, názov produktu bez akýchkoľvek úprav
- image - reťazec, URL obrázku produktu
- clickUrl - reťazec, URL prekliku na stránku produktu vrátane odmerania prekliku cez INRES
- currencySymbol - reťazec, symbol meny, momentálne pre každý produkt obsahuje znak "€"
- decimalSeparator - reťazec, symbol oddeľovača desatinných miest, momentálne pre každý produkt obsahuje znak ","
Nepovinné položky
- price - nepovinný údaj, číslo, cena produktu
- oldPrice - nepovinný údaj, číslo, stará cena produktu pred zľavou
- stock - nepovinný údaj, bool alebo číslo, stav skladových zásob produktu. Ak je to bool, indikuje, či je produkt na sklade, alebo nie. Ak je to číslo, udáva presný počet kusov produktu na sklade.
- stars - nepovinný údaj, číslo, hodnotenie produktu vyjadrená počtom hviezdičiek (0 - 5)
- deliveryTime - nepovinný údaj, číslo, čas potrebný na doručenie produktu v dňoch
- orderDeadline - nepovinný údaj, reťazec, 24h čas v tvare "HH:MM". Určuje čas, do ktorého je potrebné vykonať objednávku, aby platila doba dodania uvedená v deliveryTime. Ak je čas objednávky neskorší ako táto hodnota, doba dodania sa predĺži minimálne o jeden deň.

Smart dáta

V tele banneru je k dispozícii JS premenná window.parent.inres_smart_data. Je to objekt so smart dátami. Tento objekt obsahuje položky s1, s2 až s10. Tieto položky majú rovnakú hodnotu ako zodpovedajúce parametre s1, s2 až s10 smart tagu. Parametre, ktoré smart tag nedefinoval, majú hodnotu nastavenú na null.

Preklik

Plocha smart banneru nie je nastavená ako kliknuteľná automaticky, banner musí implementovať preklik vo svojom kóde. URL prekliku sa musí otvoriť v novom okne prehliadača. Ako URL prekliku možno použiť:

URL prekliku na formát dostupnú v premennej window.parent.inres_click_url, prípadne s dynamickým preklikom analogicky ako pre bežný HTML5 banner
alebo URL produktu z dát dynamického remarketingu