# GVA - Configuration

### **Overview template / ad source parameters** <a href="#id-3-overview-template-a-d-source-parameters" id="id-3-overview-template-a-d-source-parameters"></a>



| 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

```json
{
  "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"
}
```
