Back to Bidders

Adagio

Features

Bidder Code adagio Prebid.org Member yes
Prebid.js Adapter yes Prebid Server Adapter no
Media Types display, video, native Multi Format Support check with bidder
TCF-EU Support yes IAB GVL ID 617
GPP Support some (check with bidder) DSA Support yes
USP/CCPA Support yes COPPA Support yes
Supply Chain Support yes Demand Chain Support check with bidder
Safeframes OK check with bidder Supports Deals check with bidder
Floors Module Support yes First Party Data Support no
User IDs all ORTB Blocking Support check with bidder
Privacy Sandbox check with bidder

Note

The Adagio bidder adapter requires setup and approval from the Adagio team. Please reach out to contact@adagio.io for more information.

Configuration

User Sync

Adagio strongly recommends enabling user syncing through iFrames. This functionality improves DSP user match rates and increases the bid rate and bid price. Make sure to call pbjs.setConfig() only once. This configuration is optional in Prebid, but required by Adagio.

// https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-Configure-User-Syncing
pbjs.setConfig({
  userSync: {
    filterSettings: {
      iframe: {
        bidders: ['adagio'],
        filter: 'include'
      }
    }
  }
});

Bidder Settings

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
  }
}

Bid Params

Important: Adagio needs to collect attention data about the ads displayed on a page and must listen to some specifics ad-server events. Please refer to the Adagio user guide for details.

Name Scope Description Example Type
organizationId required Id of the Organization. Handed out by Adagio. '1010' string
site required Name of the site. Handed out by Adagio.
- max length: 50		 'mysite-com' string
placement* required Refers to the placement of an adunit in a page.
Must not contain any information about the type of device.
- max length: 30
- max distinctives values: 10		 'ban_atf' string
adUnitElementId required Refers to the adunit html attribute id in a page. 'gpt-ban-atf' string
pagetype* highly 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
video optional OpenRTB 2.5 video options object. All options will override ones defined in mediaTypes video.
Mandatory:
- api (your video player must at least support the value 2)
Highly recommended:
- playbackmethod
Not supported:
protocol, companionad, companiontype, ext options		 {api: [2], playbackmethod: [6], skip: 1, startdelay: 0} object
native optional Partial OpenRTB Native 1.2 request object. Supported fields are:
- context
- plcmttype		 {context: 1, plcmttype: 2} object
splitKeyword optional Keyword that can later be used in a split rule targeting to trigger the rule (especially for Direct Seats AB testing) 'splitrule-one' string
dataLayer optional A set of arbitrary key-value pairs. This can be used to configure mappings. The keys and values must be strings. {placement: 'my-placement', siteid: 'my-siteid'} object

*These parameters will have its accentuated characters converted to their non-accentuated version: é => e

Native Custom assets

Name description
adagio_bvw Url to handle Measure beacon

First Party Data

Adagio will use FPD data as fallback for the params below:

  • pagetype
  • category

If the FPD value is an array, the 1st value of this array will be used.

Video outstream

The AdagioBidAdapter includes a default video player powered by Blue Billywig. This default player is used when no renderer is configured for the adUnit.

"Send All Bids" Ad Server Keys

These are the bidder-specific keys that would be targeted within GAM in a Send-All-Bids scenario. GAM truncates keys to 20 characters.
hb_pb_adagio hb_bidder_adagio hb_adid_adagio
hb_size_adagio hb_source_adagio hb_format_adagio
hb_cache_host_adagio hb_cache_id_adagio hb_uuid_adagio
hb_cache_path_adagio hb_deal_adagio

Back to Bidders