Bid Request JSON Examples¶
In App Example¶
{
"regs": {
"coppa": 0
},
"id": "4ecfe2ab-c275-48fb-8c0b-c7103579eaa0",
"source": {
"fd": 1,
"ext": {
"schain": {
"complete": 0,
"ver": "1.0",
"nodes": [
{
"asi": "reseller.com",
"sid": "aaaaa",
"rid": "BidRequest4",
"hp": 1
}
]
}
}
},
"app": {
"id": "adaptv_",
"publisher": {
"name": "",
"id": "adaptv_11690"
},
"storeurl": "https://play.google.com/store/apps/details?id=com.zynga.looney",
"bundle": "com.zynga.looney",
"cat": [
"IAB1"
],
"name": "looney tunes dash!"
},
"wseat": [
"68"
],
"user": {
"id": "dfc68ac9-9530-44b0-bdea-44cf153d7cea",
"ext": {
"ug": 1
}
},
"device": {
"dpidsha1": "0d7e6f65e1db717f0ed298bd268cc6415fa72124",
"language": "en",
"mccmnc": "310-005",
"geo": {
"country": "US",
"lon": -78.83,
"city": "Hamburg",
"lat": 42.71,
"zip": "14075",
"region": "NY",
"type": 2
},
"ifa": "dfc68ac9-9530-44b0-bdea-44cf153d7cea",
"lmt": 0,
"os": "android",
"devicetype": 4,
"ip": "72.88.84.159",
"ua": "Mozilla/5.0 (Linux; Android 6.0.1; SM-G920P Build/MMB29K; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/51.0.2704.81 Mobile Safari/537.36",
"dpidmd5": "c65cf7c5bffe94c62cf20c5e465d92f7"
},
"tmax": 120,
"cur": [
"USD"
],
"imp": [
{
"bidfloor": 0.02268,
"metric": [
{
"type": "viewability",
"value": 0.85
}
],
"id": "1",
"instl": 0,
"exp": 300,
"bidfloorcur": "USD",
"ext": {},
"secure": 0,
"video": {
"protocols": [
2,
5
],
"placement": 2,
"playbackend": 1,
"minduration": 5,
"playbackmethod": [
1
],
"maxduration": 30,
"startdelay": 0,
"linearity": 1,
"mimes": [
"video/mp4"
]
}
}
],
"bcat": [
"IAB25-3",
"BSW1",
"BSW2",
"BSW10",
"BSW4",
"IAB26"
],
"ext": {
"is_secure": 0,
"wt": 1,
"clktrkrq": 0,
"ssp": "adaptv",
"media_src": "adaptv"
},
"at": 2
}
In App iOS 14¶
Note
See the highlighted lines that denote the iOS 14 fields, see the Protocol Release Notes for more details.
{
"regs": {
"ext": {
"gdpr": 0,
"us_privacy": "1YN-"
}
},
"id": "4ecfe2ab-c275-48fb-8c0b-c7103579eaa0",
"source": {
"fd": 1,
"ext": {
"schain": {
"complete": 0,
"ver": "1.0",
"nodes": [
{
"asi": "reseller.com",
"sid": "aaaaa",
"rid": "BidRequest4",
"hp": 1
}
]
}
}
},
"app": {
"id": "adaptv_",
"publisher": {
"name": "Fyber",
"id": "pubnative_1007055"
},
"storeurl": "https://apps.apple.com/us/app/wordscapes/id1207472156",
"bundle": "1207472156",
"cat": [
"IAB1"
],
"name": "Wordscapes"
},
"wseat": [
"68"
],
"user": {
"ext": {
"impdepth": 2,
"sessionduration": 45
}
},
"device": {
"dpidsha1": "0d7e6f65e1db717f0ed298bd268cc6415fa72124",
"language": "en",
"mccmnc": "310-005",
"geo": {
"country": "US",
"lon": -78.83,
"city": "Hamburg",
"lat": 42.71,
"zip": "14075",
"region": "NY",
"type": 2
},
"ifa": "00000000-0000-0000-0000-000000000000",
"ext": {
"idfv": "1F277D46-12BF-482A-9085-B4F811DD6E4D"
},
"lmt": 1,
"os": "ios",
"devicetype": 4,
"ip": "72.88.84.159",
"ua": "Mozilla/5.0 (Linux; Android 6.0.1; SM-G920P Build/MMB29K; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/51.0.2704.81 Mobile Safari/537.36"
},
"tmax": 120,
"cur": [
"USD"
],
"imp": [
{
"bidfloor": 0.02268,
"metric": [
{
"type": "viewability",
"value": 0.85
}
],
"id": "1",
"secure": 0,
"video": {
"protocols": [
2,
5
],
"placement": 2,
"playbackend": 1,
"minduration": 5,
"playbackmethod": [
1
],
"maxduration": 30,
"startdelay": 0,
"linearity": 1,
"mimes": [
"video/mp4"
]
},
"instl": 0,
"exp": 300,
"bidfloorcur": "USD",
"ext": {
"skadn": {
"version": "4.0",
"sourceapp": "90987654321",
"skadnetids": [
"abc123.skadnetwork",
"def234.skadnetwork"
],
"productpage": 1
}
}
}
],
"bcat": [
"IAB25-3",
"BSW1",
"BSW2",
"BSW10",
"BSW4",
"IAB26"
],
"ext": {
"wt": 1,
"clktrkrq": 0,
"is_secure": 0,
"ssp": "gumgum",
"media_src": "gumgum",
"tgroup": [
123,
456,
321,
765
],
"ads_txt": {
"status": 2,
"auth_id": "1kjgh7653",
"pub_id": "537120563",
"supplier_domain": "example.com"
}
},
"at": 2
}
Native Ad¶
{
"id": "129ca6dd-5403-4476-a4a6-555d6a538bc4",
"app": {
"id": "pubnative_1009429",
"publisher": {
"name": "",
"id": "pubnative_1005292"
},
"storeurl": "https://play.google.com/store/apps/details?id=com.leo.appmaster",
"bundle": "com.leo.appmaster",
"cat": [
"IAB3"
],
"name": "PG_lock_pic"
},
"wseat": [
"167"
],
"source": {
"fd": 0
},
"user": {
"id": "45asdf987656789adfad4678rew656789",
"buyeruid": "1234567890",
"keywords": "sports, entertainment",
"yob": 1976,
"gender": "F",
"ext": {
"ug": 1,
"cookie_age": 15,
"consent": "Y29uc2VudCBkYXRh",
"consented_providers_settings": {
"consented_providers": [
1791
]
},
"eids": [
{
"source": "adserver.org",
"uids": [
{
"id": "zzz",
"atype": 1
},
{
"id": "DB700403-9A24-4A4B-A8D5-8A0B4BE777D2",
"atype": 2
}
]
},
{
"source": "liveintent.com",
"uids": [
{
"id": "IPl4zj44RhezVyNE83bYfogYRN6W8LaCy3USy8dPQ==",
"atype": 3
}
]
},
{
"source": "liveramp.com",
"uids": [
{
"id": "0db20294a3908612bc7e732c2022095391074cf3"
}
]
}
]
}
},
"device": {
"connectiontype": 3,
"model": "Micromax A096",
"mccmnc": "310-005",
"language": "en",
"geo": {
"country": "IN",
"lon": 85.1167,
"city": "Patna",
"lat": 25.6,
"zip": "800002",
"region": "34",
"type": 2
},
"ifa": "793ff4b0-d077-4002-aeb6-b8ea64dd4b2b",
"osv": "5.0.2",
"os": "Android",
"carrier": "Airtel",
"devicetype": 1,
"ip": "223.176.12.242",
"ua": "Dalvik/2.1.0 (Linux; U; Android 5.0.2; Micromax A096 Build/LRX21M)",
"dnt": 1
},
"tmax": 80,
"cur": [
"USD"
],
"imp": [
{
"bidfloor": 0.324,
"id": "1",
"native": {
"request": {
"plcmtcnt": 1,
"plcmttype": 2,
"privacy": 1,
"context": 1,
"contextsubtype": 12,
"assets": [
{
"id": 1,
"data": {
"type": 12
},
"required": 1
},
{
"title": {
"len": 50
},
"id": 2,
"required": 1
},
{
"id": 3,
"img": {
"w": 80,
"h": 80,
"type": 1
},
"required": 1
},
{
"id": 4,
"img": {
"w": 1200,
"h": 627,
"type": 3
},
"required": 1
},
{
"data": {
"type": 3
},
"id": 5,
"required": 0
},
{
"id": 6,
"data": {
"len": 100,
"type": 2
},
"required": 1
}
],
"ver": "1.2"
}
},
"exp": 1800,
"bidfloorcur": "USD",
"ext": {},
"instl": 0
}
],
"bcat": [
"IAB25-3",
"BSW1",
"BSW2",
"BSW10",
"BSW4",
"IAB26"
],
"ext": {
"wt": 112,
"clktrkrq": 0,
"is_secure": 0,
"ssp": "pubnative",
"tgroup": [
123,
456,
321,
765
],
"ads_txt": {
"status": 2,
"auth_id": "1kjgh7653",
"pub_id": "537120563",
"supplier_domain": "example.com"
}
},
"at": 2
}
Private Deal Example¶
{
"id": "500da108-85f8-44af-ac98-d7adcf9e0daf",
"site": {
"id": "spotx_SpotX_www.businessinsider.com",
"publisher": {
"name": "",
"id": "spotx_84548"
},
"domain": "businessinsider.com",
"page": "https://www.businessinsider.com/japanese-potato-changed-olivia-munns-appearance-2016-2"
},
"wseat": [
"145"
],
"user": {
"id": "45asdf987656789adfad4678rew656789",
"buyeruid": "1234567890",
"keywords": "sports, entertainment",
"yob": 1976,
"gender": "F",
"ext": {
"ug": 1,
"cookie_age": 15,
"consent": "Y29uc2VudCBkYXRh",
"consented_providers_settings": {
"consented_providers": [
1791
]
},
"eids": [
{
"source": "adserver.org",
"uids": [
{
"id": "zzz",
"atype": 1
},
{
"id": "DB700403-9A24-4A4B-A8D5-8A0B4BE777D2",
"atype": 2
}
]
},
{
"source": "liveintent.com",
"uids": [
{
"id": "IPl4zj44RhezVyNE83bYfogYRN6W8LaCy3USy8dPQ==",
"atype": 3
}
]
},
{
"source": "liveramp.com",
"uids": [
{
"id": "0db20294a3908612bc7e732c2022095391074cf3"
}
]
}
]
}
},
"device": {
"model": "Chrome - Windows",
"mccmnc": "310-005",
"language": "en",
"geo": {
"country": "US",
"city": "Jackson Heights",
"region": "NY",
"zip": "11372"
},
"make": "Google",
"osv": "NT 6.1",
"os": "Windows 7",
"devicetype": 2,
"ip": "98.14.26.33",
"ua": "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2342.0 Safari/537.36",
"dnt": 0
},
"tmax": 415,
"cur": [
"USD"
],
"imp": [
{
"bidfloor": 0.011232,
"metric": [
{
"type": "viewability",
"value": 0.85
}
],
"id": "1",
"pmp": {
"private_auction": 1,
"deals": [
{
"bidfloor": 10.8,
"id": "14a44.a7993.d401",
"bidfloorcur": "USD",
"at": 2
}
]
},
"instl": 0,
"exp": 300,
"tagid": "spotx_http://search.spotxchange.com/vast/2.00/149110?VPAID=1&content_type=game&vmaxd=30&player_width=640&player_height=480&content_page_url=http%3A%2F%2Fwww.businessinsider.com%2Fjapanese-potato-changed-olivia-munns-appearance-2016-2&cb=1468903661330&adtid=T6GDD32DDC8UD5OOS5I6QROV40&viewability=0",
"bidfloorcur": "USD",
"secure": 0,
"video": {
"protocols": [
2,
5
],
"companiontype": [
1,
2,
3
],
"placement": 2,
"playbackend": 1,
"minduration": 1,
"maxduration": 60,
"startdelay": 0,
"api": [
1
],
"linearity": 1,
"h": 480,
"delivery": [
2
],
"ext": {
"player_type": 3
},
"mimes": [
"video/x-flv",
"video/mp4",
"application/x-shockwave-flash"
],
"w": 640,
"companionad": [
{
"h": 250,
"id": "1",
"w": 300,
"btype": [
4,
21
]
}
]
}
}
],
"bcat": [
"IAB25-3",
"BSW1",
"BSW2",
"BSW10",
"BSW4",
"IAB26"
],
"ext": {
"is_secure": 0,
"wt": 1,
"clktrkrq": 0,
"ssp": "spotx",
"media_src": "spotx"
},
"at": 2
}
Video Example¶
{
"regs": {
"coppa": 0,
"ext": {
"gdpr": 1
}
},
"id": "75c0238c-3b52-4b87-957a-817f83e853f1",
"site": {
"id": "adaptv_",
"publisher": {
"name": "",
"id": "adaptv_4182"
},
"cat": [
"IAB1"
],
"page": "http://kissasian.com"
},
"wseat": [
"126"
],
"source": {
"fd": 1,
"ext": {
"schain": {
"complete": 0,
"ver": "1.0",
"nodes": [
{
"asi": "reseller.com",
"sid": "aaaaa",
"rid": "BidRequest4",
"hp": 1
}
]
}
}
},
"user": {
"id": "45asdf987656789adfad4678rew656789",
"buyeruid": "1234567890",
"keywords": "sports, entertainment",
"yob": 1976,
"gender": "F",
"ext": {
"ug": 1,
"cookie_age": 15,
"consent": "Y29uc2VudCBkYXRh",
"consented_providers_settings": {
"consented_providers": [
1791
]
},
"eids": [
{
"source": "adserver.org",
"uids": [
{
"id": "zzz",
"atype": 1
},
{
"id": "DB700403-9A24-4A4B-A8D5-8A0B4BE777D2",
"atype": 2
}
]
},
{
"source": "liveintent.com",
"uids": [
{
"id": "IPl4zj44RhezVyNE83bYfogYRN6W8LaCy3USy8dPQ==",
"atype": 3
}
]
},
{
"source": "liveramp.com",
"uids": [
{
"id": "0db20294a3908612bc7e732c2022095391074cf3"
}
]
}
]
}
},
"device": {
"language": "en",
"mccmnc": "310-005",
"geo": {
"country": "US",
"lon": -75.15,
"city": "Philadelphia",
"lat": 39.94,
"zip": "19147",
"region": "PA",
"type": 2
},
"lmt": 0,
"os": "Other",
"devicetype": 6,
"ip": "73.141.79.240",
"ua": "Mozilla/5.0 (PlayStation 4 3.55) AppleWebKit/537.78 (KHTML, like Gecko)"
},
"tmax": 120,
"cur": [
"USD"
],
"imp": [
{
"bidfloor": 0.02268,
"id": "1",
"instl": 0,
"exp": 300,
"bidfloorcur": "USD",
"ext": {},
"secure": 0,
"video": {
"protocols": [
2,
5
],
"placement": 2,
"skip": 1,
"playbackend": 1,
"minduration": 5,
"playbackmethod": [
3
],
"maxduration": 60,
"startdelay": 0,
"linearity": 1,
"mimes": [
"video/mp4"
]
}
}
],
"bcat": [
"IAB25-3",
"BSW1",
"BSW2",
"BSW10",
"BSW4",
"IAB26"
],
"ext": {
"wt": 1,
"clktrkrq": 0,
"is_secure": 0,
"ssp": "adaptv",
"media_src": "adaptv",
"s2s_nurl": 1
},
"at": 2
}
Audio Ad Example¶
{
"id": "1234534625253",
"wseat": [
"58"
],
"source": {
"fd": 1,
"ext": {
"schain": {
"complete": 0,
"ver": "1.0",
"nodes": [
{
"asi": "reseller.com",
"sid": "aaaaa",
"rid": "BidRequest4",
"hp": 1
}
]
}
}
},
"imp": [
{
"id": "1",
"secure": 1,
"audio": {
"startdelay": 0,
"minduration": 5,
"maxduration": 30,
"maxextended": 30,
"minbitrate": 300,
"maxbitrate": 1500,
"api": [
1,
2
],
"protocols": [
9,
10
],
"mimes": [
"audio/aac",
"audio/mp4",
"audio/mpeg"
],
"delivery": [
2
],
"battr": [
13,
14
],
"companionad": [
{
"id": "1234567893-1",
"w": 300,
"h": 250,
"pos": 1,
"btype": [
4,
21
],
"battr": [
13,
14
],
"expdir": [
2,
4
]
},
{
"id": "1234567893-2",
"w": 728,
"h": 90,
"pos": 1,
"battr": [
13,
14
]
}
],
"companiontype": [
1,
2
]
}
}
],
"site": {
"id": "google_234563",
"domain": "siteabcd.com",
"page": "https://siteabcd.com/page.htm",
"ref": "http://google.com/?q=siteabcd",
"publisher": {
"id": "google_25"
}
},
"device": {
"ip": "64.124.253.1",
"mccmnc": "310-005",
"geo": {
"country": "US",
"region": "NY",
"city": "White Plains",
"zip": "10601"
},
"ua": "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv:1.9.2.16) Gecko/20110319 Firefox/3.6.16",
"language": "en"
},
"ext": {
"wt": 1,
"clktrkrq": 0,
"is_secure": 0,
"ssp": "gumgum",
"media_src": "gumgum",
"tgroup": [
123,
456,
321,
765
],
"ads_txt": {
"status": 2,
"auth_id": "1kjgh7653",
"pub_id": "537120563",
"supplier_domain": "example.com"
}
},
"user": {
"id": "45asdf987656789adfad4678rew656789",
"buyeruid": "1234567890",
"keywords": "sports, entertainment",
"yob": 1976,
"gender": "F",
"tmax": 120,
"ext": {
"ug": 1,
"cookie_age": 15,
"consent": "Y29uc2VudCBkYXRh",
"consented_providers_settings": {
"consented_providers": [
1791
]
},
"eids": [
{
"source": "adserver.org",
"uids": [
{
"id": "zzz",
"atype": 1
},
{
"id": "DB700403-9A24-4A4B-A8D5-8A0B4BE777D2",
"atype": 2
}
]
},
{
"source": "liveintent.com",
"uids": [
{
"id": "IPl4zj44RhezVyNE83bYfogYRN6W8LaCy3USy8dPQ==",
"atype": 3
}
]
},
{
"source": "liveramp.com",
"uids": [
{
"id": "0db20294a3908612bc7e732c2022095391074cf3"
}
]
}
]
}
},
"regs": {
"ext": {
"gdpr": 0,
"us_privacy": "1YN-"
}
},
"cur": [
"USD"
]
}
TV Ad Example¶
{
"id": "1234534625253",
"wseat": [
"58"
],
"imp": [
{
"id": "1",
"bidfloor": 15,
"exp": 360,
"video": {
"mimes": [
"video/x-flv",
"video/mp4",
"application/x-shockwave-flash",
"application/javascript"
],
"placement": 2,
"skip": 0,
"playbackend": 1,
"minduration": 30,
"maxduration": 30,
"protocols": [
3,
6
]
}
}
],
"source": {
"fd": 0
},
"device": {
"geo": {
"country": "US",
"region": "TX"
},
"devicetype": 6
},
"user": {
"id": "45asdf987656789adfad4678rew656789",
"keywords": "A_18_24,COLLEGE,HHI_75_100,M_18_24,HH_SINGLE",
"data": [
{
"name": "program_types",
"segment": [
{
"name": "HOCKEY_DEC",
"value": "8"
},
{
"name": "BASEBALL_DEC",
"value": "9"
},
{
"name": "FOOTBALL_DEC",
"value": "8.1"
}
]
}
]
},
"tmax": 150,
"cur": [
"USD",
"EUR"
],
"ext": {
"ssp": "dish",
"media_src": "dish",
"tv": {
"publisher": {
"id": "dish_"
}
}
}
}
DOOH Ad Example¶
{
"id": "1234534625253",
"wseat": [
"58"
],
"imp": [
{
"id": "06d690d1-bac0-43fa-9257-f6d62d984231",
"bidfloor": 15,
"exp": 360,
"video": {
"mimes": [
"video/x-flv",
"video/mp4"
],
"placement": 2,
"playbackend": 1,
"skip": 0,
"exp": 300,
"minduration": 30,
"maxduration": 30,
"protocols": [
3,
6,
7
],
"w": 640,
"h": 480
},
"pmp": {
"private_auction": 1,
"deals": [
{
"id": "deal-1",
"wseat": [
"58"
],
"bidfloor": 2.5,
"bidfloorcur": "USD",
"at": 3
}
]
}
}
],
"device": {
"ifa": "035911ea467d03b65cf44f5633b",
"mccmnc": "310-005",
"ip": "64.124.253.1",
"geo": {
"lat": 35.012344,
"lon": -115.12345,
"country": "US",
"region": "NY",
"city": "White Plains",
"zip": "10601"
},
"devicetype": 6
},
"user": {
"id": "45asdf987656789adfad4678rew656789",
"data": [
{
"id": "6",
"name": "Data Provider 1",
"segment": [
{
"name": "M",
"value": "15"
},
{
"name": "F",
"value": "9"
},
{
"name": "M65+",
"value": "8.1"
},
{
"name": "TOTAL",
"value": "19.5"
}
]
},
{
"name": "demographic",
"segment": [
{
"id": "12341318394918",
"name": "auto intenders"
}
]
}
]
},
"tmax": 150,
"cur": [
"USD",
"EUR"
],
"source": {
"fd": 0
},
"ext": {
"wt": 1,
"clktrkrq": 0,
"dooh": {
"publisher": {
"id": "rubicon_234563",
"cat": [
"IAB1"
]
},
"audience": 19.5,
"impmultiply": 1
},
"is_secure": 0,
"ssp": "rubicon",
"tgroup": [
123,
456,
321,
765
],
"ads_txt": {
"status": 2,
"auth_id": "1kjgh7653",
"pub_id": "537120563",
"supplier_domain": "example.com"
}
}
}