iOS Ad Tag Targeting Macro Reference (iOS)

Ad tag macros are supported in the iOS SDK. Many VAST servers use tag variables to optimize fill and provide more information on how ads are being viewed. JWP supports a number of variables that can be added to your VAST tag URL. Once an ad call is made by JWP, the variables will be replaced accordingly.

📘
JWP supports additional ad tag targeting macros for the HTML5 web player and OTT Apps.

VAST

General

Macro	Description
__domain__	Domain name on which the player is embedded
__page-url__	File path of the video
__player-height__	Height of the video player Default: 100%
__player-width__	Width of the video player Default: 100%
__random-number__	Cache-buster to prevent caching of the VAST response
__timestamp__	Current time of the user's device

Content

Macro	Description
__item-description__	Short description of the currently playing video¹
__item-duration__	(Mid-roll, post-roll ads) Duration in seconds of the currently playing video¹
__item-file__	File URL of the currently playing video
__item-mediaid__	Custom media ID of the currently playing video¹
__item-title__	Title of the currently playing video¹

¹ Must be specified inside the playlist

Google IMA

For Google IMA, the following ad targeting macros are supported:

All ad targeting macros listed in the previous VAST section
All ad tag variables supported by Google Ad Manager (GAM)
Targeting variables added by the Google IMA SDK

As shown in the following example, users of GAM will however need to make minor alterations from the VAST examples above such as changing Google's description_url macro to description_url=__page-url__.

https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/88234159/video&impl=s&gdfp_req=1&env=vp&output=vast&unviewed_position_start=1&description_url=__page-url__&correlator=__timestamp__

See the IMA SDK Documentation for more info.