RTB Specifications

AdServing Factory is fully compliant with IAB's OpenRTB 2.4 specifications and its Native subprotocol version 1.1. You can learn more about IAB's OpenRTB and Native subprotocol from the links below.

Banner BidRequest Example:


{
    "id":"6750528580817250",
    "imp":[
        {
            "id":"1",
            "banner":{
                "w":300,
                "h":250,
                "id":"123456789",
                "pos":3,
                "mimes":[
                    "text/plain",
                    "text/html",
                    "text/xml",
                    "image/jpg",
                    "image/jpeg",
                    "image/gif",
                    "image/png",
                    "application/x-shockwave-flash",
                    "application/javascript"
                ]
            },
            "instl":0,
            "tagid":"au_xgbTL8DiQff3e3C6Ete5aA+pA+wSIqYGTRk/RcH2apY=",
            "bidfloor":1.07163,
            "bidfloorcur":"USD"
        }
    ],
    "site":{
        "id":"123456789",
        "name":"site.com",
        "domain":"site.com",
        "page":"http://site.com/page.html",
        "ref":"https://www.site.com/category",
        "publisher":{"id":"123456789"},
        "content":{
            "id":"123456789",
            "url":"http://site.com/page.html",
            "context":"5",
            "sourcerelationship":1
        }
    },
    "device":{
        "ua":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10.10; rv:53.0) Gecko/20100101 Firefox/53.0",
        "geo":{"type":2, "country":"FRA"},
        "ip":"192.0.0.1",
        "devicetype":2,
        "os":"Mac OS X",
        "osv":"10.10",
        "js":1,
        "flashver":"23"
    },
    "user":{"buyeruid":"u123456789"},
    "test":0,
    "at":2,
    "tmax":350,
    "allimps":0,
    "bcat":["IAB25", "IAB26"]
}
            

Video BidRequest Example:


{
    "id":"99078430807759470",
    "imp":[
        {
            "id":"1",
            "video":{
                "mimes":[
                    "video/mp4",
                    "application/javascript"
                ],
                "minduration":1,
                "maxduration":120,
                "protocols":[2, 3, 5, 6],
                "w":640,
                "h":480,
                "linearity":1,
                "battr":[10, 11, 14],
                "maxextended":2,
                "minbitrate":50,
                "maxbitrate":12000,
                "boxingallowed":1,
                "pos":3,
                "api":[2]
            },
            "instl":0,
            "tagid":"au_UBpsrEtpuH6fzxuaKlrTKXzRu0XEvgkoF/I7Cj+gE4g=",
            "bidfloor":2.588439,
            "bidfloorcur":"USD"
        }
    ],
    "site":{
        "id":"123456789",
        "name":"site.com",
        "domain":"site.com",
        "page":"http://site.com/page.html",
        "ref":"http://site.com/category",
        "publisher":{"id":"123456789"},
        "content":{
            "id":"123456789",
            "url":"http://site.com/page.html",
            "videoquality":1,
            "context":"5",
            "sourcerelationship":1
        }
    },
    "device":{
        "ua":"Mozilla/5.0 (Linux; Android 6.0; VFD 1100 Build/MRA58K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.83 Safari/537.36",
        "geo":{"type":2, "country":"DEU"},
        "ip":"192.0.0.1",
        "devicetype":1,
        "make":"Generic_Android",
        "model":"VFD 1100",
        "os":"Android",
        "osv":"6.0",
        "js":1,
        "flashver":"0"
    },
    "user":{"buyeruid":"u123456789"},
    "test":0,
    "at":2,
    "tmax":350,
    "allimps":0,
    "bcat":["IAB25", "IAB26"]
}
            

Native BidRequest Example:


{
    "id":"6564004331957851",
    "imp":[{
        "id":"1",
        "native":{
            "request":"{\"ver\":\"1.0\",\"layout\":6,\"adunit\":503,\"plcmtcnt\":1,\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":75}},{\"id\":2,\"required\":1,\"img\":{\"type\":3,\"wmin\":382,\"hmin\":200}},{\"id\":3,\"required\":1,\"data\":{\"type\":1,\"len\":35}},{\"id\":4,\"img\":{\"type\":1,\"wmin\":50,\"hmin\":50}},{\"id\":5,\"data\":{\"type\":2,\"len\":160}}]}",
            "ver":"1.0",
            "api":[2]
        },
        "instl":0,
        "tagid":"au_euuLP2Ah36xKhiCA8tRSOiHvy4Jl4zGQnwUhUtqdnfU=",
        "bidfloor":0.75,
        "bidfloorcur":"USD"
    }],
    "site":{
        "id":"123456789",
        "name":"site.com",
        "domain":"site.com",
        "page":"http://site.com/page.html",
        "ref":"http://site.com/category",
        "publisher":{"id":"123456789"},
        "content":{
            "id":"123456789",
            "url":"http://site.com/page.html",
            "context":"5",
            "sourcerelationship":1
        }
    },
    "device":{
        "ua":"Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/61.0.3163.100 Safari/537.36",
        "geo":{"type":2, "country":"ITA"},
        "ip":"192.0.0.1",
        "devicetype":2,
        "os":"Windows 7",
        "js":1,
        "flashver":"27"
    },
    "user":{"buyeruid":"u123456789" },
    "test":0,
    "at":2,
    "tmax":350,
    "allimps":0,
    "bcat":["IAB25", "IAB26"]
}