# 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="/pages/-M9Ye7-tHyas2tvRenYE" %}
[nexxPLAY for iOS](/native-players/nexxplay-for-ios.md)
{% endcontent-ref %}

{% content-ref url="/pages/-M9Ye9Mxc1uksG\_XiGUp" %}
[nexxPLAY for Android](/native-players/nexxplay-for-android.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://play.docs.nexx.cloud/integration-enhancements/vast-macros.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.