Setup the Adagio bidder adapter parameters (before Prebid 9)

📌 Update your wrapper configuration based on the modules you built previously.

A. About the Adagio parameters and configuration

Note

Our platform is tag-based so there is no need to create any tag ID, zone ID, format ID, placement ID or anything else but the line items.

Parameter	Requirements	Description	Example	Type
organizationId	required	Id of the Organization. Handed out by Adagio.	'1000'	string
site	required	Name of the site. Handed out by Adagio.- max length: 50	'mysite-com'	string
adUnitElementId	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'	string
placement	required	Describes the placement of an adunit in a page. Must not contain any information about the type of device.- max length: 50- max distinctives values: 10	'ban_atf'	string
pagetype	recommended	Describes what kind of content will be present in the page.- max length: 30- max distinctives values: 50	'article'	string
category	recommended	Category of the content displayed in the page.- max length: 30- max distinctives values: 50	'sport'	string

B. Add the necessary Adagio bidder parameters,

Adagio requires four parameters: organizationId, site, placement and adUnitElementId.

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

  // Dedicated Adagio bidder params
  bids: [{
    bidder: "adagio",
    params: {
      organizationId: "1000",                        // Required
      site: "my-site",                               // Required
      adUnitElementId: "div-gpt-ad-1460505748561-0", // Required
      placement: "my-adg-placement",                 // Required
      pagetype: "article",                           // Recommended
      category: "economy",                           // Optional
    },
  }],
});

C. Device Access and iframe sync

Enable device access and iframe sync. These options are mostly related to privacy (GDPR, CCPA, COPPA or other privacy scenarios).

pbjs.setConfig({
  deviceAccess: true,
  userSync: {
    filterSettings: {
      iframe: {
        bidders: ['adagio'], // Required
        filter: 'include'    // Required
      }
    }
  }
});

D. Add the local storage for Adagio

The Adagio bid adapter uses browser local storage. Since Prebid.js 7.x, the access to it must be explicitly set.

// https://docs.prebid.org/dev-docs/publisher-api-reference/bidderSettings.html
pbjs.bidderSettings = {
  adagio: {
    storageAllowed: true // Required
  }
}

E. Add the analytics for Adagio (recommended)

Analytics helps to compare bidders performance in our Prebid KPI dashboard, and allows us to insure we are properly performing against our other bidders. Moreover it helps us to understand the discrepancies.

The Adagio Analytics Adapter module is activated like any Prebid.js Analytics Module: Adagio Analytics Adapter:

• It must have access to the top window level
• It is available since Prebid 8.14.0 but add it anyway to be ready

pbjs.enableAnalytics([{
  provider: 'adagio'
}]);