Integration – Mobile Web – Header Bidding

Setting up Prebid.Js

Widespace header bidding solution is today designed after the open source library “prebid.js”. If you are not yet familiar with the Prebid.js documentation we recommend that you have a closer look at their ‘getting started guide’ before continuing. The guideline can be found here.

Widespace Bid Object

To add Widespace as a bidder you need to add the following object to adUnits.bids:

Parameter	Value	Type	Optional/Required	Comment
`bidder`	widespace	string	Required	Name of the widespace bidder implementation.
`params.sid`		string	Required	Provisioned and provided by Widespace.
`params.currency`		ISO 4217 string	Optional	Explicitly specify the currency for the returned bid. If left out, the default currency of your account in Widespace will be used.

Ad Unit sizes

In order for your ad unit sizes to work you need to make sure that it’s supporting the same ad format sizes that Widespace Adspace supports. The various format sizes that you can use today is as follows:

Format	Size
Panorama	[320, 53]
Panorama XL	[320, 160]
Takeover	[320, 320]
Vertical	[320, 480]
Interstitial	[320, 480]
Medium Rectangle	[300, 250]

Code Example

Widespace are supporting and recommending to support several formats/sizes in one Adspace in order to optimise your supply after the existing demand. In the below code example we’re adding Widespace as a bidder for two different div id’s ‘div-gpt-ad-1460505748561-0‘ and ‘div-gpt-ad-1460505661639-0‘ where one is only supporting a specific format/size and the other one is supporting several formats/sizes:

## Note that the SID needs to be replaced with your own ##
 
var adUnits = [{
      code: 'div-gpt-ad-1460505748561-0',
      sizes: [[320, 320]]
      bids: [{
          bidder: 'widespace',
          params: {
             sid: '7b6589bf-95c8-4656-90b9-af9737bb9ad3'
             currency: 'EUR'
          }
      }]
  },{
      code: 'div-gpt-ad-1460505661639-0',
      sizes: [[320, 53], [320, 160], [320, 320]],
      bids: [{
          bidder: 'widespace',
          params: {
            sid: '7b6589bf-95c8-4656-90b9-af9737bb9ad3',
            currency: 'EUR'
          }
      }]
  }];

Do you have any questions or need further guidance?

Feel free to contact integrations@widespace.com and we’ll do our very best to help you out!