1. Fyber
  2. Fyber Marketplace
  3. Buyers Entrance
  4. OpenRTB Specifications

Sample Bid Requests

Introduction

Set out below are examples of bid requests for each ad format, based on the latest OpenRTB spec and Fyber SDK.

Each of the examples below:

  • Contain us_privacy
  • Include schain object and support GDPR 

Rewarded Video

Sample Request: Rewarded Video
{
    "id": "6966999xxxxx7616307",
    "imp": [{
        "id": "1",
        "secure": 0,
        "tagid": "675380",
        "video": {
            "playbackmethod": [5],
            "playbackend": 1,
            "mimes": ["application/javascript", "video/mp4", "video/webm", "video/3gpp"],
            "minduration": 1,
            "maxduration": 30,
            "protocols": [2, 5],
            "w": 1024,
            "h": 768,
            "startdelay": 0,
            "placement": 5,
            "linearity": 1,
            "skip": 0,
            "battr": [3, 8, 9, 10, 13, 14, 17],
            "maxbitrate": 5000,
            "pos": 7,
            "companionad": [{
                "id": "1",
                "pos": 7,
                "mimes": ["test/html", "text/javascript", "image/png", "image/jpeg", "image/gif"],
                "vcm": 1,
                "w": 1024,
                "h": 768
            }],
            "companiontype": [1, 2, 3],
            "api": [2],
            "ext": {
                "mraidendcard": 1,
                "rewarded": 1
            }
        },
        "displaymanager": "Fyber",
        "displaymanagerver": "2.3.0",
        "clickbrowser": 0,
        "instl": 1,
        "pmp": {
            "deals": [{
                "id": "FyberVAMP_HighCTR",
                "at": 2,
                "bidfloor": 5.00,
                "wseat": []
            }],
            "private_auction": 0
        },
        "bidfloor": 5.00,
        "bidfloorcur": "USD",
        "ext": {
            "brsrclk": 1
        }
    }],
    "app": {
        "id": "675380",
        "name": "App_Name",
        "cat": ["IAB9", "IAB9-30"],
        "ver": "2.01.1",
        "bundle": "com.bundle",
        "privacypolicy": 1,
        "paid": 0,
        "publisher": {
            "id": "111111",
            "name": "Pub_Name",
            "ext": {}
        },
        "storeurl": "https://apps.apple.com/app/color-fill-3d/id147xxxx868?uo=5&at=10l9yE",
        "ext": {}
    },
    "device": {
        "dnt": 0,
        "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 13_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
        "ip": "90.108.113.69",
        "lmt": 0,
        "geo": {
            "lat": 49.61,
            "lon": 0.75,
            "country": "FRA",
            "ipservice": 3,
            "region": "76",
            "city": "Yvetot",
            "type": 2,
            "ext": {}
        },
        "carrier": "Orange",
        "language": "fr",
        "make": "Samsung",
        "model": "SM-T590",
        "os": "Android",
        "osv": "9.0",
        "hwv": "Galaxy Tab A 10.5",
        "w": 1280,
        "h": 752,
        "js": 1,
        "connectiontype": 2,
        "devicetype": 5,
        "ifa": "99999999999999999999",
        "ext": {
            "inputLanguage": ["fr"]
        }
    },
    "user": {
        "gender": "",
        "ext": {
            "consent": "0"
        }
    },
    "source": {
        "fd": 0,
        "tid": "6966999285087616307",
        "ext": {
            "schain": {
                "ver": "1.0",
                "complete": 1,
                "nodes": [{
                    "asi": "fyber.com",
                    "sid": "111111",
                    "hp": 1,
                    "rid": "6966999285087616307"
                }]
            }
        }
    },
    "regs": {
        "coppa": 0,
        "ext": {
            "gdpr": 1,
            "us_privacy": "1YNX"
        }
    },
    "at": 2,
    "cur": ["USD"],
    "tmax": 350,
    "bcat": ["IAB7-28", "IAB7-42", "IAB17-18", "IAB25-1", "IAB25-2", "IAB25-3", "IAB25-4", "IAB25-5", "IAB26", "IAB26-1", "IAB26-2", "IAB26-3", "IAB26-4", "IAB9-9"],
    "badv": [],
    "ext": {}
}
 

VAST with End Card

Sample Request: VAST with End Card
{
    "id": "7525515xxxxx1448468",
    "imp": [{
        "id": "1",
        "secure": 0,
        "tagid": "681792",
        "video": {
            "playbackmethod": [5],
            "playbackend": 1,
            "mimes": ["application/javascript", "video/mp4", "video/webm", "video/3gpp"],
            "minduration": 1,
            "maxduration": 30,
            "protocols": [2, 5],
            "w": 320,
            "h": 480,
            "startdelay": 0,
            "placement": 5,
            "linearity": 1,
            "skip": 1,
            "skipmin": 15,
            "skipafter": 5,
            "battr": [3, 8, 9, 10, 13, 14, 17],
            "maxbitrate": 5000,
            "pos": 7,
            "companionad": [{
                "id": "1",
                "pos": 7,
                "mimes": ["test/html", "text/javascript", "image/png", "image/jpeg", "image/gif"],
                "vcm": 1,
                "w": 320,
                "h": 480
            }],
            "companiontype": [1, 2, 3],
            "api": [2],
            "ext": {
                "mraidendcard": 1,
                "rewarded": 0
            }
        },
        "displaymanager": "Fyber",
        "displaymanagerver": "7.3.1",
        "clickbrowser": 0,
        "instl": 1,
        "pmp": {
            "deals": [{
                "id": "FyberVAMP_HighCTR",
                "at": 2,
                "bidfloor": 5.00,
                "wseat": []
            }],
            "private_auction": 0
        },
        "bidfloor": 5.00,
        "bidfloorcur": "USD",
        "ext": {
            "brsrclk": 1
        }
    }],
    "app": {
        "id": "681792",
        "name": "App_Name",
        "cat": ["IAB9-30"],
        "ver": "2.204.0",
        "bundle": "com.bundle",
        "privacypolicy": 1,
        "paid": 0,
        "publisher": {
            "id": "111111",
            "name": "Pub_Name",
            "ext": {}
        },
        "storeurl": "https://apps.apple.com/app/color-fill-3d/id147xxxx868?uo=5&at=10l9yE",
        "ext": {}
    },
    "device": {
        "dnt": 0,
        "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 13_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
        "ip": "68.63.173.153",
        "lmt": 0,
        "geo": {
            "lat": 36.7719,
            "lon": -81.6651,
            "country": "USA",
            "ipservice": 3,
            "region": "VA",
            "metro": "531",
            "city": "Chilhowie",
            "zip": "24319",
            "type": 2,
            "ext": {}
        },
        "carrier": "480",
        "language": "en",
        "make": "Samsung",
        "model": "SM-G930V",
        "os": "Android",
        "osv": "8.0",
        "hwv": "Galaxy S7",
        "w": 360,
        "h": 640,
        "js": 1,
        "connectiontype": 2,
        "devicetype": 4,
        "ifa": "99999999999999999999",
        "ext": {
            "inputLanguage": ["en"]
        }
    },
    "user": {
        "gender": "",
        "ext": {
            "consent": "1"
        }
    },
    "source": {
        "fd": 0,
        "tid": "7525515821281448468",
        "ext": {
            "schain": {
                "ver": "1.0",
                "complete": 1,
                "nodes": [{
                    "asi": "fyber.com",
                    "sid": "111111",
                    "hp": 1,
                    "rid": "7525515821281448468"
                }]
            }
        }
    },
    "regs": {
        "coppa": 0,
        "ext": {
            "gdpr": 0,
            "us_privacy": "1YNX"
        }
    },
    "at": 2,
    "cur": ["USD"],
    "tmax": 350,
    "bcat": ["IAB7-28", "IAB7-42", "IAB17-18", "IAB25-1", "IAB25-2", "IAB25-3", "IAB25-4", "IAB25-5", "IAB26", "IAB26-1", "IAB26-2", "IAB26-3", "IAB26-4", "IAB9-9"],
    "badv": ["lacima.space", "mobilityware.com", "jp.iqos.com"],
    "ext": {}
}
 

Playable

Sample Request: Playable
{
    "id": "7909355128353737697",
    "imp": [{
        "id": "1",
        "secure": 0,
        "tagid": "674495",
        "banner": {
            "id": "1",
            "w": 320,
            "h": 480,
            "wmin": 320,
            "hmin": 480,
            "pos": 7,
            "battr": [3, 8, 9, 10, 14, 17],
            "topframe": 1,
            "btype": [4],
            "api": [5],
            "ext": {}
        },
        "displaymanager": "Fyber",
        "displaymanagerver": "7.4.1",
        "clickbrowser": 0,
        "instl": 1,
        "bidfloor": 5.00,
        "bidfloorcur": "USD",
        "ext": {
            "brsrclk": 1
        }
    }],
    "app": {
        "id": "674495",
        "name": "App_Name",
        "cat": ["IAB9-30"],
        "ver": "1.6.1",
        "bundle": "com.bundle",
        "privacypolicy": 1,
        "paid": 0,
        "publisher": {
            "id": "111111",
            "name": "Pub_Name",
            "ext": {}
        },
        "storeurl": "https://apps.apple.com/app/color-fill-3d/id147xxxx868?uo=5&at=10l9yE",
        "ext": {}
    },
    "device": {
        "dnt": 0,
        "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 13_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
        "ip": "98.216.205.103",
        "lmt": 0,
        "geo": {
            "lat": 42.5781,
            "lon": -71.805,
            "country": "USA",
            "ipservice": 3,
            "region": "MA",
            "metro": "506",
            "city": "Fitchburg",
            "zip": "01420",
            "type": 2,
            "ext": {}
        },
        "carrier": "410",
        "language": "en",
        "make": "Samsung",
        "model": "SM-J337A",
        "os": "Android",
        "osv": "9.0",
        "hwv": "Galaxy Amp Prime 3 2018",
        "w": 320,
        "h": 569,
        "js": 1,
        "connectiontype": 2,
        "devicetype": 4,
        "ifa": "99999999999999999999",
        "ext": {
            "inputLanguage": ["en"]
        }
    },
    "user": {
        "gender": "",
        "ext": {
            "consent": "1"
        }
    },
    "source": {
        "fd": 0,
        "tid": "7909355128353737697",
        "ext": {
            "schain": {
                "ver": "1.0",
                "complete": 1,
                "nodes": [{
                    "asi": "fyber.com",
                    "sid": "111111",
                    "hp": 1,
                    "rid": "7909355128353737697"
                }]
            }
        }
    },
    "regs": {
        "coppa": 0,
        "ext": {
            "gdpr": 0,
            "us_privacy": "1YXZ"
        }
    },
    "at": 2,
    "cur": ["USD"],
    "tmax": 350,
    "bcat": ["IAB7-39", "IAB14-1", "IAB14-3", "IAB25-1", "IAB25-6", "IAB8-5", "IAB8-18", "IAB12-2", "IAB12-3", "IAB11-4", "IAB12-1", "IAB7-28", "IAB7-42", "IAB17-18", "IAB25-1", "IAB25-2", "IAB25-3", "IAB25-4", "IAB25-5", "IAB26", "IAB26-1", "IAB26-2", "IAB26-3", "IAB26-4", "IAB9-9"],
    "badv": ["alldaygadets.com", "aztracking.net", "medmen.com", "medmen.org", "languinisgame.com", "bitmango.com", "chippymediallc.com", "candywriter.com", "zynga.com", "maginteractive.com", "babe.co.id", "matchasaucellc.com", "platinumplayerllc.com", "playsimple.in", "pixelberrystudios.com", "wordlifegame.com", "devgame88.blogspot.com"],
    "ext": {}
}

Display Interstitial

Sample Request: Display Interstitial
{
    "id": "5346387055146762831",
    "imp": [{
        "id": "1",
        "secure": 1,
        "tagid": "683547",
        "banner": {
            "id": "1",
            "w": 320,
            "h": 480,
            "wmin": 320,
            "hmin": 480,
            "pos": 7,
            "battr": [3, 8, 9, 10, 14, 17],
            "topframe": 1,
            "btype": [4],
            "api": [5],
            "ext": {}
        },
        "displaymanager": "Fyber",
        "displaymanagerver": "7.3.3",
        "clickbrowser": 0,
        "instl": 1,
        "bidfloor": 5.00,
        "bidfloorcur": "USD",
        "ext": {
            "brsrclk": 1
        }
    }],
    "app": {
        "id": "683547",
        "name": "App_Name",
        "cat": ["IAB9", "IAB9-30", "IAB9-5"],
        "ver": "2.6.0",
        "bundle": "com.bundle",
        "privacypolicy": 1,
        "paid": 0,
        "publisher": {
            "id": "111111",
            "name": "Pub_Name",
            "ext": {}
        },
        "storeurl": "https://apps.apple.com/app/color-fill-3d/id147xxxx868?uo=5&at=10l9yE",
        "ext": {}
    },
    "device": {
        "dnt": 0,
        "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 13_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
        "ip": "73.70.128.94",
        "lmt": 0,
        "geo": {
            "lat": 38.0031,
            "lon": -121.9172,
            "country": "USA",
            "ipservice": 3,
            "region": "CA",
            "metro": "807",
            "city": "Pittsburg",
            "zip": "94565",
            "type": 2,
            "ext": {}
        },
        "carrier": "260",
        "language": "en",
        "make": "Samsung",
        "model": "SM-G965U",
        "os": "Android",
        "osv": "9.0",
        "hwv": "Galaxy S9+",
        "w": 411,
        "h": 798,
        "js": 1,
        "connectiontype": 2,
        "devicetype": 4,
        "ifa": "99999999999999999999",
        "ext": {
            "inputLanguage": ["en", "es"]
        }
    },
    "user": {
        "gender": "",
        "ext": {
            "consent": "1"
        }
    },
    "source": {
        "fd": 0,
        "tid": "5346387055146762831",
        "ext": {
            "schain": {
                "ver": "1.0",
                "complete": 1,
                "nodes": [{
                    "asi": "fyber.com",
                    "sid": "111111",
                    "hp": 1,
                    "rid": "5346387055146762831"
                }]
            }
        }
    },
    "regs": {
        "coppa": 0,
        "ext": {
            "gdpr": 0,
            "us_privacy": "1YNX"
        }
    },
    "at": 2,
    "cur": ["USD"],
    "tmax": 350,
    "bcat": ["IAB7-28", "IAB7-42", "IAB17-18", "IAB25-1", "IAB25-2", "IAB25-3", "IAB25-4", "IAB25-5", "IAB26", "IAB26-1", "IAB26-2", "IAB26-3", "IAB26-4", "IAB9-9"],
    "badv": [],
    "ext": {}
}

Contextual App Targeting

Sample Bid Request
{
"id": "123456789123456789",
"imp": [
{
"id": "1",
"secure": 0,
"tagid": "630394",
"banner": {
"id": "1",
"w": 320,
"h": 480,
"pos": 7,
"battr": [
3,
6,
7,
8,
9,
10,
14,
17
],
"topframe": 1,
"btype": [
4
],
"api": [
5
],
"ext": {

}
},
"displaymanager": "Fyber",
"displaymanagerver": "7.6.3",
"clickbrowser": 0,
"instl": 1,
"bidfloor": 5.00,
"bidfloorcur": "USD",
"ext":

{ "brsrclk": 1 }
}
],
"app": {
"id": "123456",
"name": "app_Name",
"cat": [
"IAB9-30"
],
"ver": "2.11.4",
"bundle": "123456789",
"privacypolicy": 1,
"paid": 0,
"publisher": {
"id": "555555",
"name": "Pub_name",
"ext": {

}
},
"storeurl": "https://www.apple.com/ios/app-store/storeurlpath",
"ext":

{ "storecat": "Games", "devuserid": "abcd12399", "storesubcat": [ "Family", "Casino", "Entertainment" ], "fmwname": "unity3d" }
},
"device": {
"dnt": 0,
"ua": "Mozilla/5.0 (Linux; Android 8.1.0; LM-X220 Build/OPM1.171019.026; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/77.0.3865.73 Mobile Safari/537.36",
"ip": "66.87.112.254",
"lmt": 0,
"geo": {
"lat": 47.2565,
"lon": -122.4421,
"country": "USA",
"ipservice": 3,
"region": "WA",
"city": "Tacoma",
"zip": "10001",
"type": 2,
"ext": {

}
},
"carrier": "Pelephone",
"language": "en",
"make": "LG",
"model": "LM-X220",
"os": "iOS",
"osv": "13.6",
"utcoffset": 60,
"hwv": "iPhone 7",
"w": 375,
"h": 667,
"js": 1,
"connectiontype": 2,
"devicetype": 4,
"ifa": "99999999999999",
"ext":

{ "ifv": "D3E2CBC2-77E3-4897-BD21-1F31FCCC31D5", "inputLanguage": [ "en", "he" ], "diskspace": 9610, "totaldisk": 30507, "headset": 0, "charging": 0, "batterylevel": 5, "bluetooth": 1, "batterysaver": 1 }
},
"user": {
"gender": "M",
"yob": 1986,
"ext":

{ "consent": "0", "sessionduration": 4, "lastbundle": "123456789", "impdepth": 1, "lastadomain": "youketo.co" }
},
"source": {
"fd": 0,
"tid": "5095199115478323907",
"ext": {
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [

{ "asi": "fyber.com", "sid": "553", "hp": 1, "rid": "5095199115478323907" }
]
}
}
},
"regs": {
"coppa": 0,
"ext":

{ "gdpr": 0, "us_privacy": "1YYY" }
},
"at": 2,
"cur": [
"USD"
],
"tmax": 350,
"bcat": [
"IAB7-28",
"IAB7-42",
"IAB17-18",
"IAB25-1",
"IAB25-2",
"IAB25-3",
"IAB25-4",
"IAB25-5",
"IAB26",
"IAB26-1",
"IAB26-2",
"IAB26-3",
"IAB26-4",
"IAB9-9"
],
"badv": [

],
"ext": {

}
}

SKAdNetwork

Sample Bid Request
{
   "id":"123456789123456789",
   "imp":[
      {
         "id":"1",
         "secure":0,
         "tagid":"630391",
         "banner":{
            "id":"1",
            "w":300,
            "h":250,
            "pos":4,
            "battr":[
               3,
               6,
               7,
               9,
               10,
               14,
               17
            ],
            "topframe":1,
            "btype":[
               4
            ],
            "api":[
               5
            ],
            "ext":
{                            }
         },
         "displaymanager":"Fyber",
         "displaymanagerver":"7.7.0.0",
         "clickbrowser":0,
         "instl":0,
         "bidfloor":5.00,
         "bidfloorcur":"USD",
         "ext":{
            "brsrclk":1,
            "skadn":
{                "version":"2.0",                "sourceapp":"123456789",                "skadnetids":[                   "9G2AGGBJ52.skadnetwork"                ]             }
         }
      }
   ],
   "app":{
      "id":"630391",
      "name":"AppName",
      "cat":[
         "IAB9-30",
         "IAB9-7",
         "IAB9"
      ],
      "ver":"7.7.0",
      "bundle":"123456789",
      "privacypolicy":1,
      "paid":0,
      "publisher":{
         "id":"553",
         "name":"Pub_Name",
         "ext":
{                      }
      },
      "storeurl":"https:\/\/apps.apple.com\/us\/app\/bundle\/id123456789?uo=4&at=10l9yE",
      "ext":{          "storecat":"Games",          "storesubcat":[             "Entertainment",             "Casino",             "Card"          ],          "fmwname":"native"       }
   },
   "device":{
      "dnt":0,
      "ua":"Mozilla\/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X) AppleWebKit\/602.1.38 (KHTML, like Gecko) Version\/10.0 Mobile\/14A41DS1497c Safari\/602.1\\n
n",
      "ip":"66.87.112.254",
      "lmt":0,
      "geo":{
         "lat":47.2565,
         "lon":-122.4421,
         "country":"USA",
         "ipservice":3,
         "region":"WA",
         "city":"Tacoma",
         "zip":"90210",
         "type":2,
         "ext":{                      }
      },
      "carrier":"Sprint PCS",
      "language":"en",
      "make":"Apple",
      "model":"iPhone",
      "os":"iOS",
      "osv":"14.0",
      "utcoffset":180,
      "hwv":"iPad Pro ",
      "w":768,
      "h":1024,
      "js":1,
      "connectiontype":2,
      "devicetype":4,
      "ifa":"A4C7C5E5-XXXX-XXXX-XXXX-8882C2AA021E",
      "ext":
{          "ifv":"4CE89767-XXXX-XXXX-XXXX-4496FBEACD33",          "inputLanguage":[             "en",             "he"          ],          "diskspace":20162,          "totaldisk":30512,          "headset":0,          "charging":0,          "batterylevel":6,          "darkmode":1,          "batterysaver":0,          "atts":3       }
   },
   "user":{
      "gender":"M",
      "yob":1986,
      "ext":
{          "consent":"",          "sessionduration":1836,          "lastbundle":"123456789",          "lastadomain":"fyber.com"       }
   },
   "source":{
      "fd":0,
      "tid":"8629012345678975960",
      "ext":{
         "schain":{
            "ver":"1.0",
            "complete":1,
            "nodes":[         

{                   "asi":"fyber.com",                   "sid":"553",                   "hp":1,                   "rid":"8629067414281675960"                }
            ]
         }
      }
   },
   "regs":{
      "coppa":0,
      "ext":
{          "gdpr":0,          "us_privacy":"1YYY"       }
   },
   "at":2,
   "cur":[
      "USD"
   ],
   "tmax":350,
   "bcat":[
      "IAB7-28",
      "IAB7-42",
      "IAB17-18",
      "IAB25-1",
      "IAB25-2",
      "IAB25-3",
      "IAB25-4",
      "IAB25-5",
      "IAB26",
      "IAB26-1",
      "IAB26-2",
      "IAB26-3",
      "IAB26-4",
      "IAB9-9"
   ],
   "badv":[

     

   ],
   "ext":
{          }
}
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request