Postup nasazení reklamy

Krok 1: Připojte výdejový skript ssp.js

<head>
	...
	<script src="//ssp.seznam.cz/static/js/ssp.js"></script>
</head>

Kód pro připojení výdejového JavaScriptu ssp.js vložte do hlavičky stránky před uzavírací tag </head>, a to vždy pouze jednou. JavaScript slouží k výdeji reklamy z SSP serveru (https://ssp.seznam.cz), k jejímu vykreslení do stránky a k měření počtu zobrazení reklamy.

Krok 2: Definujte pozice pro reklamu

<body>
	...
	<div id="ssp-zone-12345"></div>
	...
</body>

Do těla stránky – na místa, kde se má vykreslit reklama – vložte HTML elementy <div> s unikátními hodnotami (v rámci jedné stránky) atributu id, které představují jednotlivé reklamní plochy. Element s konkrétním id smí být na stránce vždy jen jednou.

Hodnota atributu id každého HTML elementu musí souhlasit s hodnotou parametru id, který následně použijete v požadavku předávaném reklamnímu systému pomocí funkce getAds() obsluhujícího JavaScriptu.

Další možností definice reklamních zón je Definice pozic pomocí HTML tagů.

Krok 3: Požádejte o vydání reklamy voláním metody sssp.getAds()

<script>
	sssp.getAds([
		{
			"zoneId": 12345,
			"id": "ssp-zone-12345",
			"width": 300,
			"height": 250
		}
	]);
</script>

Pro vykreslení reklam je třeba do zdrojového kódu stránky vložit JavaScript, který volá metodu sssp.getAds(). Argumentem metody sssp.getAds() je pole obsahující objekt (resp. objekty) popisující určitou reklamní zónu (resp. zóny).

Nezbytným minimem je zadání zoneId (číselný identifikátor uvedený v partnerském rozhraní u každé zóny) a id (atribut ID HTML elementu, do kterého se má reklama vykreslit). V případě JSON výdeje je nutné objekt s definicí požadavku na reklamu doplnit callback funkcí, která zpracuje odezvu v podobě JS objektu a vykreslí reklamu na požadované místo stránky (viz Callback funkce).

Vlastnosti width a height definují maximální rozměry reklamy, která se do plochy může vykreslit. Hodnoty vygenerované partnerským rozhraním neupravujte, jinak dojde k chybě při volání reklamy.

Volání funkce getAds() musí být provedeno až poté, co se na stránce fyzicky nacházejí všechny elementy, do kterých se má reklama vykreslit – proto jej raději umístěte na konec stránky.

V nejjednodušším případě volejte metodu sssp.getAds() pro každou zónu zvlášť (singlerequest). Reklamu pro několik zón současně v rámci jednoho požadavku lze získat i pomocí jednoho dotazu (multirequest) – viz Příklady volání.

Krok 4: Seznam SSP vydá reklamu

1. Typ výdeje iframe

Výdejový script Seznam SSP automaticky zajistí vykreslení reklamy do stránky i měření počtu zobrazení reklamy (impresí).

Do elementu <div> určeného pro reklamu (id="ssp-zone-123456") se vydá iframe obalený dalšími div elementy s třídami sssp-posCont a sssp-resizeCont, které generuje výdejový skript SSP. Například pro reklamní plochu formátu 300 × 250 px:

<div id="ssp-zone-123456" style="height: 250px; width: 300px; max-width: 100%;" class="adFull">
  <div class="sssp-posCont" style="width: 100%; height: 100%; position: relative;">
    <div class="sssp-resizeCont" style="width: 300px; height: 250px; position: absolute;">
      <iframe scrolling="no" id="sf1" src="//c-ko.seznam.cz/imp?k=9416459e-b71e-414c-867a-47ac9ed382b5" width="300" height="250" frameborder="0">
        // reklama jako kompletní HTML stránka
      </iframe>
    </div>
  </div>
</div>

HTML element, do kterého se úspěšně vykreslila reklama, získá třídu adFull. Pokud se reklama nevydá, element pro ni určený zůstane prázdný. Vnitřní HTML elementy se vykreslí včetně potřebných inline stylů (žádné další CSS není třeba doplňovat).

Reklamní kód musí být umístěn přímo do zdrojového kódu stránky, nesmí být od ní oddělen například obalením do dalšího iframu. Nikdy také nepřebíjejte vygenerované inline CSS styly obalujících HTML elementů .sssp-posCont a .sssp-resizeCont a atributy nastavující velikost iframe reklamy vlastním CSS. Styly ovlivňující umístění reklamy můžete aplikovat výhradně na vnější obalující element div.adFull. V něm vnořené elementy nestylujte!

2. Typ výdeje JSON

Odezvou SSP serveru je objekt JSON obsahující data reklamy. Příklady popisující strukturu JSONu (názvy proměnných a příklady jejich hodnot) pro různé typy reklamy Sklik (banner, kombinovaná reklama, dynamický retargeting a branding) jsou uvedeny v záložce Odezvy JSON.

Při výdeji reklamy s využitím dat v JSONu je nezbytné, aby callbacková funkce na partnerském webu zajistila správné hitování měřicích pixelů pro zaznamenání imprese nebo nezobrazení reklamy dle definice IAB, které v případě typu Iframe provádí výdejový JavaScript automaticky. Pokud by měření neprobíhalo správně, případně vůbec, nebylo by možné spočítat výši provize partnera a výdej do příslušných zón by se zablokoval. Více informací najdete v části Callback funkce.

Pokud se v konzoli internetového prohlížeče (zobrazí se stiskem klávesy F12) objeví hláška !!! No callback or invalid ID passed to IM (zoneId: xxxxx), znamená to, že alespoň jedna ze zón, do které chcete vydat reklamu, nefunguje správně. Častou příčinou jsou v požadavku nesprávně zadané povinné parametry nebo konflikt s nastavením zóny/webu v partnerském rozhraní. Konkrétní důvod můžete zjistit z položky dbg.error v XHR odezvě SSP serveru pro každou ze zón jednotlivě – viz přehled možných chyb.