Prebid docs - browse
Prebid/Concepts/What is Prebid.js?
CONCEPT

What is Prebid.js?

Prebid.js is the open-source JavaScript library publishers use to run header bidding in the page. Prebid.org maintains the API. bidtune does not publish a fork of it.

Plain English

An ad unit in Prebid is the slot you want to fill: a code, the media type and sizes, and the bidders invited to that slot. Each bidder entry names an adapter that was compiled into your build, plus the parameters that adapter expects. Those parameters are the bidder's, not Prebid's, and not bidtune's.

The library's other half is configuration: auction timeout, price floors, bid caching, user sync, and what gets sent to the ad server. Those are the decision docs in this section. The vocabulary around the auction - SSP, DSP, OpenRTB - lives in the glossary.

Prebid's own description of the library is on What is Prebid.js?. Prebid Server is different software. It runs auctions off the page. This page is the browser library only.

How it shows up in pbjs

Ad units are registered, then requestBids runs the auction. The bids array is where each adapter's parameters go. Copy them from that bidder's Prebid doc. A placeholder here would be a fake placement.

Prebid.js basic examplefrom prebid.org
var adUnits = [{
  code: "div-1",
  mediaTypes: {
    banner: { sizes: [[300, 250]] }
  },
  bids: [{
    bidder: "bidderCode",
    params: {}
  }]
}];

pbjs.que.push(function () {
  pbjs.addAdUnits(adUnits);
  pbjs.requestBids({ bidsBackHandler: sendAdServerRequest });
});

When it helps, when it hurts

Helps

One library, one auction, and a public API. Adapters are open, so a publisher can see which bidders were actually compiled into the build they ship.

Hurts

A build that includes every adapter is a large script. A build that omits the Price Floors module will ignore a floors config. Version upgrades move defaults - bid caching, for example, changed default in Prebid.js 2.0. Pin the version you mean to run.

What bidtune tests here

bidtune is installed as a script URL in front of the Prebid you already load. Autopilot then tests settings that library already understands. It does not swap in a private build of Prebid.js, and it does not add bidders.
When a page below says a module has to be in the build, that requirement is Prebid's. Autopilot cannot turn on a module your build left out.
The 10% holdback keeps your current configuration. A test runs on 30% of optimized traffic, for at least 72 hours and 2,000 sessions in each arm, and no longer than 14 days. bidtune keeps the change only after the capped session read is better at two daily checks.
How bidtune tests itTHE RULES
A test takes 30% of optimized traffic
Judged against its own control. The 10% holdback never changes.
10% holdback60% control30% test
sessions per arm2,000minimum runtime72hdecides onrev / session