VAST Macros

nexxPLAY can automatically modify given VAST/VPAID URLs with dynamic content on the fly. As every Ad Provider uses its own Set of Macros/dynamic Replacements, you must modify the VAST URL from your Provider by replacing its Macro Syntax by a Syntax, that nexxPLAY can parse.

The following Macros are currently supported:

Macro

Description

{general.random}

a random Value (often called CacheBuster)

{general.unique}

a unique ID (of the Session)

{page.url}

the URL of the current Page (or of the parent Page, if inside an iFrame)

{page.externaldata}

the result of a predefined Function, that the Player will call to get this String (not available in Apps, iFrames or AMP)

{player.width}

the current Width of the Player

{player.height}

the current Height of the Player

{media.id}

the Media ID

{media.title}

the Media Title

{media.duration}

the Media Duration (in Seconds, not available on Live Media)

{container.index}

the Position of the current Media inside a Container

{channel.adreference}

the Ad Reference Token of the Media Channel

{studio.adreference}

the Ad Reference Token of the Media Studio

{domain.adreference}

the Ad Reference Token of the current Domain

{session.deliverypartner}

the Ad Reference Token of the Delivery Partner of the Session

{session.campaign}

the Ad Reference Token of the Campaign of the Session

{session.gdprapplies}

depending on a TCF 2.0 compliant Frontend, this will be "1" or "0"

{session.consentstring}

the Consent String of the Pages TCF Environment

{session.trackingoptouted}

the current User denied/allowed the Use of personalized Ads/Tracking

{user.loggedin}

depending of the Login State, will be "user" or "non_user"

{app.adidentifier}

the App Ad Identifier (IDFA) (only in native Players)

{app.bundle}

the App Bundle ID (only in native Players)

These Macros are also supported by nexxPLAY for iOS and nexxPLAY for android.

Last updated