Overview: The following information is pertaining to how the IRIS.TV Contextual Video Marketplace activates contextual data to enable publishers to activate contextual private marketplace deals.
Passing the “Context” Values:
Overview: Passing the values in the “iris_context” custom macro from the Ad Server to your supply-side platform.
If your demand partner is being called directly by your ad server, you will need to ensure the “iris_context” custom macro and all values flow through from your initial ad request to your SSP partners
This is done using macros inserted into your demand partner ad tags that reference the “context” values passed to your ad server
Your demand partner should specify which key in their ad request needs to be populated with the “context” values, as this will be different from partner to partner
In GAM, “cust_params” are pulled out and passed to demand partners using the Pattern Match Macro
Google documentation on the Pattern Match Macro can be found on this page: https://support.google.com/admanager/answer/2376981?hl=en
Telaria uses the key “c4” to pass context values in their requests. Here is an example of a Telaria tag populated with GAM’s Pattern Match Macro that will pull out the “context” values sent in the cust_params section of the initial ad request:
https://5tmwh-tr5hk.ads.tremorhub.com/ad/tag?adCode=5tmwh-tr5hk&playerWidth=%%WIDTH%%&playerHeight=%%HEIGHT%%&playerPosition=preroll&videoTitle=%%VIDEO_TITLE%%&videoId=%%VIDEO_ID%%&c4=%%PATTERN:context%%&srcPageUrl=%%REFERRER_URL_ESC%%…
If not using GAM and Telaria, please consult your ad server on which macros to use to pass the “context” values, and consult your demand partner on which key to populate those values into
Compatible SSPs
The “iris_context” custom macro can be used with the following SSPs via both pre-bid and tag integrations:
Beachfront
Rubicon
Telaria
SpotX
Verizon
Adx
Xandr
Rhythm One
Passing the “iris_id” Value:
Overview: Passing the Values in the “iris_id” Custom Key Value Pair from the Ad Server to Your Supply-Side Partners
For instructions, please consult your SSP of choice on how to pass the “iris_id”. The “iris_id” will be passed into the bid-stream by the SSP, typically into the “content.id” field in content object.
After the Contextual Segments Are Passed to the SSP
Once you’ve completed passing the contextual segments to the SSP, you can move on to setting up the Tracking and Reporting for Contextual Video Marketplace: Tracking and Reporting .