> For the complete documentation index, see [llms.txt](https://adagio-io.gitbook.io/adagio-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adagio-io.gitbook.io/adagio-documentation/openrtb-s2s-endpoint/editor.md).

# OpenRTB: Getting Started for Web

{% hint style="info" %}
Contact us at <contact@adagio.io> beforehand for this type of integration.
{% endhint %}

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.&#x20;

{% hint style="info" %}
Check our [Bid Request](/adagio-documentation/openrtb-s2s-endpoint/editor/bid-request-fields-for-web-inventory.md#bid-request-for-web-display-inventory-sample) and [Bid Response ](/adagio-documentation/openrtb-s2s-endpoint/editor/bid-response-fields-for-web-inventory.md#bid-request-for-web-display-inventory-sample)examples specific to each mediatype.
{% endhint %}

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

{% stepper %}
{% step %}

### Declare your inventory

Refer to [Declare Your Websites/Apps](/adagio-documentation/account-configuration/declare-your-websites-apps.md)
{% endstep %}

{% step %}

### Ensure your Supply Chain Files are up to date

Refer to [Update Your (app-)ads.txt File](/adagio-documentation/account-configuration/manage-supply-chain-related-files/update-your-app-ads.txt-file.md)
{% endstep %}

{% step %}

### Use OpenRTB Version 2.5 and/or 2.6

Refer to [Supported OpenRTB Versions](/adagio-documentation/openrtb-s2s-endpoint/supported-openrtb-versions.md)
{% endstep %}

{% step %}

### Setup your User Synchronization

Refer to [User Synchronization](/adagio-documentation/openrtb-s2s-endpoint/user-synchronization.md)
{% endstep %}

{% step %}

### Setup your Endpoints

Refer to [Endpoints Integrations](/adagio-documentation/openrtb-s2s-endpoint/endpoints-integrations.md)
{% endstep %}

{% step %}

### Ensure Supported Formats

Formats supported by Adagio on its OpenRTB integration.

{% hint style="info" %} <mark style="color:blue;">**We support multi imps and multi formats.**</mark>
{% endhint %}

<table><thead><tr><th width="110.1796875">Platform</th><th>Format</th><th>Supported</th></tr></thead><tbody><tr><td>Web</td><td>Banner</td><td>✅</td></tr><tr><td>Web</td><td>Native</td><td>✅</td></tr><tr><td>Web</td><td>Video (Instream &#x26; Outstream)</td><td>✅</td></tr></tbody></table>
{% endstep %}

{% step %}

### Ensure Supported Sizes

Refer to [Monetizable Ad Sizes](/adagio-documentation/operations-and-support/monetizable-ad-sizes.md)
{% endstep %}

{% step %}

### Ensure Supported Currencies

Adagio uses exchange rates from the European Central Bank to perform currency conversions. Refer to [Supported Currencies](/adagio-documentation/operations-and-support/standards-and-compliance/supported-currencies.md)
{% endstep %}

{% step %}

### Guarantee Data compression (gzip)

Refer to [Data Compression (gzip)](/adagio-documentation/openrtb-s2s-endpoint/data-compression-gzip.md)
{% endstep %}

{% step %}

### Confirm GDPR/CCPA/TCF compliance&#x20;

For European and UK traffic, **GDPR compliance is mandatory**. &#x20;

Refer to [GDPR/CCPA/TCF Compliance](/adagio-documentation/operations-and-support/standards-and-compliance/gdpr-ccpa-tcf-compliance.md)
{% endstep %}

{% step %}

### Ensure your requests are properly configured

Refer to [Bid Request Fields for Web Inventory](/adagio-documentation/openrtb-s2s-endpoint/editor/bid-request-fields-for-web-inventory.md)
{% endstep %}

{% step %}

### **Restrict the Number of TagIDs per website**

{% hint style="warning" %}
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
{% endhint %}

Review [TagID Limits and Guidelines](/adagio-documentation/openrtb-s2s-endpoint/review-your-technical-integration/tagid-limits-and-guidelines.md) to understand these limits and best practices.
{% endstep %}

{% step %}

### Ensure you respect the minimum timeout (`tmax`)

{% hint style="danger" %}
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.&#x20;
{% endhint %}

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.&#x20;
{% endstep %}

{% step %}

### Review our BidResponses formats and content

Refer to [Bid Response Fields for Web Inventory](/adagio-documentation/openrtb-s2s-endpoint/editor/bid-response-fields-for-web-inventory.md)
{% endstep %}

{% step %}

### 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](/adagio-documentation/account-configuration/manage-supply-chain-related-files/review-inventory-supply-chain-status.md)
2. **Enhance your ad requests** by adding parameters through extensions. Explore [Supported Extensions](/adagio-documentation/openrtb-s2s-endpoint/supported-extensions.md) on Web, including **EIDs** and **OMID**.
   {% endstep %}
   {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://adagio-io.gitbook.io/adagio-documentation/openrtb-s2s-endpoint/editor.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.