iOS Ad Tag Targeting Macro Reference (iOS)

Use macros to target ad tags.


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

MacroDescription
__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

MacroDescription
__item-description__Short description of the currently playing video1
__item-duration__(Mid-roll, post-roll ads) Duration in seconds of the currently playing video1
__item-file__File URL of the currently playing video
__item-mediaid__Custom media ID of the currently playing video1
__item-title__Title of the currently playing video1

1 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.