SERVERSIDE.AI
  • Welcome to serverside.ai
  • Getting Started
    • Prerequisites
    • Onboarding Guide
      • Serverside.ai: Create an account
      • Prepare content source
        • Encoding specification
        • Packaging specification
        • Ad-Marker specification
          • SSAI LIVE - SCTE35
          • SSAI VoD - AdCuePoints
      • Request SSAI enabled stream
    • Features
  • Content Source
    • Encoding
    • Packaging
      • HLS
      • DASH
    • Protection
    • Ad-Marker Specifications
  • Video Player/App
    • Live - DASH/HLS
    • VOD - DASH/HLS
    • VAST Tracking
      • Live - DASH
      • Live - HLS
      • VOD - DASH/HLS
      • ClientSideTracking SDK
    • Timeshift/Startover for LIVE
    • Playlist size for LIVE
    • PauseLiveTV
  • Ad-Server Integration
    • Ad-Server Parameter
      • Equativ/ SmartAdServer
      • Freewheel
      • Google Ad Manager
      • SpotX
    • GVA - Generic VAST Adapter
      • GVA - Configuration
    • 3rd Party Audience Data Integration/DMP
  • Ad Media Condition and Delivery
    • Ad Media - Origin integration
    • Ad Media - CDN integration
    • Prefetch API
  • Manual - User Interface
    • Account
    • Channels/Streams
    • Reports
    • Assets
  • REST API
    • Channels
      • API routes - Channels
      • VOD Channels
      • Detailed channel analysis errors
    • Reports
      • API Routes - reports
    • Playlists
    • Error responses for all routes
    • Further Documentation
  • Support
    • About support case management
    • Creating a case
    • Case language
    • Case processing
    • Booking a meeting
    • Requesting elevated attention
    • Closing a case
  • FAQ - Questionnaire - Glossary
    • Q&A
    • Questionnaire
    • Glossary
    • Files
  • Quality of Service
  • Release Notes
    • Version 2.1.0.x
    • Version 2.0.7.x
    • Version 2.0.6.x
    • Version 2.0.5.x
Powered by GitBook
On this page
  • Overview template / ad source parameters
  • Example for Equativ
  1. Ad-Server Integration
  2. GVA - Generic VAST Adapter

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"
}
PreviousGVA - Generic VAST AdapterNext3rd Party Audience Data Integration/DMP

Last updated 1 year ago