OpenRTB Integration

Modified on Wed, 4 Nov at 5:55 AM

bideaseINTEGRATION GUIDE
General information and advice for starting an integration with the Bidease Ad Exchange: the integration flow, supported ad formats, loss reason codes and ERID specifications.
2.5
OpenRTB 2.5
We support OpenRTB 2.5; our servers are in US East, US West and EMEA.
◷
100 ms timeout
The timeout is 100 milliseconds.
⚠
Always pass burl and nurl
Pass burl and nurl, and a valid ad domain, in every response.
REFERENCE
Integration Guide
1
Apply

Please fill out the application form: it helps us understand your capabilities and get back to you with an answer.

2
General requirements
ItemRequirement
ProtocolOpenRTB 2.5
Server locationsUS East, US West, EMEA
Timeout100 milliseconds
burl and nurlPass them at all times
Ad domainPass a valid ad domain at all times
ContentComply with the content policies
3
Integration flow

Here is the standard integration flow for your reference:

■
Once the agreement is signed, please provide us with one or multiple endpoints, whichever is more convenient for you. Please don't forget to tell us about QPS limitations for the endpoints, if there are any.
■
The tests are normally done on 320×50 banners. You will receive a small amount of QPS to test latency and request/response compatibility.
■
If the test is successful, we will increase the QPS for discrepancy tests. Please make sure to bid as much as possible.
■
We do not strictly require our partners to provide discrepancy reports after the integration is finished, but you might want to consider it.
■
If the banner test goes well, we will move on to testing other formats to complete the integration.
4
Supported ad formats

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.

FormatOverview
VideoRewarded 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 interstitialsPlayable 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 displayStatic 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 videoNative ads fit seamlessly into the user's session and subtly draw attention to the product without being too pushy.
5
HTML

The popular sizes are:

SizeDimensions
Banner Phone320×50
Banner Tablet728×90
Medium Rectangle300×250
Fullscreen Interstitial Portrait320×480
Fullscreen Interstitial Landscape480×320
Tablet Fullscreen Interstitial Portrait768×1024
Tablet Fullscreen Interstitial Landscape1024×768

Supported formats: PNG, JPG/JPEG, GIF.

6
MRAID

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.

ⓘ
MRAID video: when bidding on MRAID video inventory, make sure you bid on requests passing "attr": [6] or [7], as per the OpenRTB specification.
7
Rewarded MRAID

The Bidease Ad Exchange supports both MRAID playable and MRAID video. The custom close option is supported on most of the inventory.

8
Video VAST
ItemRequirement
Video file formatMP4 recommended
Video durationIdeally 30 seconds or less
Video file sizeIdeally around 2 MB; the maximum is about 5 MB
Video dimensions320×480, 480×320, 1024×768, 768×1024, 1280×720
Companion ad / end card formats.png, .bmp, .jpeg, .gif
Companion ad / end card sizes320×250, 320×480, 480×320, 1024×768, 768×1024
On-video banner230×230; .png, .bmp, .jpeg
ⓘ
Playable end cards are supported via HTML and IFrameResource.
9
Opt-in rewarded VAST video

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.

ⓘ
Static end cards are preferred, as they are supported on most of the rewarded video inventory.
10
Native ads

Native assets have the following restrictions:

AssetRestriction
TitleNo longer than 50 characters
Main textLimited to 150 characters
Icon80×80 pixels or larger (with the same ratio)
Main image800×417, 1200×627, 1200×628 or 800×418 pixels
Call to actionLimited to 15 characters
11
Native video

Native video requires additional assets.

■
The maximum accepted video length is 120 seconds, but we recommend shorter videos
■
The preferred format is MP4, and the preferred size is below 5 MB
■
Best practice is to submit both a video and a main image asset, as the image is displayed if the video fails
12
Loss reason codes
ValueDescription
1001The response does not contain the mandatory attribute burl
1002VAST wrapper is not supported
1003The response does not contain the mandatory attribute erid
1004The internal limit on the maximum bid price has been exceeded
13
ERID specifications

For requests from Russia (RUS geo), Bidease passes an additional object in BidRequest.regs.ext:

AttributeTypeDescription
nroaobjectParent object
nroa.versionstringCurrent version number, without the v prefix
nroa.mandatoryintegerIf 1, you must pass ERID information in the response; bids without it are not admitted to the auction
REQUEST EXAMPLE
{
   "regs":{
      "ext":{
         "nroa":{
            "version":"2",
            "mandatory":1
         }
      }
   }
}

To pass ERID data in BidResponse.seatbid.bid.ext, use this specification:

AttributeTypeDescription
nroaobjectParent object
nroa.eridstringERID token
RESPONSE EXAMPLE
{
    "nroa":{
       "erid":"uhk90ol"
    }
}
bidease
Grow Your App with Ease
Questions? Contact your Bidease account manager
support@bidease.com

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article