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, or adm (Improve Digital InApp SDK JSON response).
- 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=
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 | Format | Environment |
| bundle | string | App Bundle ID | Banner, video | App |
| carrier | string | Mobile device carrier | Banner, video | App |
| conn_speed | string | Connection speed of device, only singe value is allowed. | Banner, video | App, web |
| coppa | boolean | Indicates if COPPA regulation applies, possible values are 0 or 1, where 1 = coppa applies. |
Banner, video | App, web |
| density | string | Mobile screen density | Banner | App |
| deviceh | number | Height of the device screen in pixels | Banner, video | App |
| devicew | number | Width of the device screen in pixels | Banner, video | App |
| dmp_data | string | For passing DMP data. E.g. {"dmps":{"1":["47424d5b-cb41-41a9-b3bd-df30f9bd24e 7"]}} |
Banner, video | App, web |
| extid | string | External user identifiers | Banner, video | 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. |
Banner, video | App, web |
| gdpr_consent | string | The TCF 2.0 string generated by the publisher CMP by the user. E.g. gdpr=BOQ7WlgOQ7WlgABACDENAdYAAAAVmA BAH6A |
Banner, video | App, web |
| gpid | string | Global Placement ID (GPID) | Banner, video | App, web |
| h | number | Ad slot height | Banner, video | App |
| ifa | string | Apple device ID/IDFA | Banner, video | App |
| 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. E.g. en |
Banner, video | App |
| lat | number | User's location coordinates in latitude | Banner, video | App |
| lmt | number | Limit ad tracking | Banner, video | App, web |
| lon | number | User's location coordinates in longitude | Banner, video | App |
| maxduration | number | Video ad slot maximum ad duration in seconds, e.g. 120 |
Video | App, web |
| minduration | number | Video ad slot minimum ad duration in seconds, e.g. 10 |
Video | App, web |
| omidpn | string | Identifier of the OM SDK integration. This is the same as the"name" parameter of the OMID Partner object. |
Banner, video | App |
| omidpv | string | Version of the OM SDK integration. This is the same as the "versionString" parameter of the OMID Partner object. |
Banner, video | App |
| p | number | Placement ID in the platform - this is automatically filled in the tags when downloading. |
Banner, video | App, web |
| player_height | number | Height of the video player, e.g. 1280 | Video | App, web |
| player_width | number | Width of the video player, e.g. 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), e.g. 8 |
Banner, video | App |
| referrer | string | The URL of the page initiating the ad call. Should be encoded. E.g. https%3A%2F%2Ftest.domain%2Fresource%3Fsom e%3Dquery%23hashtag |
Banner, video | App, web |
| schain | string | Schain as part of IAB Schain specification, see IAB specs. E.g. 1.0%2C0!doubleclick.net%2C pub-7345327491817577%2C1%2CubZq4g4Pre0SB 4CIA2qe5Q%2C%2 |
Banner, video | App, web |
| search | string | Comma separated list of keywords from a user's site or app search. | Banner, video | App, web |
| skip | boolean | Indicates if the player will allow the video to be skipped. Possible values are: 0=no, 1=yes. |
Video | App, web |
| skipafter | number | Number of seconds a video must play before skipping is enabled; only applicable if the ad is skippable. |
Video | App, web |
| skipmin | number | Videos of total duration greater than this number of seconds can be skippable but only applicable if the ad is skippable. |
Video | App, web |
| tz | number | Indicates the timezone offset. In banner tags this is automatically filled by Javascript. |
Banner, video | App, web |
| ua | string | User-agent | Banner, video | App, web |
| udid | string | Apple mobile device identifier | Banner, video | App |
| us_privacy | string | CCPA consent string, see IAB specs. | Banner, video | App, web |
| vast_version | number | Maximum version of VAST supported by the video player; should be a single value e.g. 2 |
Video | App, web |
| video_format_type | number | Corresponds with the OpenRTB 2.5 video.placement. Possible values: 1=In-Stream (pre, mid or postroll), 2=In-Banner, 3=In-Article, 4=In-feed, 5=Interstitial. E.g. 4 |
Video | App, web |
| vpaid_version | string | Versions of VPAID supported by the video player; this can be multiple values. E.g. 2,3,4 | Video | App, web |
| w | number | Ad slot width | Banner, video | App, web |