Supply-Side Platform Data Activation

Overview: Below is information pertaining to how supply-side platforms can activate contextual data for their publisher customers.

Continuation from https://iristv.atlassian.net/wiki/spaces/API/pages/744914959:

Once publishers have completed the appropriate steps to pass contextual data to their SSP of choice the SSP can complete the following:

Data to be passed from the Publisher to the SSP:

Once the publisher has integrated with the IRIS.TV Contextual Video Marketplace they will receive data on their video assets.

Example of the IRIS.TV Context API response with data for a publisher video asset:

{
  "success": true,
  "video_info": {
    "iris_id": "iris_098eiman91",
    "context": [
      "context_1", 
      "context_2", 
      "context_3"
    ],
    "iris_id_expires_at": 1588636800
  }
}

Using the “iris_context” Custom Macro:

Once the publisher has completed the steps to pass the “iris_context” custom macro to their SSP the SSP will be able to utilize the key value pairs to target and curate PMPs for advertisers.
The “iris_context” custom macro can be mapped to any necessary field in the SSP and will contain all context and brand-safety data segments available for the applicable video.

Using the “iris_id” Custom Macro:

Once the publisher has completed the steps to pass the “iris_id” custom macro to their SSP the SSP will be able to pass the “iris_id” into the bidstream.
The SSP will need to map the “iris_id” into the “content.id” field in the bidstream, the “content.id” field can be located in the content object.

Example of the “iris_id” in the content object field in the bidstream:

},
“content”: {
	“id”: “iris_12344556”,
	“title”: “[title]”,
	“series”: “[series]”,
	“cat”: “[category]”,
	“contentrating”: “TV-PG”,
	“context”: 1,
	“producer”: “[producer]”,
		“id”: “[network]”,
		“name”: “[network_name]”,
	},
	“len”: “[seconds]”
	“genre”: “Comedy”,
}

Once Complete:

Once the SSP completes the above steps their publishers will be able to:

Curate contextual video private marketplace for advertisers
Enable advertisers to target open auction video inventory with contextual data