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

    Strictly 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

    {
    "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

    {
    	"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

    {
    "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

    {
    	"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
    				}
    			]
    		}
    	]
    }