Prebid Adagio adapter

Note

Adagio’s Prebid Client Adapter allow to monetise web inventory through Prebid.js

It supports display, native and outstream formats.

Install Adagio Prebid Client Adapter

1. If not yet installed, download Prebid
2. Read our official Adapter’s Prebid documentation
3. (Advanced) You can also directly acces it’s code on Github
   1. https://github.com/prebid/Prebid.js/blob/master/modules/adagioBidAdapter.js
   2. https://github.com/prebid/Prebid.js/blob/master/modules/adagioBidAdapter.md

Set our Adapter required parameters

Danger

Required: As opposed to other Supply Side Parters (SSPs), Adagio doesn’t require the creation of any tag ID, zone ID, format ID, placement ID or anything else but the line items. Instead it relies on the following required parameters to group AdUnits.

Parameter	Type	Required	Description	Example
organizationId	string	Required	Identifier of the Organization. Handed out by Adagio.	‘1000’
site	string	Required	Name of the site. Found on our Webapp (picked at inventory creation time). - max length: 50	‘mysite-com’
placement	string	Required	Describes the placement of an adunit in a page. Must not contain any information about the type of device. placement-limits-and-guidelines.md - max length: 50 - max distinctives values: 10	‘ban_atf’

Here is an example of the adUnit's configuration

var adUnits = [{
  // ...code: 'ban-atf',
  // ...mediaTypes: {...},
  // ...sizes: {...},

  // Dedicated Adagio bidder params
  bids: [{
    bidder: "adagio",
    params: {
      organizationId: "1000",                // Required
      site: "my-site",                       // Required
      placement: "my-adg-placement",       // Required
    },
  }],

Add ortb2Imp and ortb2 params

Danger

Required

Parameter	Type	Requirements	Description	Example
divId	string	Required	Refers to the adunit html attribute id in a page. Must exists in the html code of the website.	‘div-gpt-ad-1542984663788-0’
pagetype	string	Recommended	Describes what kind of content will be present in the page. - max length: 30 - max distinctives values: 50	‘article’
category	string	Recommended	Category of the content displayed in the page. - max length: 30 - max distinctives values: 50	‘sport’

Example of configuration

var adUnits = [{
  // ...code: 'ban-atf',
  // ...mediaTypes: {...},
  // ...sizes: {...},

  // Params shared between all bidders
  ortb2Imp: {
    ext: {
      data: {
        divId: "div-gpt-ad-1460505748561-0", // Required
      }
    }
  },
}];

pbjs.setConfig({
  // Params shared for the current page
  ortb2: {
    site: {
      ext: {
        data: {
          pagetype: "article",                // Recommended
          category: "economy",                // Optional
        }
      }
    }
  },
});

Review your technical integration

review-your-technical-integration.md