prebid.js 0.14.0

Prebid 0.14.0 Release

on Node.js NPM

New Features

• New adapter: HIRO Media (#660 - @ronenst)
• New adapter: Roxot (#633 - @kir-roxot)
• New adapter: AdButler (#707 - @dharton)
• New adapter: Komoona (#626 - @itayo155)
• New adapter: rubiconLite adapter (#740 - @snapwich)
• New feature: Custom cpm bucket sizing (#742 - @mkendall07)
• New feature: pbjs.setBidderSequence to shuffle order bidders are called in (#760 - @matthewlane)
• New feature: AMP Integration example (Alpha) (#756 - @protonate)
• New feature: pbjs.getHighestCpmBids for getting winning bids (#755 - @matthewlane)

Custom cpm bucket sizing

• This feature will allow finer control over the CPM bucket sizing, precision and caps.

Example:

const customConfigObject = {
  "buckets" : [{
      "precision" 2,  //default is 2 if omitted - means 2.1234 rounded to 2 decimal places = 2.12
      "min" : 0,
      "max" : 5,
      "increment" : 0.01,
    },
    {
      "precision" 2,
      "min" : 5,
      "max" : 8,
      "increment" : 0.05,
    },
    {
      "precision" 2,
      "min" : 8,
      "max" : 20,
      "increment" : 0.5
    }]
};
//set custom config object.
$$PREBID_GLOBAL$$.setPriceGranularity(customConfigObject);

API method pbjs.setBidderSequence to shuffle the order bidders are called

• Adds api method pbjs.setBidderSequence to set the order bidders are called in. The method takes an argument order that currently accepts the string 'random' to shuffle the sequence bidders are called in. If the sequence is not set with this method, the bidders are called in the order they are defined within the adUnit.bids array on page which is the current default.

Example use:

pbjs.setBidderSequence('random');

AMP Integration example (Alpha)

• An example of integrating Prebid.js into an AMP page to fill <amp-ad> components with Prebid demand.

See /integrationExamples/gpt/amp/ for example files and instructions.

API method pbjs.getHighestCpmBids for retrieving winning bids

• Adds pbjs.getHighestCpmBids to public api for retrieving winning bids.

pbjs.getHighestCpmBids() => array of winning bid objects for each ad unit on page
pbjs.getHighestCpmBids(adUnitCode) => array with the winning bid object for the given ad unit

New Adapters

HIRO Media

{
    bidder: 'hiromedia',
    params: {
      accountId: 'test'
    }
}

(by default only 300x250 will have bid requests sent)

Roxot

{
    bidder: 'roxot',
    params: {
      "publisherId": "bea17352-fb94-490d-b206-45096c96dbbc"
    }
}

AdButler

{
    bidder: 'adbutler',
    params: {
        accountID : '167283', //required
        zoneID : '210093', //required
        minCPM: '1.00', //optional
        maxCPM: '5.00', //optional
        keyword : 'green' //optional
      }
}

Komoona

{
    bidder: 'komoona',
    params: {
      hbid : '386c04fc5b36-468a-8bd8-7f622065a',
      placementId: '809af69d0e3cbacc4efe7077c19ba29d'
    }
}

RubiconLite

Optimized version of the RubiconProject adapter.

{
    bidder: 'rubiconLite',
    params: {
       //same as the existing rubicon adapter
      }
}

Maintenance

• Sonobi adapter refactored for params, config settings, video, floor, deals, and unit tests (#639 - @Studnicky)
• indexExchange adapter added new bid parameter size for differentiating size configurations (#654 - @indexexchange)
• indexExchange adapter added test mode support with pbjs_ix_debug=sandbox query string (#655 - @indexexchange)
• Address unit tests failures (#642) by stubbing, rather than spying on, adLoader in tests. This prevents requesting resources that are not always script responses and should resolve observed script errors. (#678 - @mkendall07)
• appnexusAst adapter updated to find the ad with an rtb property with new getRtbBid function (#679 - @protonate)
• Rubicon adapter updated to register individual responses as they come in individually using a new Fastlane event (#676 - @snapwich)
• README updated to explain where to run the npm install (#682 - @dugwood)
• Optimize AOL adapter and heavily reduce the size (#653 - @marian-r)
• Adapter loader refactor for unit testing (#698 - @mhipszki )
• Add GitHub issue template (#714 - @matthewlane )
• Add config for testing iOS on Browserstack (#726 - @matthewlane)
• Deal handling added in Adform adapter (#723 - @braizhas)
• UnderdogMedia refactored the code and added optional divId param (#720 - @ojotoxy)
• Sonobi Adapter: Add explicit referrer for embedded iFrame auctions (#677 - @Studnicky)
• Adform adapter refactoring (#677 - @braizhas)
• Add contribution guidelines (#761 - @matthewlane)
• Suppress bid requests when bidder has no defined size (#758 @mkendall07)

Bug Fixes

• Allow bid to be zero for the floor price to work (#685 - @dugwood)
• Fix processCallbacks to accept an optional list of arguments (#717 - @csirmaz)
• Set ref param correctly in Sonobi adapter (#712 - @edahood-sonobi)
• Fix bug in sendStandardTargeting filter function (#719 - @snapwich)
• Fix retrieving 3rd party pixels from bid response in AOL adapter (#732 - @marian-r)
• Memeglobal adapter bug fix - added host in url (#737 - @AlexStanovsky)
• Add workaround to prevent IX adapter from ending auction early (#763 - @protonate)

Commit Log