Prebid.js

Setup and manage header bidding advertising partners without writing code or confusing line items. Prebid.js is open source and free.

Many SSPs, bidders, and publishers have all contributed to this project. 20+ Bidders are supported by Prebid.js now.

Check out the overview and documentation at http://prebid.org.

No more week-long development. Header bidding is made easy by prebid.js :)

Table of Contents

• Prebid.js
  • Usage
    • Download the latest released code
    • Example code
  • API
  • Contribute
    • Add a Bidder Adapter
    • install
    • Build
    • Configure
    • Run
    • Unit Test In the Browser
    • Supported Browsers

Usage

Download the integration example here.

Download the latest released code

See the releases page here and download a copy.

Example code

Include the prebid.js library Note that you need to host prebid.js locally or on a CDN and update the reference in the code snippet below for cdn.host.com/prebid.min.js

(function () {
    var d = document;
    var pbs = d.createElement('script');
    pbs.type = 'text/javascript';
    //replace with your CDN hosted version. HTTPS is strongly recommended.
    pbs.src = '//cdn.host.com/prebid.min.js';
    var target = d.getElementsByTagName('script')[0];
    target.parentNode.insertBefore(pbs, target);
})();

Setup ad units

pbjs.que.push(function(){
    var adUnits = [{
        code: '{id}',
        sizes: [[300, 250], [300, 600]],
        bids: [
            {
                bidder: 'appnexus',
                params: {
                    placementId: '{id}'
                }
            }
        ]
    }];
    //add the adUnits
    pbjs.addAdUnits(adUnits);
});

Request Bids

pbjs.que.push(function(){
    pbjs.requestBids({
        bidsBackHandler: function(bidResponses) {
            //do stuff when the bids are back
        }
    })
});

See Console Debug Errors during testing By default console errors are suppressed. To enabled add ?pbjs_debug=true to the end of the URL for testing.

API

Full Developer API reference:

Click here to access the API

Contribute

Note: You need to have at least node.js 4.x or greater installed to be able to run the gulp build commands.

Add a Bidder Adapter

Follow the guide outlined here to add an adapter.

Install

$ npm install

If you experience errors, after a version update, try a fresh install:

$ rm -rf ./node_modules && npm cache clean && npm install

Build

$ gulp build

Runs code quality checks, generates prebid.js files and creates zip archive distributable:

• ./build/dev/prebid.js Full source code for dev and debug
• ./build/dev/prebid.js.map Source map for dev and debug
• ./build/dist/prebid.js Minified production code
• ./prebid.js_<version>.zip Distributable

Code quality is defined by ./.jscs and ./.jshint files and errors are reported in the terminal. The build will continue with quality errors, however. If you are contributing code you can configure your editor with the provided .jscs and .jshint settings.

Optimisation

The standard build output contains all the available adapters which are listed in adapters.json.

You might want to exclude some/most of them from the final bundle and specifically define the ones you're interested in.

// Example: path/to/your/list-of-adapters.json
[
    "openx",
    "rubicon",
    "sovrn"
]

This will result in a smaller, optimised bundle which might allow your pages to load faster.

Build standalone prebid.js

• clone repo, run npm install

• duplicate adapters.json to e.g. list-of-adapters.json

• remove the unnecessary adapters from list-of-adapters.json

• then run build

  $ gulp build --adapters path/to/your/list-of-adapters.json

Build prebid.js using NPM for bundling

In case you'd like to explicitly show that your project uses prebid.js and want a reproducible build, consider adding it as an npm dependency.

• install prebid.js as an npm dependency of your project

• duplicate node_modules/prebid.js/adapters.json to under your project path e.g. path/to/your/list-of-adapters.json

• remove the unnecessary adapters

• run the prebid.js build under node_modules/prebid.js/ folder

  $ gulp build --adapters path/to/your/list-of-adapters.json

Most likely your custom prebid.js will only change when there's

• a change in your list of adapters
• a new release of prebid.js

having said that, you are probably safe to check in your custom bundle into your project, or you can generate it in your build process.

Configure

Edit example file ./integrationExamples/gpt/pbjs_example_gpt.html:

1. Change {id} values appropriately to set up ad units and bidders.

2. Set path for prebid.js in your example file: #####Development pbs.src = './build/dev/prebid.js'; #####

   (function() {
           var d = document, pbs = d.createElement('script'), pro = d.location.protocol;
           pbs.type = 'text/javascript';
           pbs.src = ((pro === 'https:') ? 'https' : 'http') + ':./build/dev/prebid.js';
           var target = document.getElementsByTagName('head')[0];
           target.insertBefore(pbs, target.firstChild);
   })();

   #####Test/Deploy (default) pbs.src = './build/dist/prebid.js';#####

   (function() {
           var d = document, pbs = d.createElement('script'), pro = d.location.protocol;
           pbs.type = 'text/javascript';
           pbs.src = ((pro === 'https:') ? 'https' : 'http') + './build/dist/prebid.js';
           var target = document.getElementsByTagName('head')[0];
           target.insertBefore(pbs, target.firstChild);
   })();

Run

$ gulp serve

This runs code quality checks, generates prebid files and starts a webserver at http://localhost:9999 serving from project root. Navigate to your example implementation to test, and if your prebid.js file is sourced from the ./build/dev directory you will have sourcemaps available in browser developer tools.

Navigate to http://localhost:9999/integrationExamples/gpt/pbjs_example_gpt.html to run the example file.

Navigate to http://localhost:9999/build/coverage/karma_html/report to view a test coverage report.

A watch is also in place that will run continuous tests in the terminal as you edit code and tests.

Unit Test In the Browser

$ gulp test --watch

This will run tests and keep the Karma test browser open. If your prebid.js file is sourced from the build/dev directory you will also have sourcemaps available when viewing browser developer tools. Access the Karma debug page at: http://localhost:9876/debug.html View console for test results and developer tools to set breakpoints in source code.

Detailed code coverage reporting can be generated explicitly with $ gulp test --coverage and results found in ./build/coverage.

Supported Browsers

Prebid.js is supported on IE9+ and modern browsers.