Back to Bidders

Adagio

Features

Table of contents

• Table of contents
• Introduction
• Bid params
  • Setting params: AdUnit Level vs First Party Data
• Prebid Server
• Additional informations
  • User Sync
  • Recommended placement param values
  • Video outstream

Introduction

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

We strongly recommend using it alongside the Adagio RTD Provider, which leverages viewability and attention predictions to enhance inventory quality and maximize performance.

We also strongly suggest enabling the gptPreAuction module, which automatically populates the GPID (Global Placement ID) values. The GPID helps improve monetization by providing more accurate identification of each ad placement. For setup details, see the gptPreAuction module documentation.

Bid params

Setting params: AdUnit Level vs First Party Data

You can set pagetype and category parameters in two ways:

1. At the adUnit level (individual ad slots):

{
  code: 'div-gpt-ad-1234567890',
  mediaTypes: {
    banner: {
      sizes: [[300, 250]]
    }
  },
  bids: [{
    bidder: 'adagio',
    params: {
      organizationId: '1010',
      site: 'mysite-com',
      placement: 'banner_top',
      pagetype: 'article',
      category: 'sport'
    }
  }]
}

2. Globally via First Party Data (applies to all adUnits on the page):

pbjs.setConfig({
  ortb2: {
    site: {
      ext: {
        data: {
          pagetype: 'article',
          category: 'sport'
        }
      }
    }
  }
});

• First Party Data takes precedence over AdUnit-level parameters.
• If the FPD value is an array, the first value will be used.

Prebid Server

If you are hosting a Prebid Server, you must configure the Adagio Prebid Server adapter by changing the static/bidder-info/adagio.yaml file in order to:

1. enable the adapter by deleting the disabled: true entry (or set it to false)
2. replace the endpoints containing the REGION by one of the value below:
   • AMER:
     • Auction: https://mp-las.4dex.io/pbserver
     • Usersync: https://u-las.4dex.io/pbserver/usync.html
   • EMEA:
     • Auction: https://mp-ams.4dex.io/pbserver
     • Usersync: https://u-ams.4dex.io/pbserver/usync.html
   • APAC:
     • Auction: https://mp-tyo.4dex.io/pbserver
     • Usersync: https://u-tyo.4dex.io/pbserver/usync.html

Example for EMEA

endpoint: "https://mp-ams.4dex.io/pbserver"
userSync:
  iframe:
    url: "https://u-ams.4dex.io/pbserver/usync.html?gdpr={{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&gpp={{.GPP}}&&gpp_sid={{.GPPSID}}&r={{.RedirectURL}}"
    userMacro: "{UID}"
disabled: false
# …

Additional informations

User Sync

Enable user sync via iframe to improve DSP user match rates, leading to higher bid rates and bid prices. While this configuration is optional in Prebid, it is required by Adagio. Ensure that pbjs.setConfig() is called only once.

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

Recommended placement param values

Setting a meaningful value for the placement parameter is essential for our adapter to optimize ad delivery and performance, as it defines the specific location and context of your ad unit within the page. To streamline your implementation and ensure consistent naming conventions across your inventory, we provide these standardized values that eliminate guesswork and ensure your ad units are properly categorized for maximum yield.

Video outstream

The Adagio bidder adapter (Prebid.js only) 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

Back to Bidders