Přeskočit na hlavní obsah

DSP nastavení

Umožní nastavení DSP pomocí query v url adrese.

Název parametru v query: single / multi requestNastaví hodnoty v requestuPopis nastaveníMožné hodnoty
ssp_zoneId / ssp_zoneId-1Slouží k identifikaci zóny, do které se mají parametry vkládat.
Pokud není zadáno, tak fallback je parametr crid, který nastavuje do všech zón parametry z url query.
Pokud není zadáno zoneId a ani crid, tak fallback je parametr bannerId s kombinaci dsp a hodnotou dsp rovnou advert, který nastavuje do všech zón parametry z url query.
ssp_target / ssp_target-1Slouží k nastavení target pro konfiguraci VAST. Kde hodnota 0 je default pro konfiguraci XHR rozhraní a hodnota 1 pro konfiguraci VAST rozhraní.0, 1
ssp_width / ssp_width-1zone.widthSlouží k nastavení width zóny.
ssp_height / ssp_height-1zone.heightSlouží k nastavení height zóny.
ssp_minWidth / ssp_minWidth-1zone.minWidthSlouží k nastavení minWidth zóny.
ssp_minHeight / ssp_minHeight-1zone.minHeightSlouží k nastavení minHeight zóny.
ssp_adType / ssp_adType-1zone.preview.adTypeSlouží k nastavení adType zóny v klíči preview.BANNER, COMBINED, DRTG, VIDEO, BUMPER, EXTERNAL,
BRANDING, DYNAMIC_BANNER, HTML5_BANNER, VAST
ssp_bannerid / ssp_bannerid-1zone.preview.banneridSlouží k nastavení bannerid zóny v klíči preview.
Pokud není nastaveno ssp_zoneId, tak vloží do všech zón, hodnoty z url query.
ssp_crid / ssp_crid-1zone.preview.cridSlouží k nastavení crid zóny v klíči preview.
Pokud není nastaveno ssp_zoneId, tak vloží do všech zón, hodnoty z url query.
ssp_deliveryType / ssp_deliveryType-1zone.preview.deliveryTypeSlouží k nastavení deliveryType zóny v klíči preview.iframe, code, cast, json, native
ssp_dsp / ssp_dsp-1zone.preview.dspSlouží k nastavení dsp zóny v klíči preview.sklik, advert, ogar, onegar
ssp_mediaType / ssp_mediaType-1zone.preview.mediaTypeSlouží k nastavení mediaType zóny v klíči preview.display, video, native
grantConsentgrantConsentSlouží k vynucenní euconsentu / souhlasu pro reklamy, které je potřebují pro správné fungování.true

Příklad multirequestu při použití parametrů ssp_zoneId v url

Nastavení url query parametru

UrlQuery parametr
www.stranka.cz?ssp_zoneId-1=60725&ssp_width-1=3000&ssp_adType-1=BANNER&ssp_dsp-1=ogar&ssp_zoneId-2=47629&ssp_width-2=4000&&ssp_height-2=4000&ssp_adType-2=VIDEO&ssp_dsp-2=onegar&grantConsent=true

Request payload

{
// "grantConsent", který se shoduje s hodnotou z klíče parametru "grantConsent" v url
"grantConsent": true,
"zones": [
{
//"zoneId", které se shoduje s hodnoutou z klíče parametru "ssp_zoneId" v url
"zoneId": 60725,
// "width" modifikovaná na základě "ssp_width-1=3000" parametru v url
"width": 3000,
"height": 210,
"options": {},
// vložený klíč preview
"preview": {
//vložený klíč a hodnota na základě "ssp_adType-1=BANNER" parametru v url
"adType": "BANNER",
//vložený klíč a hodnota na základě "ssp_dsp-1=ogar" parametru v url
"dsp": "ogar",
},
},
{
//"zoneId", které se shoduje s "ssp_zoneId-2" argumentem v url
"zoneId": 47629,
// "width" modifikovaná na základě "ssp_width-2=4000" parametru v url
"width": 4000,
// "width" modifikovaná na základě "ssp_height-2=4000" parametru v url
"height": 4000,
"options": {},
// vložený klíč previews obsahujíci hodnoty z url parametru
"preview": {
//vložený klíč a hodnota na základě "ssp_adType-2=VIDEO" parametru v url
"adType": "VIDEO",
//vložený klíč a hodnota na základě "ssp_dsp-2=onegar" parametru v url
"dsp": "onegar",
},
// ostatní zóny nejsou modifikovány, protože jejich "zoneId" není zadáno v url parametru ssp_zoneId-"číslo"
{
"zoneId": 12345,
},
},
];
}

Příklad single requestu při použití parametrů ssp_zoneId v url

Nastavení url query parametru

UrlQuery parametr
www.stranka.cz?ssp_zoneId=60725&ssp_width=3000&ssp_adType=BUMPER&ssp_dsp=ogar&grantConsent=true

Request payload

{
// "grantConsent", který se shoduje s hodnotou z klíče parametru "grantConsent" v url
"grantConsent": true,
"zones": [
{
//"zoneId", které se shoduje s hodnoutou z klíče parametru "ssp_zoneId" v url
"zoneId": 60725,
// "width" modifikovaná na základě "ssp_width=3000" parametru v url
"width": 3000,
"height": 210,
"options": {},
// vložený klíč "preview" obsahujíci hodnoty z url parametru
"preview": {
//vložený klíč a hodnota na základě "ssp_adType=BUMPER" parametru v url
"adType": "BUMPER",
//vložený klíč a hodnota na základě "ssp_dsp=ogar" parametru v url
"dsp": "ogar",
},
},
// ostatní zóny nejsou modifikovány, protože jejich "zoneId" není zadáno v url parametru ssp_zoneId-"číslo"
{
"zoneId": 47629,
},
];
}

Příklad single/ multirequestu při použití parametru ssp_crid v url

  • nastaveni vloží do všech zón hodnoty z query parametru v url

Nastavení url query parametru

UrlQuery parametr
www.stranka.cz?ssp_crid=1111&ssp_width=3000&ssp_adType=EXTERNAL&ssp_dsp=ogar&grantConsent=true

Request payload

{
// "grantConsent", který se shoduje s hodnotou z klíče parametru "grantConsent" v url
"grantConsent": true,
"zones": [
{
"zoneId": 60725,
// "width" modifikovaná na základě "ssp_width=3000" v parametru v url
"width": 3000,
"height": 210,
"options": {},
// vložený klíč preview
"preview": {
//vložený klíč a hodnota na základě "ssp_crid=1111" parametru v url
"crid": "1111",
//vložený klíč a hodnota na základě "ssp_adType=EXTERNAL" parametru v url
"adType": "EXTERNAL",
//vložený klíč a hodnota na základě "ssp_dsp-1=ogar" parametru v url
"dsp": "ogar",
},
},
{
"zoneId": 47629,
// "width" modifikovaná na základě "ssp_width=3000" parametru v url
"width": 3000,
"height": 300,
"options": {},
// vložený klíč "preview" obsahujíci hodnoty z url parametru
"preview": {
//vložený klíč a hodnota na základě "ssp_crid=1111" parametru v url
"crid": "1111",
//vložený klíč a hodnota na základě "ssp_adType=EXTERNAL" parametru v url
"adType": "EXTERNAL",
//vložený klíč a hodnota na základě "ssp_dsp=ogar" parametru v url
"dsp": "ogar",
},
},
];
}