GVA - Configuration

Overview template / ad source parameters

Section
Description

mappings

Mapping of static values to parameter required by ad server.

functions

In some cases functions need to be executed if required by the ad server (e.g. unwrap.user-agent).

wrapperMappings

Mapping of dynamic/static parameter/values from client/ssai to the ad server only for vast wrapper sublevels.

ignoreAdBuffet

Ad buffet (or Fallback ads) function can be enabled or disabled (all fallback ads will be used, roadmap item).

conditions

Add conditions to the template to select or ignore one or more mediafiles for the same ad (aspect ratio, resolution, mediatype, bitrate.

whitelist

A list with all dynamically passed parameter from client. If not provided within whitelist parameter won’t be passed to the ad server.

ad server url

Host to request the ad server.

Example for Equativ

{
  "mappings": [
    {
      "value": "{{ip}}",
      "mapsTo": "x-forwarded-for",
      "position": "header"
    },
    {
      "value": "{{{user-agent}}}",
      "mapsTo": "user-agent",
      "position": "header"
    },
    {
      "value": "$SITEID",
      "mapsTo": "siteid",
      "position": "query"
    },
    {
      "value": "$PAGEID",
      "mapsTo": "pgid",
      "position": "query"
    },
    {
      "value": "$FMTID",
      "mapsTo": "fmtid",
      "position": "query"
    },
    {
      "value": "1",
      "mapsTo": "oc",
      "position": "query"
    },
    {
      "value": "s",
      "mapsTo": "vcn",
      "position": "query"
    },
    {
      "value": "S",
      "mapsTo": "visit",
      "position": "query"
    },
    {
      "value": "{{tmstp}}",
      "mapsTo": "tmstp",
      "position": "query"
    },
    {
      "value": "vast4.2",
      "mapsTo": "out",
      "position": "query"
    },
    {
      "value": "0",
      "mapsTo": "vpaidt",
      "position": "query"
    },
    {
      "value": "0",
      "mapsTo": "vpaidv",
      "position": "query"
    },
    {
      "value": "1",
      "mapsTo": "ab",
      "position": "query"
    },
    {
      "value": "0",
      "mapsTo": "ssar",
      "position": "query"
    },
    {
      "value": "{{maxCount}}",
      "mapsTo": "ps",
      "position": "query"
    },
    {
      "value": "{{maxDuration}}",
      "mapsTo": "mabd",
      "position": "query"
    },
    {
      "value": "0",
      "mapsTo": "pb",
      "position": "query"
    },
    {
      "value": "{{gdpr}}",
      "mapsTo": "gdpr",
      "position": "query"
    },
    {
      "value": "{{gdpr_consent}}",
      "mapsTo": "gdpr_consent",
      "position": "query"
    },
    {
      "value": "{{us_privacy}}",
      "mapsTo": "us_privacy",
      "position": "query"
    },
    {
      "value": "{{publisher domain}}",
      "mapsTo": "pgdomain",
      "position": "query"
    },
    {
      "value": "1080",
      "mapsTo": "vph",
      "position": "query"
    },
    {
      "value": "1920",
      "mapsTo": "vpw",
      "position": "query"
    },
    {
      "value": "1",
      "mapsTo": "vpt",
      "position": "query"
    },
    {
      "value": "3",
      "mapsTo": "vpmt",
      "position": "query"
    },
    {
      "value": "{{schain}}",
      "mapsTo": "schain",
      "position": "query"
    },
    {
      "value": "0",
      "mapsTo": "skip",
      "position": "query"
    },
    {
      "value": "{{appname}}",
      "mapsTo": "appname",
      "position": "query"
    },
    {
      "value": "{{bundleId}}",
      "mapsTo": "buid",
      "position": "query"
    },
    {
      "value": "{{storeUrl}}",
      "mapsTo": "srl",
      "position": "query"
    },
    {
      "value": "{{user_id}}",
      "mapsTo": "uid",
      "position": "query"
    },
    {
      "value": "{{iabframeworks}}",
      "mapsTo": "iabframeworks",
      "position": "query"
    },
    {
      "value": "{{omidpn}}",
      "mapsTo": "omidpn",
      "position": "query"
    },
    {
      "value": "{{omidpv}}",
      "mapsTo": "omidpv",
      "position": "query"
    },
    {
      "value": "{{vdmin}}",
      "mapsTo": "vdmin",
      "position": "query"
    },
    {
      "value": "{{vdmax}}",
      "mapsTo": "vdmax",
      "position": "query"
    },
    {
      "value": "{{vdmax}}",
      "mapsTo": "vdmax",
      "position": "query"
    },
    {
      "value": "{{tgt}}",
      "mapsTo": "tgt",
      "position": "query"
    },
    {
      "value": "{{ctid}}",
      "mapsTo": "ctid",
      "position": "query"
    },
    {
      "value": "{{ctn}}",
      "mapsTo": "ctn",
      "position": "query"
    },
    {
      "value": "{{content_type}}",
      "mapsTo": "ctt",
      "position": "query"
    },
    {
      "value": "{{content_category}}",
      "mapsTo": "ctc",
      "position": "query"
    },
    {
      "value": "{{content_duration}}",
      "mapsTo": "ctd",
      "position": "query"
    },
    {
      "value": "{{cts}}",
      "mapsTo": "cts",
      "position": "query"
    },
    {
      "value": "{{cte}}",
      "mapsTo": "cte",
      "position": "query"
    },
    {
      "value": "{{ctr}}",
      "mapsTo": "ctr",
      "position": "query"
    },
    {
      "value": "{{ctpid}}",
      "mapsTo": "ctpid",
      "position": "query"
    }
  ],
  "functions": {},
  "whitelist": [
    "ip",
    "user-agent",
    "maxDuration",
    "maxCount",
    "tmstp",
    "gdpr",
    "gdpr_consent",
    "us_privacy",
    "publisher domain",
    "appName",
    "bundleId",
    "storeUrl",
    "user_id",
    "iabframeworks",
    "omidpn",
    "omidpv",
    "vdmin",
    "vdmax",
    "tgt",
    "ctid",
    "ctn",
    "ctt",
    "ctc",
    "ctd",
    "cts",
    "cte",
    "ctr",
    "ctpid"
  ],
  "url": "https://videoapi.smartadserver.com/ac"
}

Last updated