Beachfront: Passing Contextual Data (Coming Soon)

DRAFT - This page details how to format the iris_context and iris_id KVPs in the Prebid, OpenRTB and Beachfront tag based integrations.

Prebid.org Integration

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

  • Contextual segment: pass in the bids.params.dctr field
  • iris_id: pass in the content.id field

See this example:

var adUnits = [

{

    code: 'test-div', 

    sizes: [

        [300, 250],

        [728, 90]

    ],  

    bids: [{

     bidder: 'beachfront',

      params: {

        publisherId: '123456',            

       adSlot: 'beachfront_test2',        

        dctr: 'iris_context=ic_4146983'

      }

    }]

}];




    pbjs.setConfig({

                    "content": {

                        "id": "iris_5e709178df9352dc",

                        "title": "[title]",

                        "series": "[series]",

                        "cat": "[category]",

                        "contentrating": "TV - PG",

                        "context": 1,

                        "producer": "[producer]",

                        "id": "[network]",

                        "name": "[network_name]"

                        "len": "[seconds]",

                        "genre": "Comedy"

                     },

                })

oRTB Integration

The OpenRTB integration leverages the custom KVP object to pass in the iris_context and iris_id KVPs.

  • Contextual segments: pass in the site object extension field, using attribute key_val.
  • iris_id: pass in the content object id attribute

Here is an example for how Beachfront requires publishers to format custom KVPs in OpenRTB:

   "site": {

        "ext": {

           "key_val": "iris_context=ic_4146983"

        }

    },

"content": {

    "id": "iris_5e709178df9352dc",

     },

 },

Tag Integration 

The tag integration leverages the custom key-value pair formatting to pass in the iris_context and iris_id KVP. 

  • contextual Segments: pass information as key values. Pass the values behind the "iris_context" key
    • key values to be passed as dctr parameter as follows:  dctr=ENCODED<key1=V1,V2,V3|key2=v1|key3=v3,v5>
  • iris_id: pass the ID using parameter cntid

See this example:

Forthcoming


Here is additional documentation from Beachfront on how to format custom KVPs in the ad tag: Forthcoming

 

Last updated: 7/1/2021 - DRAFT