OpenRTB Integration
Modified on Wed, 4 Nov at 5:55 AM

Please fill out the application form: it helps us understand your capabilities and get back to you with an answer.
| Item | Requirement |
|---|---|
| Protocol | OpenRTB 2.5 |
| Server locations | US East, US West, EMEA |
| Timeout | 100 milliseconds |
| burl and nurl | Pass them at all times |
| Ad domain | Pass a valid ad domain at all times |
| Content | Comply with the content policies |
Here is the standard integration flow for your reference:
As an exchange focused on in-app inventory, the Bidease Ad Exchange has expertise in working with all the popular in-app formats. The in-app inventory can be divided into several groups, each with its own advantages. This short guide provides an overview of the formats available on the Bidease Ad Exchange. For more information on each format, see the sections below.
| Format | Overview |
|---|---|
| Video | Rewarded and non-rewarded video placements dominate in-app monetization and are in high demand for performance and brand awareness campaigns alike. The Bidease Ad Exchange supports both rewarded and non-rewarded placement targeting, which offers a lot of flexibility in targeting the right users. Video placements offer quite a variety of formats: you can run VAST campaigns, VAST wrapper campaigns and MRAID video campaigns (see the MRAID section). |
| Playable interstitials | Playable ads are becoming increasingly popular in mobile advertising, as they give potential users an opportunity to interact with the product and see its advantages. Rewarded and non-rewarded placements are available for playable creatives. |
| Other display | Static display creatives have been around for a long time, and they still do their job. Various banner sizes are available in-app, from small banners to static interstitials. |
| Native and native video | Native ads fit seamlessly into the user's session and subtly draw attention to the product without being too pushy. |
The popular sizes are:
| Size | Dimensions |
|---|---|
| Banner Phone | 320×50 |
| Banner Tablet | 728×90 |
| Medium Rectangle | 300×250 |
| Fullscreen Interstitial Portrait | 320×480 |
| Fullscreen Interstitial Landscape | 480×320 |
| Tablet Fullscreen Interstitial Portrait | 768×1024 |
| Tablet Fullscreen Interstitial Landscape | 1024×768 |
Supported formats: PNG, JPG/JPEG, GIF.
The Bidease Ad Exchange supports both MRAID playable and MRAID video. When bidding with a creative, best practice is to keep the HTML itself smaller than 15 KB and the files it loads no bigger than 2–3 MB; we consider these sizes optimal.
For MRAID, the Bidease Ad Exchange has inventory supporting static, HTML and IFrameResource end cards.
The Bidease Ad Exchange supports both MRAID playable and MRAID video. The custom close option is supported on most of the inventory.
| Item | Requirement |
|---|---|
| Video file format | MP4 recommended |
| Video duration | Ideally 30 seconds or less |
| Video file size | Ideally around 2 MB; the maximum is about 5 MB |
| Video dimensions | 320×480, 480×320, 1024×768, 768×1024, 1280×720 |
| Companion ad / end card formats | .png, .bmp, .jpeg, .gif |
| Companion ad / end card sizes | 320×250, 320×480, 480×320, 1024×768, 768×1024 |
| On-video banner | 230×230; .png, .bmp, .jpeg |
To bid on rewarded inventory, make sure you target requests with the rewarded flag. The general requirements for the creatives are similar to those for non-rewarded VAST.
Native assets have the following restrictions:
| Asset | Restriction |
|---|---|
| Title | No longer than 50 characters |
| Main text | Limited to 150 characters |
| Icon | 80×80 pixels or larger (with the same ratio) |
| Main image | 800×417, 1200×627, 1200×628 or 800×418 pixels |
| Call to action | Limited to 15 characters |
Native video requires additional assets.
| Value | Description |
|---|---|
| 1001 | The response does not contain the mandatory attribute burl |
| 1002 | VAST wrapper is not supported |
| 1003 | The response does not contain the mandatory attribute erid |
| 1004 | The internal limit on the maximum bid price has been exceeded |
For requests from Russia (RUS geo), Bidease passes an additional object in BidRequest.regs.ext:
| Attribute | Type | Description |
|---|---|---|
| nroa | object | Parent object |
| nroa.version | string | Current version number, without the v prefix |
| nroa.mandatory | integer | If 1, you must pass ERID information in the response; bids without it are not admitted to the auction |
{
"regs":{
"ext":{
"nroa":{
"version":"2",
"mandatory":1
}
}
}
}To pass ERID data in BidResponse.seatbid.bid.ext, use this specification:
| Attribute | Type | Description |
|---|---|---|
| nroa | object | Parent object |
| nroa.erid | string | ERID token |
{
"nroa":{
"erid":"uhk90ol"
}
}support@bidease.com
Attachments (1)
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article