/
VAST Tags

VAST Tags

Background

After creating placements in the platform it is possible to download banner Javascript, banner iframe or VAST tags. These tags can be booked into a third party ad server or tag manager to send inventory to the platform.

 

Handlers

Tag handlers determine to type of ads can compete in the auction:

  • Banner desktop and mobile web: adi (iframe) or adj (JavaScript)

  • Banner app: adi (iframe) or adj (JavaScript) for web apps and third party ad servers.

  • VAST Video: advast

VAST Video

See the table in Passing essential auction data below for the list and definitions of get parameters.

Video Examples

Tags contain get parameters to pass essential data to the platform. Add your ad server macros corresponding to each get parameter after the '=' in both script and noscript sections. Note that these examples do not contain example third-party macros.

App Video

https://ad.360yield.com/advast?p=12345&bundle=&carrier=&conn_speed=&coppa=&deviceh=&devicew= &extid=&gdpr=&gdpr_consent=&gpid=&ifa=&is_rewarded=&language=&lat=&lmt=&lon=&maxduration=&minduration=&omidpn=&omidpv=&optin=&player_height=&player_width=&ppi=&referrer=&schain=&skip=&skipafter&skipmin=&tz=&ua=&udid=&us_privacy=&vast_version=&video_format_type=&vpaid_version=

Website Video

https://ad.360yield.com/advast?p=12345&conn_speed=&coppa=&extid=&gdpr=&gdpr_consent=&gpid=&is_rewarded=&lmt=&maxduration=&minduration=&optin=&player_height=&player_width=&ppi=&referrer=&schain=&skip=&skipafter=&skipmin=&tz=&ua=&us_privacy=&vast_version=&video_format_type=&vpaid_version=

VAST Audio

App Audio

https://ad.360yield.com/pub_ID/advast?p=placement_ID&imp_type=audio&bundle=eceapp&ua=placeholder&language=en&minduration=10&maxduration=30&ip=placeholder&storeurl=placeholder&ccat=IAB7-11&feed=3&series=Ece%20playground&title=Ece_test_podcast&context=3&mimes=audio/mpeg,audio/aac,audio/mp4&gpdr=1&gdpr_consent=placeholder

Website Audio

https://ad.360yield.com/pub_ID/advast?p=placement_ID&imp_type=audio&ua=placeholder&language=en&minduration=10&maxduration=30&ip=placeholder&storeurl=placeholder&ccat=IAB7-11&feed=3&series=Ece%20playground&title=Ece_test_podcast&context=3&mimes=audio/mpeg,audio/aac,audio/mp4&gpdr=1&gdpr_consent=placeholder


Note: title & series & feed are for especially podcast & radio inventory.


Banner

Banner Examples

Tags contain get parameters to pass essential data to the platform. Add your ad server macros corresponding to each get parameter after the '=' in both script and noscript sections. Note that these examples do not contain example third-party macros.

App Banner

<script type="text/javascript">document.write('<scr'+'ipt type="text/javascript" src="https://ad.360yield.com/adm?p=12345&bundle=&carrier=&conn_speed=&coppa=&density=&deviceh=&devicew=&gdpr=&gdpr_consent=&h=&ifa=&is_rewarded=&language=&lat=&lon=&lmt=&omidpn=&omidpv=&optin=&ppi=&schain=&ua=&us_privacy=&w=&tz='+(new Date().getTimezoneOffset())+'"><\/scr'+'ipt>');</script><noscript><a target="_blank" href="https://ad.360yield.com/adm?p=12345&bundle=&carrier=&conn_speed=&coppa=&density=&deviceh=&devicew=&gdpr=&gdpr_consent=&h=&ifa=&is_rewarded=&language=&lat=&lon=&lmt=&omidpn=&omidpv=&optin=&ppi=&schain=&ua=&us_privacy=&w="><img border="0" alt="" src="https://ad.360yield.com/adm?p=12345&bundle=&carrier=&conn_speed=&coppa=&density=&deviceh=&devicew=&gdpr=&gdpr_consent=&h=&ifa=&is_rewarded=&language=&lat=&lon=&lmt=&omidpn=&omidpv=&optin=&ppi=&schain=&ua=&us_privacy=&w="/></a></noscript>

Website Banner

<script type="text/javascript">document.write('<iframe frameborder="0" marginwidth="0" marginheight="0" scrolling="NO" width="1" height="1" src="https://ad.360yield.com/adi?p=12345&w=1&h=1&optin=&tz='+(new Date().getTimezoneOffset())+'"></iframe>');</script>

Downloading Tags

Once the Inventory setup is complete in the platform the tags can be downloaded in Inventory, either using:

  • the actions menu on each Site/App, Zone and Placement summary page

  • the option within a saved Site or Placement.

Passing essential auction data

Depending on the publisher ad server, it's essential to add additional data which will be used by the platform to increase demand opportunities. This is done in the form of get parameters in the tags. Tags downloaded from the platform contain placeholders which should be replaced with the publisher ad server macros for the specific data.

Note that the parameters listed below are reserved and can only be used for the purposes specified below. Including data in tags overrides any data saved in platform settings with the exception of ad slot height and width.

Get
Parameter

Value

Description

Example

Format & Environment

appname

string

Application name (max 500 characters)

MyApp

Video, audio; App

bundle

string

App Bundle ID

 

Video, audio; App

bidfloor

number

default USD

 

Video, audio; App, web

bidfloorcur

string

default USD

 

Video, audio; App, web

carrier

string

Mobile device carrier

 

Video, audio; App

ccat

string

Comma-separated list of content categories (IAB categories)

 

Video, audio; App, web

channel_name

string

Content channel name

 

Video, audio; App, web

conn_speed

string

Connection speed of device, only singe value is allowed.

 

Video, audio; App, web

contentrating

string

Content rating (max 500 characters)

PG-13

Video, audio; App

context

number

content.context values

1

Video, audio; App, web

coppa

boolean

Indicates if COPPA regulation applies, possible values are
0 or 1, where 1 = coppa applies.

0 or 1

Video, audio; App, web

density

string

Mobile screen density

 

Banner; App

deviceh

number

Height of the device screen in pixels

 

Video, audio; App

devicew

number

Width of the device screen in pixels

 

Video, audio; App

dooh_multiplier

number

multiplier used for dooh video (response price is in cpm)* required for advast dooh requests - can be set as 1 if no multiplier is being used by publisher

 

Video; DOOH

dmp_data

string

For passing DMP data, encoded

{"dmps":{"1":["47424d5b-cb41-41a9-b3bd-df30f9bd24e
7"]}}

Video, audio; App, web

episode

number

Episode number

 

Video, audio; App, web

extid

string

External user identifiers

 

Video, audio; App, web

feed

number

Type of audio feed. Refer to List: Feed Types in AdCOM 1.0.

 

Video, audio; App, web

gdpr

boolean

Identifies if the user is a subject of GDPR i.e. their IP
address is in an EU country. Possible values are 1 or 0.

 

Video, audio; App, web

gdpr_consent

string

The TCF 2.0 string generated by the publisher CMP by the
user

BOQ7WlgOQ7WlgABACDENAdYAAAAVmA

BAH6A

Video, audio; App, web

gender

string

User gender. Allowed values: M (male), F (female), O (other)

M

Video, audio; App, web

genres

string

Comma-separated list of content genres

 

Video, audio; App, web

gpid

string

Global Placement ID (GPID)

 

Video, audio; App, web

gpp

string

global privacy policy - global version for passing gdpr consent and us_privacy and other tcf style consent strings - Note Iceberg ad server only reacts to tcf v2 on wards and us privacy (California) - other values will be passed in the ad chain

 

Video, audio; App, web

gpp_sid

number

gpp section id - used to determine protocol used when sending gpp (optional)

 

Video, audio; App, web

h

number

Ad slot height

 

Banner, video; App

ifa

string

Apple device ID/IDFA

 

Video, audio; App

imp_type

string

Used to determine video from audio

audio

Audio; App, web

ip

string

device IPv4 address

 

Video, audio; App, web

ipv6

string

device IPv6 address

 

Video, audio; App, web

is_rewarded

number

If a placement is offered as a "rewarded" impression.
Possible
values are 0 and 1, where 1 indicates rewarded.

 

Banner, video; App, web

language

string

Language set on the user's device in ISO Alpha-2
format; see ISO 639-1

en

Video, audio; App;

lat

number

User's location coordinates in latitude

 

Video, audio; App

lmt

number

Limit ad tracking

 

Video, audio; App, web

lon

number

User's location coordinates in longitude

 

Video, audio; App

maxduration

number

Video ad slot maximum ad duration in seconds

120

Video, audio; App, web

minduration

number

Video ad slot minimum ad duration in seconds

10

Video, audio; App, web

maxseq

number

Used for ad pods to indicate max number of ads per pod, e.g. maxseq=3

 

/advast; App, web

mimes

string

Comma-separated list of supported MIME types for video/audio content

&mimes=audio/mpeg,audio/aac,audio/mp4

Video, audio; App, web

network_name

string

Content network name

 

Video, audio; App, web

omidpn

string

Identifier of the OM SDK integration. This is the same as the "name" parameter of the OMID Partner object.

 

Video, audio; App

omidpv

string

Version of the OM SDK integration. This is the sameas the "versionString" parameter of the OMID Partner object.

 

Video, audio; App

p

number

Placement ID in the platform - this is automatically filled in the tags when downloading.

 

Video, audio; App, web

poddur

number

Max length in seconds of ad pod

60

Video; App, web

player_height

number

Height of the video player

1280

Video; App, web

player_width

number

Width of the video player

720

Video; App, web

ppi

number

Defines the pixels per inch for InApp requests and used as the value of bid.device.ppi field in OpenRTB
requests (2.5 protocol version only)

8

Banner, video; App

referrer

string

The URL of the page initiating the ad call. Should be
encoded

https%3A%2F%2Ftest.domain%2Fresource%3Fsom
e%3Dquery%23hashtag

Video, audio; App, web

rqddur

number

Used to denote if each ad pod creative must be a fixed duration (same duration for each creative and is not slot specific).

rqddur will override maxduration.

If poddur, maxseq and rqddur are not mathematically compatible the platform will attempt to fill the pod with the max number of ads of rqddur and not exceed poddur. The publisher should ensure when using rqddur that the requests configuration is mathematically correct, i.e. rqddur = 15, maxseq = 4, poddur = 60.

It is advised to not mix maxduration/minduration and rqddur in same request.

15

Video; App, web

schain

string

Schain as part of IAB Schain specification, see
IAB specification

1.0%2C0!doubleclick.net%2C

pub-7345327491817577%2C1%2CubZq4g4Pre0SB

4CIA2qe5Q%2C%2

Video, audio; App, web

search

string

Comma separated list of keywords from a user's site or app search.

 

Video, audio; App, web

series

string

Content series name (max 500 characters)

 

Video, audio; App, web

skip

boolean

Indicates if the player will allow the video to be skipped. Possible
values are: 0=no, 1=yes.

0