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