Ad tag macros
Improve ad targeting using ad macros
What are advertising macros?
An ad macro is a placeholder you can add in your VAST ad tag and which will dynamically insert values before the ad is served to your Player.
These ad macros are using tag variables, which are predefined values that can be used to pass information about the content, the user or the device.
Ad macros allow Dailymotion to optimize fill rate and ad targeting on your content inventory.
Implement ad macros
Ad macros can be implemented following these steps:
- Define your needs - Reach out to your Dailymotion Account Manager to discuss in detail your targeting needs and your specifications.
- Define the right tag variables - Dailymotion will define the tags fitting your requirements and implement them in your VAST tag.
Supported tag variables
The tables below provide a non-exhaustive list of tag variables that we support, and examples illustrating how they are replaced with real values at runtime in an ad request.
Ad request data
| The correlator parameter is used to associate multiple ad requests from the same page view, ensuring competitive exclusions, even without cookies. - If the IMA SDK is used: The SDK automatically sets the value of the correlator. If your Player attempts to set it, the SDK will override it with its own value. - If the IMA SDK is not used: You must set this parameter with a unique, positive, random integer value. Example: |
| VPA = Video Play Automatic Possible values are Example: |
| Indicates whether the ad video was played with sound (0) or without sound (1). Example: |
| Indicates the ad position. Possible values: Example: |
| Indicates if the ad is set to play automatically (1) or not (0) Example: |
| Height of the current creative in pixels. |
| Width of the current creative in pixels. |
GDPR
| Indicates if GDPR is required (1) or not (0). This must be used with the |
| User GDPR consent string. Example:
|
Player data
| The URL of the website on which the Player is embedded. Example: |
| Indicates the Partner's Player ID. Each Player has a unique ID that allows them to be identified. Example: |
| Indicates if the Player starts automatically when the user is landing on the page, even if the Player is not visible. Possible values are Example: |
| Indicates the volume at which the video is played: |
Content data
| Dailymotion profile ID. Example: |
|---|---|
| Dailymotion profile name. Example: |
| The ID of the content. Example: |
| The ID of the video. Example: |
| Title of the video. Example: |
| Description of the content. Example: |
| Video language. Example: |
| Keywords that Partner defined in their Dailymotion Studio to describe a video. Example: |
| The type of content. Possible values: Example: |
| Content duration in seconds. Example: |
Note:For optimal performance, only use tag variables supported by your ad server. See the ad servers supported by Dailymotion.
More customization options:If you have specific needs that go beyond standard macros, you can further optimize your ad targeting and dynamically send additional custom values through the Player parameters using our Custom Config solution.
Please contact your Dailymotion Account Manager for more information.
Ad macro example
Reminder:As a publisher, you don’t have to handle variables. This process is entirely managed by our team.
Once you've defined your needs and communicated them to your Account Manager, Dailymotion will add dedicated tag variables in your VAST tag. For example, we might add ${context.embedder} and [CACHEBUSTING].
Your VAST with tag variables will look like this on Dailymotion side:
https://pubads.g.doubleclick.net/gampad/ads?description_url=${context.embedder}&correlator=[CACHEBUSTING]&iu=/123456/test&sz=640x360&env=vp&impl=s&gdfp_req=1&output=vast&unviewed_position_start=1
At runtime, the tag variables will dynamically be replaced with actual values.
For example, ${context.embedder} might be replaced by https://dailymotion.com and [CACHEBUSTING] might be replaced by a unique value like 2843743232552991, which will look like this:
https://pubads.g.doubleclick.net/gampad/ads?description_url=https%3a%2f%2fdailymotion.com&correlator=2843743232552991&iu=/123456/test&sz=640x360&env=vp&impl=s&gdfp_req=1&output=vast&unviewed_position_start=1
Supported ad servers
Dailymotion may integrate ad servers that are compliant with the IAB's VAST standard. Dailymotion supports – but is not restrictive to – the following ad servers:
| AdForm | Brightroll | Google Ad Manager | Nexx360 |
| Smart Ad Server | SpotXchange | Springserver | SunMedia |
Updated 7 months ago
