Přehled nastavení SSP výdeje
Chování výdeje reklamy je možné konfigurovat pomocí funkce sssp.config(), která na vstupu očekává konfigurační objekt.
Možné konfigurační položky:
Název | Hodnoty | Popis |
---|---|---|
ab | Object | Varianta AB testu. Pokud je v sssp.getAds zadán i druhý parametr opt např. opt = {config: {ab: {test: "test"}}} , tak parametr z opt přepíše parametry z sssp.config.ab |
adblock | Boolean | Nabývá hodnoty true, pokud se reklama vydává do stránky, kde funguje antiadblock |
callCallbackOnError | Boolean | Nastavením na hodnotu true, umožní zavolaní callback fce i při error odpovědi z SSP. |
cidsAutoSend | Boolean | Určuje, zda cids se mají sbírat z response |
cookieDomain | String | Doména pro session cookie při výdeji z newsfeedu |
fallbackToGAM | Boolean : [false] | Beta verze zařazení GAMu do výdejového vodopádu v případě prázdné odpovědi z SSP. |
preparePositionsCallback | Function | Callback funkce |
protocol | String : ["http://", "https://"] | Protokol, po kterém bude SSP komunikovat |
requestErrorCallback | Function | Funkce, která se zavolá při selhání požadavku na reklamu |
server | String : ["ssp.seznam.cz", "ssp.seznam.test"] | SSP server, ze kterého bude reklama vydávána |
serviceIdForAllZones | String | Nastaví pro všechny reklamní zóny jednotné serviceId. |
source | String : ["", "hp_feed", "novinky_feed", ...] | Zdroj návštěvy webu, kam se vydává reklama |
cookieExpiration | Number : [30] | Doba expirace session cookie v minutách |
test | Boolean | Přepínač testování výdeje reklamy |
webId | Number | ID webu. Používá se pro konfiguraci CMP dialogu. |
ab
Slouží k zaznamenání vlastních variant AB testu (např. { homepageVariant: 'a' }
). Do objektu je možné vložit více hodnot.
adblock
viz tabulka
callCallbackOnError
Defaultně nastaveno na false. Když je nastaveno na true, tak se callback
funkce provolá i při chybových stavech SSP. Je potřeba pamatovat na to, že v případě standardního volání callback
funkce obdrží dva parametry, advert
a data
. Ovšem v případě chyby obdrží jako první parametr objekt chyby
a jako druhý parametr data
.
cookieDomain
viz tabulka
cookieExpiration
viz tabulka
preparePositionsCallback
Funkce se volá tehdy, pokud je v platnosti session zahájená příchodem uživatele proklikem z newsfeedu na homepagi Seznam.cz.
protocol
viz tabulka
requestErrorCallback
Callbacková funkce, kterou SSP volá v případě selhání XHR požadavku na reklamní server (např. pro vlastní logování chyb apod.). Funkci jsou předány 2 parametry:
errorName
(string) - Popis chybyerrorCode
(number) - Číselný kód chybyXMLHttpRequest
server
viz tabulka
source
Pokud se nastaví na některou z hodnot uvedených v tabulce, pak je tato hodnota posílána společně s požadavkem o reklamu. Slouží ke zpřesnění informací o stránce, která o reklamu žádá.
Hodnota „hp_feed“ se musí posílat v případě, kdy se uživatel na stránku, která si říká o reklamu, dostal proklikem z newsfeedu na homepagi Seznam.cz.
Název | Identifikátor |
---|---|
default | Sklik Partner |
hp_feed | HP feed |
novinky | Denní tisk |
media | Mediální zastupitelství |
hp_box | HP box |
search | Vyhledávání |
software | Software |
sbrowser | Seznam Prohlížeč |
radio | Rádio |
tvseznam | Televizeseznam.cz |
test
Slouží k testování výdeje reklamy, nedochází ke kontrole URL při výdeji a není účtována cena za zobrazení.
Povolené hodnoty: true
/false
- true - testovací režim
- false - provozní režim (výchozí)
webId
Nastaví hodnotu webId. Pokud je specifikována hodnota, automaticky se spustí konfigurace CMP dialogu a může způsobit jeho zobrazení i bez volání funkce sssp.getAds
.