OpenRTB: Getting Started for Web

Contact us at [e-mail] beforehand for this type of integration.

Adagio offers real-time access to demand on various mediatypes (banner, video & native). Integrating Adagio to your demand partners helps you enrich your demand sources, expand globally and monetise different mediatypes through a single unified system.

Check our Bid Request and Bid Response examples specific to each mediatype.

How It Works

The monetization flow through Adagio’s OpenRTB endpoint:

1. Complete user synchronization successfully.

2. Your Server sends a BidRequest (JSON, gzip-compressed) to Adagio’s regional endpoint.

3. Adagio runs a real-time auction across multiple demand partners.

4. Winning Bid is returned as a BidResponse (JSON, gzip-compressed).

5. You render the winning creative in your web.

Integration Steps

1

Declare your inventory

Refer to Declare Your Websites/Apps

2

Ensure your Supply Chain Files are up to date

Refer to Update Your (app-)ads.txt File

3

Use OpenRTB Version 2.5 and/or 2.6

Refer to Supported OpenRTB Versions

4

Setup your User Synchronization

Refer to User Synchronization

5

Setup your Endpoints

Refer to Endpoints Integrations

6

Ensure Supported Formats

Formats supported by Adagio on its OpenRTB integration.

We support multi imps and multi formats.

Platform	Format	Supported
Web	Banner	✅
Web	Native	✅
Web	Video (Instream & Outstream)	✅

7

Ensure Supported Sizes

Refer to Monetizable Ad Sizes

8

Ensure Supported Currencies

Adagio uses exchange rates from the European Central Bank to perform currency conversions. Refer to Supported Currencies

9

Guarantee Data compression (gzip)

Refer to Data Compression (gzip)

10

Confirm GDPR/CCPA/TCF compliance

For European and UK traffic, GDPR compliance is mandatory.

Refer to GDPR/CCPA/TCF Compliance

11

Ensure your requests are properly configured

Refer to Bid Request Fields for Web Inventory

12

Restrict the Number of TagIDs per website

Don't exceed 100 TagIDs in total (across all requests from each website) and keep each TagID under 150 characters to ensure optimal performance and monetization

Review TagID Limits and Guidelines to understand these limits and best practices.

13

Ensure you respect the minimum timeout (tmax)

Any tmax < 470ms has very little chance to monetize properly (due to competition reduction, given bidders specific Time to Respond), please make sure to not send traffic with values lower than this limit.

We recommend the highest tmax you can set (usually ~1000ms) to maximise monetization performance (maximises fill rate and CPM) while maintaining an acceptable user experience.

14

Review our BidResponses formats and content

Refer to Bid Response Fields for Web Inventory

15

Improve your monetization performance

To maximize revenue and ensure optimal ad delivery, we recommend:

1. Regularly review the supply chain validation status of your inventory to identify and fix any issues. See Review Inventory Supply Chain Status

2. Enhance your ad requests by adding parameters through extensions. Explore Supported Extensions on Web, including EIDs and OMID.