Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Overview: Passing the values in the “iris_context” custom macro key from the Ad Server to your supply-side platformSSP.

  • If your demand partner (SSP in this case) is being called directly by your ad server, you will need to ensure the “iris_context” custom macro key 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:

...

  • 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 key is compatible with any SSPs via both pre-bid and tag integrations:

...

Beachfront

...

Rubicon

...

Telaria

...

SpotX

...

Verizon

...

Adx

...

Xandr

...

.

Passing the “iris_id” Key-Value Pair:

Overview: Passing the Values values in the “iris_id” Custom Key Value Pair key from the Ad Server to Your Supply-Side PartnersFor 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 objectyour SSP.

  • If your demand partner is being called directly by your ad server, you will need to ensure the “iris_id” key value flows 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 “iris_id” value 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:iris_id%%&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” key is compatible with any SSPs via both pre-bid and tag integrations.

After the Contextual Segments Are Passed to the SSP

...