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",
      },
    },
  ];
}