Partner onboarding: FAQ

This FAQ consolidates the most common questions we get from our Supply Partners during onboarding, please note that these give an easy access to information that is accessible in the rest of this doc.

This page is a synthesis for faster partner onboarding. For implementation details, always use the linked technical documentation pages.

Quick links by topic:

• Integration setup: Allowed integrations, Endpoints Integrations

• OpenRTB specs: Supported OpenRTB Versions, All Supported OpenRTB Parameters

• Request/response fields: App bid request, App bid response, Web bid request, Web bid response

• Privacy and IDs: GDPR/CCPA/TCF Compliance, External IDs (EIDs), SKAdNetwork for iOS Apps

• Operations and quality: Data Compression (gzip), Round Trip Time, Supply Chain Verification, Blocklists, Monetizable ad sizes

Core Integration

Which OpenRTB versions are supported?

We support OpenRTB 2.5 and 2.6.

Related docs:

• Supported OpenRTB Versions

• Bid Request Fields for App Inventory

• Bid Request Fields for Web Inventory

Do you support multiple imp objects and multiple formats?

Yes. We support:

• Multi-imp bid requests

• Multiple sizes in banner.format

• Multi-format requests

Related docs:

• Bid Request objects and parameters

Which integration methods are available?

Current supported integrations include:

• OpenRTB (/ortb)

• Prebid.js (client adapter)

• Prebid Server Adapter

Related docs:

• Allowed integrations

• Endpoints Integrations

• Prebid documentation

Is GZIP required?

Yes. GZIP/compressed JSON is required on server-to-server integrations.

Related docs:

• Data Compression (gzip)

Are there QPS limits?

No channel-specific QPS throttling is currently enforced.

Which data center regions are used?

Primary data centers are in Las Vegas, Amsterdam, and Tokyo.

Ads.txt, Supply Chain, and Pricing

Is (app-)ads.txt required?

Yes, we strictly enforce the Supply Chain Validation files (which includes the schain object, the (app-)ads.txt and the sellers.json when applicable)

Related docs:

• Update Your (App-)Ads.Txt File

Do you support schain?

Yes. Full schain transmission is expected for monetization.

Related docs:

• Review Inventory Supply Chain Status

• Supply Chain Verification

Gross or Net bid CPM?

Both models can be supported depending on your preference.

Are deal IDs / PMPs supported?

Because Adagio doesn't have direct demand: NO.

Formats and Creative Handling

Which ad formats are supported?

Supported demand includes banner/display, video (including VAST), native, interstitial, playable/rewarded, and MRAID-based demand depending on integration.

Which VAST / Native / MRAID versions are supported?

• Native versions: 1.1 and 1.2

• VAST's versions: up to 4.0

• MRAID supported

Related docs:

• Bid Response Fields for App Inventory

• Bid Response Fields for Web Inventory

Which video parameters are required/recommended?

video.mimes is required. Commonly recommended parameters include: minduration, maxduration, startdelay, protocols, w, h, plcmt, linearity, api, companiontype.

How do you handle no-bid responses?

For non-Prebid (as those use our adapter to handle no bids in a custom manner) integrations, no-bid responses can be returned as HTTP 204 No Content.

Identity, Privacy, and Compliance

Which privacy frameworks are supported?

Supported in onboarding responses:

• GDPR (regs.ext.gdpr, user.ext.consent)

• IAB TCF v.2.3

• US Privacy / MSPA

• GPP

• COPPA

Related docs:

• GDPR/CCPA/TCF Compliance

What happens when consent is missing?

Adagio strips all private information and forwards the request to demand partners. Nevertheless, usually those tend to perform worse.

Do you support external IDs?

Yes (e.g. ID5, Panorama ID, RampID, ConnectID, UID2...), when included in the request, external IDs are broadcasted to demand partners.

Related docs:

• External IDs (EIDs)

Do you support SKAdNetwork (SKAN)?

Yes. SKAdNetwork is supported. Adagio doesn't have an ID itself by has aggregated the IDs from its demand partners to be included on iOS app configuration files.

Related docs:

• SKAdNetwork for iOS Apps

Are blocklists and safety controls available?

Yes. Blocklists can be configured for app/category/domain constraints (bapp, bcat, badv) either within the request's parameters or through our interface (additive to those within the request)

Related docs:

• Blocklists

Performance and Tracking

What timeout (tmax) should partners use?

• Strict lower boundary appears at 470ms

• Practical target shared in forms is around 1000ms to 1500ms depending on setup

Related docs:

• Round Trip Time

Which impression tracking model is used?

adm-based impression tracking is supported. Impression expiration and request/response consistency rules are also applied.

Is cid always present in bid responses?

cid is present when the winning demand partner/bidder on Adagio's side provides it.

Is cat always present in bid responses?

cat depends on whether the winning demand partner provides it.

Which reporting options are available?

For this Premium account, onboarding responses indicate reporting can be delivered through:

• API

• Email

• Adagio platform dashboards

Related docs:

• Need Assistance?