You are here: Publishers > Inventory > Ad tags > Mobile app VAST ad tag setup

Mobile app VAST ad tag setup

Last updated on May 30, 2017

Video in the OpenX Ad Exchange is in Beta release only. Please contact your Account Manager to have this feature enabled.

The following instructions are for publishers who would like to configure a Video Ad Serving Template (VAST) ad tagA small piece of code that defines the ad space where ads display on a website. It includes parameters that describe the inventory advertising campaigns can target, which may in turn display ads in the ad space. for mobile appSynonymous with mobile. Refers to the use of an app via a mobile device, specifically to differentiate from mobile web. linear videoAn ad or ad unit that displays in sequence with video content in a video player. Sequencing may be pre-roll, mid-roll, or post-roll. Can be accompanied by a companion ad. An example is a video ad that plays before a video starts, though static images may also serve. ad units.

In order to complete the setup of a video ad unitThe smallest inventory component that represents the space on a site where ads display. and start serving video ads, you must configure the base VAST ad tagSynonymous with VAST URL. An HTTP-based URL that enables communication between video players and ad servers. Publishers configure these tags in order to serve video ads on their sites. generated when you create a linear video ad unit.

The screenshot below shows the base tag that results from creating a linear video ad unit, where the blurred section is a placeholder for your instance name. This base tag includes the ad unit ID (auid) and dr=true (no redirect for cookiesSmall text files sent from a web server to a browser, then returned by the browser each time it logs on to that server. Advertisers use cookies to monitor the number of ads that have been shown to a visitor, while they are used by websites to gauge numbers of unique visitors.) already appended.

VAST ad tag

Append parameters and macros

After receiving the base tag with ad unit ID, you should append parameters and macrosFor OpenX, a command enclosed in curly braces {} that dynamically inserts attributes into your HTML or third-party ad creatives and click-through URLs when OpenX serves an ad. Other macros, like from your video player, may have alternate formatting.. Appending the required and highly recommended parameters adds an additional level of detail to your tag.

Appending macros allows you to pass information dynamically, ensuring that it is as accurate as possible. You can find the relevant macros in your ad serverA complete digital advertising platform where publishers sell, manage, and deliver their advertising inventory across all digital formats. or video player's documentation, depending on where you plan to traffic your VAST ad tag.

Sample VAST ad tag - Fully configured with placeholders for macros

The example below shows a base ad tag with required and highly recommended parameters, as well as placeholders for macros. Specific integration types (like server-to-server), or inventoryAd space available on a website or app. The basic unit of inventory for OpenX is an ad unit. types (like rewarded video) have additional parameters. You can pass in parameters for settings you chose in the UI to dynamically override them as needed. Dynamically overriding the ad unit settings is helpful for many parameters, especially: URL, video player height, and video player width.

The sample VAST ad tag below is color-coded as follows:

  • Black: Base VAST ad tag
  • Red: Parameters which must be configured exactly to our specifications
  • Blue: A placeholder for the relevant macro
http://your-instance.openx.net/v/1.0/av?auid=1234567890&dr=true&af=INSERT MACRO&ifa=INSERT MACRO&ip=INSERT MACRO&lat=INSERT MACRO&lmt=INSERT MACRO&lon=INSERT MACRO&lt=INSERT MACRO&net=INSERT MACRO&url=INSERT MACRO&vht=INSERT MACRO&vwd=INSERT MACRO

Note: lmt and ifa are preferred for passing device data and recommended to be used rather than the did parameters, such as did.adid and did.adid.enabled (Android) and did.ia and did.iat (iOS).

Parameters for mobile app video ad requests

For information on the required and highly recommended parameters in the example above, as well as additional parameters, see mobile ad request parameters.

If you need to express your traffic in real time in a detailed way, you can augment your ad tag with our OpenRTB object query string argument. For more information, see OpenRTB supply-side ad request parameter values.

Incorporate your tag

Add the fully configured VAST ad tag to your ad server or video player. Please contact your OpenX Account Manager once you've completed this step.

Next steps

Now that you have configured your VAST ad tag, you need to set up OpenX selling rules.

If you're interested in learning more about video, please refer to Video setup best practices for publishers.

This topic applies to Ad Exchange.

Feedback form