OpenRTB specifications
You can buy traffic from our network using your own DSP via OpenRTB protocol. Following specifications will help you to understand whether your system is compatible with ours.
Integration with our SSP
Prerequisites
- Support of the openRTB v2.3 protocol.
- Send us the URL of the entry points on the DSP for a bid request.
- Determine the window for the test frame.
Restrictions
SStrictly one element of Impression is transmitted in the bid request, and the bid response in its turn is expected to contain strictly one Bid element.
Recommendations
Our data center is located in Amsterdam and Hong Kong. To reduce the latency between your DSP and our SSP it is strongly recommended to use DSPs that are also located in European and Asian data centers.
Examples
Bid Request example:
json
{
"id": "5b3a57ce15a176428f0013e5",
"imp": [{
"id": "5b3a57ce15a176428f0013e3",
"banner": {
"w": 300,
"h": 250
}
}],
"site": {
"id": "5b30b08a8ec3f869e1559a86"
},
"device": {
"ua": "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/63.0.3239.132 Safari/537.36",
"geo": {
"country": "US"
},
"ip": "104.153.100.183",
"devicetype": 2,
"language": "zh-cn"
},
"user": {
"id": "5d34dcbfc78bc7f6f61b4a4da9f5a51a"
}
}Bid Response example
json
{
"cur": "USD",
"id": "9fbf3f82-5adf-42b9-8565-281d84deea84",
"seatbid": [
{
"bid": [
{
"adm": "<a href='http://tracking.example.com/click?userId=74f18f1c29251684a7a104cc25bfc1bc&impressionId=0608cdb7-8ab1-4670-88a8-57c115e43371&creativeId=5b23f6448ec3f8119b6dcac6&campaignId=5b23f10c8ec3f8753870678a' target='_blank'><img src='http://cdn.example.com/creative.gif'></a>",
"adomain": ["offer-example.org"],
"crid": "5b23f6448ec3f8119b6dcac6",
"id": "5b3c9bceabd6f37731000258",
"impid": "0608cdb7-8ab1-4670-88a8-57c115e43371",
"iurl": "http://cdn.example.com/creative.gif",
"nurl": "http://win-track.example.com",
"price": 2.9999999999999997e-05
}
]
}
]
}Bid Request example for pop
json
{
"id": "5b3a57ce15a176428f0013e5",
"imp": [{"id": "5b3a57ce15a176428f0013e3", "instl": 1}],
"site": {"id": "5b30b08a8ec3f869e1559a86", "name": "My awesome website", "domain": "https://www.my-awesome-site.com"},
"device": {"ua": "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/63.0.3239.132 Safari/537.36", "geo": {"country": "US"}, "ip": "104.153.100.183", "devicetype": 2, "language": "zh-cn"},
"user": {"id": "5d34dcbfc78bc7f6f61b4a4da9f5a51a"}
}Bid Response example for pop
json
{
"cur": "USD",
"id": "9fbf3f82-5adf-42b9-8565-281d84deea84",
"seatbid": [
{
"bid": [
{
"adm": "http://go.example.com/pop?userId=74f18f1c29251684a7a104cc25bfc1bc&impressionId=0608cdb7-8ab1-4670-88a8-57c115e43371&creativeId=5b23f6448ec3f8119b6dcac6&campaignId=5b23f10c8ec3f8753870678a",
"adomain": ["offer-example.org"],
"crid": "5b23f6448ec3f8119b6dcac6",
"id": "5b3c9bceabd6f37731000258",
"impid": "0608cdb7-8ab1-4670-88a8-57c115e43371",
"nurl": "http://win-track.example.com",
"price": 2.9999999999999997e-05
}
]
}
]
}