> 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/in-app.md).

# OpenRTB: Getting Started for App

{% 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/in-app/bid-request-fields-for-app-inventory.md#bid-request-for-web-display-inventory-sample) and [Bid Response](/adagio-documentation/openrtb-s2s-endpoint/in-app/bid-response-fields-for-app-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. **Your Server** sends a **BidRequest** (JSON, gzip-compressed) to Adagio’s regional endpoint.
2. **Adagio** runs a real-time auction across multiple demand partners.&#x20;
3. **Winning Bid** is returned as a **BidResponse** (JSON, gzip-compressed).
4. You render the winning creative in your app.

## Integration Steps

{% stepper %}
{% step %}

### Declare your inventory

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

{% step %}

### Update app-ads.txt lines&#x20;

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

{% 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>App</td><td>Banner</td><td>✅</td></tr><tr><td>App</td><td>Native</td><td>✅</td></tr><tr><td>App</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 configure parameters

Refer to [Bid Request Fields for App Inventory](https://adagio-io.gitbook.io/adagio-documentation/openrtb-s2s-endpoint/in-app/bid-request-fields-for-app-inventory#required-parameters)
{% endstep %}

{% step %}

### **Restrict Number of TagIDs per app**

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

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 to maximise monetization performance (maximises fill rate and CPM) while maintaining an acceptable user experience.&#x20;
{% endstep %}

{% step %}

### Verify Bid Request and Bid Response Requirements

Refer to [Bid Request Fields for App Inventory](/adagio-documentation/openrtb-s2s-endpoint/in-app/bid-request-fields-for-app-inventory.md) and [Bid Response Fields for App Inventory](/adagio-documentation/openrtb-s2s-endpoint/in-app/bid-response-fields-for-app-inventory.md)
{% endstep %}

{% step %}

### Improve your monetization performance

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

1. **Review the supply chain 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. Ensure that you **comply with Amazon DSP's requirements for monetisation**. See [Amazon DSP: ContentURL & AmazonAdBot](/adagio-documentation/openrtb-s2s-endpoint/amazon-dsp-contenturl-and-amazonadbot.md)
3. **Enhance your ad requests** by adding parameters through extensions. Explore [Supported Extensions](/adagio-documentation/openrtb-s2s-endpoint/supported-extensions.md) on App, including **EIDs, OMID** and **SkadNetworkID**.
   {% 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/in-app.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.