OpenX for Header Bidding

OpenX

Features

Bidder Code	openx	Prebid.org Member	yes
Media Types	display, video	GDPR TCF Support	yes
User IDs	admixerId, adtelligentId, amxId, britepoolId, criteo, dapId, deepintentId, dmdId, fabrickId, flocId, hadronId, id5Id, identityLink, idxId, imuId, intentIqId, kinessoId, liveIntentId, lotamePanoramaId, merkleId, mwOpenLinkId, naveggId, netId, nextrollId, novatiq, parrableId, pubCommonId, publinkId, quantcastId, sharedId, tapadId, uid2, unifiedId, verizonMediaId, zeotapIdPlus	USP/CCPA Support	yes
Supply Chain Support	yes	COPPA Support	yes
Demand Chain Support	no	Safeframes OK	check with bidder
Supports Deals	check with bidder	Prebid.js Adapter	yes
IAB GVL ID	69	Prebid Server Adapter	yes
Floors Module Support	yes	First Party Data Support	yes

"Send All Bids" Ad Server Keys

These are the bidder-specific keys that would be targeted within GAM in a Send-All-Bids scenario. GAM truncates keys to 20 characters.

`hb_pb_openx`	`hb_bidder_openx`	`hb_adid_openx`
`hb_size_openx`	`hb_source_openx`	`hb_format_openx`
`hb_cache_host_openx`	`hb_cache_id_openx`	`hb_uuid_openx`
`hb_cache_path_openx`	`hb_deal_openx`

Registration

If you have any questions regarding set up, please reach out to your account manager or support@openx.com.

Bid Parameters

Name	Scope	Description	Example	Type
`delDomain` or `platform`	required	OpenX delivery domain or platform id provided by your OpenX representative. Both may be present. `platform` is preferred	“PUBLISHER-d.openx.net” or “555not5a-real-plat-form-id0123456789”	String
`unit`	required	OpenX ad unit ID provided by your OpenX representative.	“1611023122”	String
`customParams`	optional	User-defined targeting key-value pairs. customParams applies to a specific unit.	`{key1: "v1", key2: ["v2","v3"]}`	Object
`customFloor`	optional	Minimum price in USD. customFloor applies to a specific unit. For example, use the following value to set a $1.50 floor: 1.50 WARNING: Misuse of this parameter can impact revenue	1.50	Number
`doNotTrack`	optional	Prevents advertiser from using data for this user. WARNING: Impacts all bids in the request. May impact revenue.	true	Boolean
`coppa`	optional	Enables Child’s Online Privacy Protection Act (COPPA) regulations. WARNING: Impacts all bids in the request. May impact revenue.	true	Boolean

Video

Name	Scope	Description	Example	Type
`unit`	required	OpenX ad unit ID provided by your OpenX representative.	“1611023122”	String
`delDomain` or `platform`	required	OpenX delivery domain or platform id provided by your OpenX representative. Both may be present. `platform` is preferred	“PUBLISHER-d.openx.net” or “555not5a-real-plat-form-id0123456789”	String
`openrtb`	optional	An OpenRtb Impression with Video subtype properties	`{ imp: [{ video: {mimes: ['video/x-ms-wmv, video/mp4']} }] }`	Object

Example

var adUnits = [
  {
    code: 'test-div',
    sizes: [[728, 90]],  // a display size
    mediaTypes: {'banner': {}},
    bids: [
      {
        bidder: 'openx',
        params: {
          unit: '539439964',
          delDomain: 'se-demo-d.openx.net',
          customParams: {
            key1: 'v1',
            key2: ['v2', 'v3']
          },
        }
      }, {
        bidder: 'openx',
        params: {
          unit: '539439964',
          platform: 'a3aece0c-9e80-4316-8deb-faf804779bd1',
          customParams: {
            key1: 'v1',
            key2: ['v2', 'v3']
          },
        }
      }
    ]
  },
  {
    code: 'video1',
    mediaTypes: {
      video: {
        playerSize: [640, 480],
        context: 'instream',
        mimes: ['video/x-ms-wmv, video/mp4']
      }
    },
    bids: [{
      bidder: 'openx',
      params: {
        unit: '1611023124',
        delDomain: 'PUBLISHER-d.openx.net'
      }
    }]
  }
];

First Party Data

OpenX supports FPD configured under ortb2.userand ortb2.site.content as described here. Ad unit specific FPD is not supported, and segment taxonomies (segtax) are simply passed through. If you have any questions, please reach out to us at prebid@openx.com

Example:

pbjs.setConfig({
   ...
   ortb2: {
       site: {
            content: {
                data: [{
                    name: "www.dataprovider1.com",
                    ext: { segtax: 4 },
                    segment: [
                        { id: "687" },
                        { id: "123" }
                    ]
                }]
            },
       },
       user: {
           data: [{
               name: "dataprovider.com",
               ext: { segtax: 4 },
               segment: [
                    { id: "1" }
               ]
           }],
       }
   }
   ...
});

Configuration

Add the following code to enable user syncing. By default, Prebid.js version 0.34.0+ turns off user syncing through iframes. OpenX strongly recommends enabling user syncing through iframes. This functionality improves DSP user match rates and increases the OpenX bid rate and bid price. Be sure to call pbjs.setConfig() only once.

pbjs.setConfig({
   userSync: {
      iframeEnabled: true
   }
});

Additional Details

Banner Ads

Video Ads

Back to Bidders