Welcome to Fyber

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

Sample Bid Requests

Follow

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 

SKAdNetwork

Sample Bid Request
{
	"id": "8629067414281675960",
	"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": "App_Name",
		"cat": ["IAB9-30", "IAB9-7", "IAB9"],
		"ver": "7.7.0",
		"bundle": "123456789",
		"privacypolicy": 1,
		"paid": 0,
		"publisher": {
			"id": "55555",
			"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": "99999999999999XXXX",
		"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": "8629067414281675960",
		"ext": {
			"schain": {
				"ver": "1.0",
				"complete": 1,
				"nodes": [ {
				"asi": "fyber.com",
				"sid": "5555",
				"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": {}
}

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

}
}