Xandr Monetize: Passing Contextual Data

This details how to format the iris_id KVP in the Xandr tag, Prebid, and OpenRTB integrations.

OpenRTB Integration

iris_id: pass in the content object id attribute

You must pass this data to Xandr using the same object (either app or site) you are already using for existing Xandr Monetize OpenRTB integrations. This is because the bid object must not include both a site object and an app object. Only one is allowed, not both.

content.id

Here is an example for how Xandr requires publishers to format OpenRTB requests made using the site object:

"content": { 

     "id": "iris_5acf886d06f05102", 

     }, 

 }

Prebid Server Integration

Passing the IRIS_ID to Xandr Monetize is not supported on client side prebid integrations. This is because the client side Xandr prebid integration does not support the content object, which is required to pass the IRIS_ID.

Prebid integration leverages the custom KVP object to pass in the iris_context and iris_id KVPs. Here's the documentation from Xandr on how to format custom KVPs in the Prebid: https://docs.prebid.org/dev-docs/bidders/appnexus.html

iris_id: pass in the content.id field

See this example:


var googletag = googletag || {};

    googletag.cmd = googletag.cmd || [];

    googletag.cmd.push(function() {

      googletag.pubads().disableInitialLoad();

    });


    var pbjs = pbjs || {};

    pbjs.que = pbjs.que || [];

    pbjs.que.push(function() {pbjs.setConfig({
 
        "content": { 

            "id": "iris_5acf886d06f05102", 

            "title": "[title]", 

            "series": "[series]", 

                "cat": "[category]", 

                "contentrating": "TV - PG", 

                "context": 1, 

                "producer": "[producer]", 

                "id": "[network]", 

                "name": "[network_name]" 

                "len": "[seconds]", 

                "genre": "Comedy" 

             }, 

        })

Tag-Based Integration

iris_id: Pass the ID using the IRIS_ID macro. For ad servers with native support for IRIS.TV Contextual, you can do this as outlined below:
- SpringServe Users: {{IRIS_ID}}
- Publica Users: [IRIS_ID]

See this example:

https://secure.adnxs.com/ptv?id=24008834&appid=&ifa=&ifa_type=idfa&vwidth=&vheight=&skippable=&vmaxduration=&content_id=iris_5acf886d06f05102

Xandr: Passing the iris_id

The below describes how Xandr passed the iris_id into the bidstream.

Xandr passes the iris_id to DSPs via the content.id field. See the following example for where to locate the iris_id on Xandr ad requests.

Example of the iris_id in the content.id field in the content object:

"site": { 

      "page": "https://irisXandr.com", 

      "ref": "", 

      "publisher": { 

        "id": "123456" 

      }, 

      "domain": "irisXandr.com", 

        "content": { 

        "title": "How to pass Content IDs", 

        "url": "https://irisXandr.com/video/upload/sp_hd/v123456/landscapead.m3u9", 

        "keywords": [], 

        "id": "iris_5acf886d06f05102", 

        "len": 40 

      } 

    },

Additional Xandr Resources

For additional details, please refer to these relevant resources from Xandr's Community Portal.