OpenRTB for Apps

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. Your Server sends a BidRequest (JSON, gzip-compressed) to Adagio’s regional endpoint.

2. Adagio runs a real-time auction across multiple DSP partners.

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

4. You render the winning creative in your app.

Integration step

1

Declare your inventory

Refer to Declare your websites/apps

2

Update app-ads.txt lines

Refer to Update your (app-)ads.txt file

3

Use OpenRTB Version 2.5 and 2.6

Refer to OpenRTB Version

4

Setup your endpoints

Refer to Endpoints integration

5

Ensure Supported Formats

Here is the list of the different formats that Adagio supports on it's OpenRTB integration.

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

6

Ensure Supported Currencies

Adagio uses exchange rates from the European Central Bank to perform currency conversions. Refer to the list of supported currency symbols.

7

Ensure Data compression (gzip)

Refer to Data compression (Gzip)

8

Ensure GDPR/CCPA/TCF compliance

For European and UK traffic, GDPR compliance is mandatory. Refer to our list of vendor IDs, hereunder, to be added in your CMP in order to properly monetize.

Our list of vendor IDs

Refer to IAB's website to get the full TCF vendor list.

ID	Company Name	Policy Link
13	Sovrn	https://www.sovrn.com/privacy-policy/
16	RTB House	https://rtbhouse.com/privacy-center
28	TripleLift	https://triplelift.com/privacy/
36	Nexxen (Unruly)	https://unruly.co/legal/privacy/
45	Smart Adserver (Equativ)	https://smartadserver.com/end-user-privacy-policy/
52	Rubicon	https://www.magnite.com/legal/advertising-technology-privacy-policy/
58	33Across	https://www.33across.com/privacy-policy
69	OpenX	https://www.openx.com/legal/privacy-policy/
76	Pubmatic	https://pubmatic.com/legal/privacy/
90	E-Planning (Teroa)	https://www.e-planning.net/privacy-policy.html
138	ConnectAd Demand GmbH	https://www.connectadrealtime.com/privacy
149	Illumin / ADman Interactive SLU	https://admanmedia.com/politica.html
241	OneTag	https://www.onetag.com/privacy/
253	Improve Digital	https://www.improvedigital.com/platform-privacy-policy
285	Freewheel (Comcast)	https://www.freewheel.com/privacy-policy
617	Onfocus (Adagio)	https://adagio.io/privacy
779	Adtarget Teknoloji A.S.	https://adtarget.com.tr/adtarget-privacy-policy-2020.pdf

9

Limit number of tagid per app

• Each app can declare a maximum of 100 tagid in total (across all requests) of 150 characters at most.

• If more than 100 tagid are configured for the same app, the extra tagid will be ignored and not monetized.

• Too many tagid per app prevents our algorithms from learning efficiently.

A tagid with very low traffic (<150 ad calls/day) brings no value and reduces overall performance.

Placements Naming Suggestions / Examples

• Banner

  • banner_top

  • banner_middle

  • banner_bottom

  • banner_left

  • banner_right

  • banner_sticky_top

  • banner_sticky_bottom

• Interstitial

  • interstitial_page_load

  • interstitial_exit

  • interstitial_pause

• Video

  • video_instream

  • video_outstream

  • video_rewarded

  • video_midroll

• Native

  • native_feed

  • native_article

  • native_recommendation

• Special Formats

  • sticky_footer

  • sticky_header

  • companion_banner

10

Timeout requirement (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 to maximise monetization performance (maximises fill rate and CPM) while maintaining an acceptable user experience.