OpenRTB Integration example

OpenRTB Integration v1 last update 2018-01-17

1. Overview

Below you can found SSP request and DSP response, which contain the minimum required fields.

SSP Request

{
  "id": "SSP_BID_ID",
  "cur": [
    "RUB"
    ],
    "imp": [
        {
            "id": "1",
            "bidfloor": 5,
            "bidfloorcur": "RUB",
            "banner": {
                "w": 240,
                "h": 400
            },
            "ext": {
                "ad_types": [
                    "t",
                    "b",
                    "cu"
                ],
                "teaser_w": 100,
                "teaser_h": 100,
                "teasers_count": 2
            }
        }
    ],
    "site": {
        "page": "http://testdomain.ru/testpage.html",
        "domain": "testdomain.ru",
        "ref": "http://ya.ru/"
    },
    "device": {
        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/36.0.1985.143 Safari/537.36",
        "ip": "127.0.0.1"
    },
    "user": {
        "id": "SSP_UID"
    }
}

DSP Response (Banner)

{
    "id": "SSP_BID_ID",
    "cur": "RUB",
    "seatbid": [
        {
            "bid": [
                {
                    "id": "1-1",
                    "impid": "1",
                    "crid": "7892624100260835905",
                    "price": 50.0,
                    "adm": "BANNER XHTML CODE",
                    "nurl": "http://testdomain.ru/nurl/?price=${AUCTION_PRICE}"
                }
            ]
        }
    ]
}

DSP Response (Teasers)

{
    "id": "SSP_BID_ID",
    "cur": "RUB",
    "seatbid": [
        {
            "bid": [
                {
                    "id": "1-1",
                    "impid": "1",
                    "price": 50.0,
                    "nurl": "http://testdomain.ru/nurl/?price=${AUCTION_PRICE}",
                    "ext": {
                        "teasers_html": "XHTML CODE (pixels) FOR TEASERS BLOCK",
                        "teasers": [
                            {
                                "title": "Teaser1 title",
                                "text": "Teaser1 text",
                                "image": "http://testdomain.ru/123456_100x100.jpg",
                                "url": "http://testdomain.ru/out/url/1/"
                            },
                            {
                                "title": "Teaser2 title",
                                "text": "Teaser2 text",
                                "image": "http://testdomain.ru/7890_100x100.jpg",
                                "url": "http://testdomain.ru/out/url/2/"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

DSP Response (Clickunder)

{
    "id": "SSP_BID_ID",
    "cur": "RUB",
    "seatbid": [
        {
            "bid": [
                {
                    "id": "1-1",
                    "impid": "1",
                    "price": 50.0,
                    "ext": {
                        "cu_url": "http://ya.ru/"
                    }
                }
            ]
        }
    ]
}