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

{% content-ref url="../native-players/nexxplay-for-ios" %}
[nexxplay-for-ios](https://play.docs.nexx.cloud/native-players/nexxplay-for-ios)
{% endcontent-ref %}

{% content-ref url="../native-players/nexxplay-for-android" %}
[nexxplay-for-android](https://play.docs.nexx.cloud/native-players/nexxplay-for-android)
{% endcontent-ref %}