Spotx: Passing Contextual Data

This details how to format the iris_context and iris_id KVPs in the SpotX tag and OpenRTB integrations.

The tag integration leverages the custom key-value pair formatting to pass in the iris_context and iris_id KVP. Here's the documentation from SpotX on how to format custom KVPs in the ad tag: https://developer.spotxchange.com/content/local/docs/publisher-resources/kvps.md#key-value-pairs-and-reporting.

This is how "iris_context" should be formatted as a custom key-value pair:

&custom[iris_context][]=ic_0755895,ic_4890138,ic_4980180&

To pass the "iris_id" will need to support the content.id field and include it in the tag to SpotX:

&content[id][]=iris_18719437&

The OpenRTB integration leverages the custom KVP object to pass in the iris_context and iris_id KVPs. Here's the documentation from SpotX on how to format custom KVPs in OpenRTB: https://developer.spotxchange.com/content/local/docs/publisher-resources/ortb-2.3-integration.md#video-ext-custom.

This is how "iris_context" and "iris_id" should be formatted in the custom object for the OpenRTB request:

{
custom : {
  "iris_context" : [
    "ic_0755895",
    "ic_4890138"
  ],
  "iris_id" : "iris_18719437"
}
}