Server-to-Server (S2S) Calls

Auction Endpoints

Region	URL	Method	City	Data Center
AMER	https://mp-las.4dex.io/ortb/{PUBLISHER_ID}	POST	Las Vegas	GCP us-west4
EMEA	https://mp-ams.4dex.io/ortb/{PUBLISHER_ID}	POST	Amsterdam	GCP europe-west4
APAC	https://mp-tyo.4dex.io/ortb/{PUBLISHER_ID}	POST	Tokyo	GCP asia-northeast1

Your PUBLISHER_ID can be found under Settings > General in the Adagio Manager.

S2S Headers

The OpenRTB Version should be passed in the header of a bid request with a custom HTTP header.

• x-openrtb-version: 2.5

• x-openrtb-version: 2.6

OpenRTB field requirements

Path	Mandatory	Type	Description
site.publisher.id	Yes	string	Your ID, provided by Adagio, found under Settings > General in the Adagio Manager.
site.domain	Yes	string	Domain of the site. e.g. “mysite.foo.com”.
imp[].tagid	Yes	string	Custom value you define to identify an ad unit placement. Use consistent values, avoiding auto-incremented or random values. e.g."identifier12345". - max length: 150 - max distinctive values: 100
user.buyeruid	Highly Recommended	string	Adagio User ID, as described here.
user.ext.eids or user.eids	Highly Recommended	object	User IDs. If you already have the User ID of bidders monetizing through the Adagio Demand Library, then it is recommended adding them to your Bid Request, as described here.
tmax	Highly Recommended	int	Maximum time in milliseconds the exchange allows for bids to be received including Internet latency to avoid timeout. Minimum value: 470.
imp[].ext.gpid	Recommended	string	Global Placement ID. Official documentation.
site.ext.pagetype	Recommended	string	Describes what kind of content will be present in the page. - max length: 30 - max distinctive values: 50
site.ext.category	Recommended	string	Category of the content displayed in the page. - max length: 30 - max distinctive values: 50

Data Compression (gzip)

Adagio ONLY supports Compressed JSON (gzip) for bid requests and bid responses.

It is mandatory to use Compressed JSON to reduce the amount of data exchanged between you and Adagio, as this decreases server communication latencies, and traffic listening costs for all parties involved.

Configure compressed JSON bid requests and enable compressed responses:

1

Compress your HTTP request body with gzip

2

Add a Content-Encoding: gzip HTTP header to indicate that the request is compressed

3

Add an Accept-Encoding: gzip header to indicate that you can accept a compressed response

Bid responses include a Content-Encoding: gzip HTTP header to indicate compression. To distinguish between JSON and Compressed JSON formats, check for this header. If present, decompress the HTTP body before processing.

Supported Currencies

Adagio uses exchange rates from the European Central Bank to perform currency conversions. Below the list of currencies supported in Bid Requests and Bid Responses:

List of currencies supported in Bid Requests and Bid Responses

AUD BGN BRL CAD CHF CNY CZK DKK GBP HKD HUF IDR ILS INR ISK JPY KRW MXN MYR NOK NZD PHP PLN RON SEK SGD USD THB TRY ZAR