Instreamatic allows you to request ads in VAST format.
In order to do so, make an ad call to http://x{number}.instreamatic.com/v5/vast/{site_id}, where site_id is a site identifier.
https://x3.instreamatic.com/v5/vast/777 - for US server
https://x.instreamatic.com/v5/vast/420 - for EU server
777 and 420 - Test IDs
Please use these parameters only for testing purposes. We will provide your actual site_id after the integration is complete.
You need to use the following construction in order to send parameters e.g. targeting details:
http://{subdomain}.instreamatic.com/v5/{format}/{site_id}/{player_id}?slot={slot}&noad={noad}&preview={preview}&user_id={user_id}&ip={ip}&gender={gender}&age={age}&country={country}®ion={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/v5/vast/420?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/v5/vast/777"}});
Please find the documentation on VAST format for reference - https://www.iab.com/wp-content/uploads/2015/06/VASTv3_0.pdf