What macros does Brid support?

The Brid player has support for the following macros regarding ad tags:

• [referrer_url] - Will replace with the referrer URL
• [page_url] - Will replace with the page URL
• [description_url] - Will be replaced with the description URL which should typically be the same as the referrer URL
• [video_title] - Will replace with the title of the video
• [video_tags] - Will replace with comma-separated tags of the video
• [description] - Will be replaced with the video's description
• [video_duration] - Will replace with the video duration in seconds
• [vpmute] - Will return 0 or 1 depending on the mute state of the player
• [video_id] - Will replace with the ID of the video
• [timestamp] - Use as a cachebuster
• [player_width] - Will return the player's width in pixels
• [player_height] - Will return the player's height in pixels
• [player_id] - Will return the ID of the player used
• [autoplay] - Will return 1 or 0 depending on if the player autoplays or not
• [mediafile_url] - Will be replaced with the full URL to the video file
• [user_agent] - Will be replaced with the browser user agent
• [user_ip] - Will be replaced with the IP address of the viewer (premium plans only)
• [latitude] - Will be replaced with a viewers Geo latitude value (premium plans only)
• [longitude] - Will be replaced with a viewers Geo longitude value (premium plans only)
• [viewability] - Will return 1 or 0 depending on if the player is in view when your ad tag gets called
• [dnt] - A do not track macro. Will return 0 or 1 depending on the user.
• [gdpr] - A flag for European Union traffic consenting to advertisements.
• [consent] - A consent string passed from various Consent Management Platforms (CMP's).
• [us_privacy] - A mandatory string for all publishers in which they must pass the privacy consent for users from California
• [uid] - Will be substituted with the session ID of a user.
• [nonce] - Used for setting PPID's from Nonce Loaders.
• [paln] - Used for setting PPID's from Nonce Loaders.
• [iab_taxonomy] - Used for contextual advertising. Will be replaced with iab category information.
• [video_iab_categories] - Used for substituting the IAB categories a video belongs to.

PrebidJS only macros (used for advanced bidder setups)

• __playerId__ - Will be replaced with the unique ID of the player used
• __playerWidth__ - Will be replaced with the current player width in pixels
• __playerHeight__ - Will be replaced with the current player height in pixels
• __pageUrl__ - Will be replaced with the URL where the player is being rendered
• __videoId__ - Will be replaced with the unique ID of the embedded video
• __videoTitle__ - Will be replaced with the title of the video that is embedded
• __videoUrl__ - Will be replaced with the direct URL to the video file

Mobile IN-APP only macros

• [app_bundle] - app bundle
• [app_name] - app name
• [device_make] - device make
• [device_model] - device model
• [device_id] - user device id for all device types

Dynamic macros

The Brid player also has support for dynamic macros. If you set up a Brid dynamic macro object on your page, the player can read it and insert dynamic strings into your ad tag URL.

Example

Here's an example config object that the player expects on your web page:

<script type="text/javascript">
var bridMacros = {
 cat: "Category",
 label: "Label"
};
</script>

In your ad tag URL that you have entered inside the CMS, you can now use a dynamic macro like this:

https://youradtagurl.com/firstparam=[brid_cat]&secondparam=[brid_label]

NOTE: Make sure that the bridMacros object exists on your page where the player is present The player needs to have access to this object to properly populate dynamic macros. Make sure that this object is present and loaded before the player on your page.

Dynamic macros are always in the form of [brid_{propertyName}]. Make sure to properly match them between what you set up on your page and what you entered in the CMS.

There is no limit to how many dynamic macros you can pass to the player this way.