Instreamatic VAST

Instreamatic allows you to request ads in VAST 2.0 and 3.0 format.
In order to do so, for VAST 2.0 (Default), run a query at  http://x{number}.instreamatic.com/v2/vast/{site_id}, where site_id is a site identifier.
For VAST 3.0, please contact us first to enable the 3.0 protocol version and then change v2 to v3 in the request. 
​
The test tags
​https://x3.instreamatic.com/v2/vast/777 - for US server
​https://x.instreamatic.com/v2/vast/777?preview=11 - for EU server
777 - Test id and preview=11 is a test flag.
Please use these parameters only in case of testing. We will provide you with your actual site_id during the final integration. 
​
Ad request parameters
You need to use the following construction in order to send parameters e.g. targeting details: 
http://{subdomain}.instreamatic.com/v2/{format}/{site_id}/{player_id}?slot={slot}&noad={noad}&preview={preview}&user_id={user_id}&ip={ip}&gender={gender}&age={age}&country={country}&region={region}&media={media}&{variable}={variable.value}
Where:
Parameter Name
Description
subdomain
Ad server. Can be x or x3 depending on which VAST you will use.
format
Server response format. Can be vast or DAAST.
slot
The slot type - preroll/midroll/postroll. Can be empty if you don't need to specify the slot type
preview
Flag for tests. Not to be used in production environment.
user_id
Optional user identifier, you will receive the necessary information on it from support if needed.
ip
ip address for geo-targeting
gender 
Gender parameter for targeting
age
Age parameter for targeting in min-max format
country
Country code in a format ISO 3166-1 alpha-2
region
Geoip code for a region
media
Preset for the format of your creative: mp4, mp3, ogg. (if needed)
idfa
Advertising id for iOS
advertising_id
Advertising id for Android (gaid can also be used instead of advertising_id)
user_agent
Can be used if you need to specify a certain platform in ad request
type
Campaign type (any|radio|digital|voice)
variable
Custom variable for precise targeting needs. Please contact support.
You can also use 'Variables' for additional targeting options. You need to discuss variables names you want to use, and their values with your manager. 
Then you will be able to use it as follows:
{variable.name}={variable.value}, for example: 
https://x.instreamatic.com/v2/vast/777?genre=pop
​
Example VAST usage for JWPlayer 6
jwplayer("player").setup({
    file: "http://content.jwplatform.com/videos/bkaovAYt-640.mp4",
    width: '640px',
    height: '380px',
    aspectratio: '4:3',
    primary: 'flash',
    advertising: {
      client: "vast",
      tag: "//x3.instreamatic.com/v2/vast/777?preview=11"
    }
  });
​
Please find the documentation on VAST format for reference -  https://www.iab.com/wp-content/uploads/2015/06/VASTv3_0.pdf​
​

General Information - Previous

Testing and Activation

Next - Audio Ads

Web SDK

Last updated 5 months ago

Parameter Name	Description
subdomain	Ad server. Can be x or x3 depending on which VAST you will use.
format	Server response format. Can be vast or DAAST.
slot	The slot type - preroll/midroll/postroll. Can be empty if you don't need to specify the slot type
preview	Flag for tests. Not to be used in production environment.
user_id	Optional user identifier, you will receive the necessary information on it from support if needed.
ip	ip address for geo-targeting
gender	Gender parameter for targeting
age	Age parameter for targeting in min-max format
country	Country code in a format ISO 3166-1 alpha-2
region	Geoip code for a region
media	Preset for the format of your creative: mp4, mp3, ogg. (if needed)
idfa	Advertising id for iOS
advertising_id	Advertising id for Android (gaid can also be used instead of advertising_id)
user_agent	Can be used if you need to specify a certain platform in ad request
type	Campaign type (any\|radio\|digital\|voice)
variable	Custom variable for precise targeting needs. Please contact support.