Bid Request and Bid Response Examples
Find below the list of bid request and bid response JSON examples for each app mediatype, in OpenRTB 2.5.
Bid Request
{
"id": "60681242-4b80-473c-a395-4743ec6f1696",
"tmax": 1200,
"imp": [
{
"id": "1",
"tagid": "12303405",
"secure": 1,
"banner": {
"api": [
3,
5,
6,
7
],
"format": [
{
"w": 320,
"h": 50
}
]
},
"ext": {
"gpid": "/4145/fnc/desk/art/sports/ban1"
},
"metric": [
{
"type": "viewability",
"value": 0.85
}
]
}
],
"app": {
"name": "My App",
"bundle": "org.mobile.myapp",
"cat": [
"IAB9",
"IAB9-30",
"IAB1",
"IAB19",
"IAB3"
],
"paid": 0,
"privacypolicy": 1,
"storeurl": "https://play.google.com/store/apps/details?id=org.mobile.myapp",
"ver": "1.0.0",
"publisher": {
"id": "1000"
},
"ext": {
"pagetype": "topic",
"category": "home"
}
},
"device": {
"ifa": "469203a9-7bf5-4827-ad7b-29e00af35f32",
"ext": {
"ifa_type": "dpid"
},
"ua": "Mozilla\/5.0 (Linux; Android 15; sdk_gphone64_arm64 Build\/AE3A.240806.036; wv) AppleWebKit\/537.36 (KHTML, like Gecko) Version\/4.0 Chrome\/124.0.6367.219 Mobile Safari\/537.36",
"lmt": 0,
"dnt": 0,
"geo": {
"lat": 42.71,
"lon": -78.83,
"type": 1,
"country": "USA",
"region": "NY",
"metro": "716",
"city": "Hamburg",
"zip": 14075
},
"devicetype": 4,
"ip": "1.1.1.1",
"make": "Google",
"model": "sdk_gphone64_arm64",
"os": "Android",
"osv": "15",
"hwv": "Google sdk_gphone64_arm64",
"language": "en",
"carrier": "T-Mobile",
"mccmnc": "310-260",
"h": 2400,
"w": 1080,
"connectiontype": 2,
"pxratio": 2.625
},
"regs": {
"ext": {
"gdpr": 1
}
},
"user": {
"consent": "CO9boCtO9boCtAJAEBENBBCsAP_AAH_AACiQHGtd_X_fb39j-_59_9t0eY1f9_7_v20zjgeds-8Nyd_X_L8X42M7vB36pq4KuR4Eu3LBAQFlHOHcTUmw6IkVqTPsak2Mr7NKJ7PEinMbe2dYGHtfn9VTuZKYr97s___z__-__v__79f_r-3_3_vp9V---2BxIBJhqXwEWYljgSTRpVCiBCFcSHQAgAooRhaJrCAlcFOyuAj9BAwAQGoCMCIEGIKMWQQAAAABJREBIAeCARAEQCAAEAKkBCAAjQBBYASBgEAAoBoWAEUAQgSEGRwVHKYEBEi0UE8lYAlF3sYYQhlFADQIAAAA.f_gAD_gAAAAA"
},
"source": {
"tid": "60681242-4b80-473c-a395-4743ec6f1696",
"ext": {
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [
{
"asi": "advertising-sys.com",
"sid": "99999",
"hp": 1
}
]
}
}
}
}{
"id": "685e1fff-5d45-4d74-8e6e-9163dcca628a",
"tmax": 1200,
"imp": [
{
"id": "1",
"tagid": "12309905",
"video": {
"mimes": [
"video\/mp4",
"video\/3gpp",
"video\/webm",
"video\/mkv"
],
"playbackend": 2,
"protocols": [
2,
5
],
"w": 300,
"h": 250,
"linearity": 1,
"placement": 2,
"delivery": [
3
]
},
"metric": [
{
"type": "viewability",
"value": 0.85
}
],
"ext": {
"gpid": "/4145/fnc/desk/art/sports/vid1"
}
}
],
"app": {
"name": "My App",
"bundle": "org.mobile.myapp",
"cat": [
"IAB9",
"IAB9-30",
"IAB1",
"IAB19",
"IAB3"
],
"paid": 0,
"privacypolicy": 1,
"storeurl": "https://play.google.com/store/apps/details?id=org.mobile.myapp",
"ver": "1.0.0",
"publisher": {
"id": "1000"
},
"ext": {
"pagetype": "topic",
"category": "home"
}
},
"device": {
"ifa": "469203a9-7bf5-4827-ad7b-29e00af35f32",
"ext": {
"ifa_type": "dpid"
},
"ua": "Mozilla\/5.0 (Linux; Android 15; sdk_gphone64_arm64 Build\/AE3A.240806.036; wv) AppleWebKit\/537.36 (KHTML, like Gecko) Version\/4.0 Chrome\/124.0.6367.219 Mobile Safari\/537.36",
"lmt": 0,
"dnt": 0,
"geo": {
"lat": 42.71,
"lon": -78.83,
"type": 1,
"country": "USA",
"region": "NY",
"metro": "716",
"city": "Hamburg",
"zip": 14075
},
"devicetype": 4,
"ip": "1.1.1.1",
"make": "Google",
"model": "sdk_gphone64_arm64",
"os": "Android",
"osv": "15",
"hwv": "Google sdk_gphone64_arm64",
"language": "en",
"carrier": "T-Mobile",
"mccmnc": "310-260",
"h": 2400,
"w": 1080,
"connectiontype": 2,
"pxratio": 2.625
},
"regs": {
"ext": {
"gdpr": 1
}
},
"user": {
"consent": "CO9boCtO9boCtAJAEBENBBCsAP_AAH_AACiQHGtd_X_fb39j-_59_9t0eY1f9_7_v20zjgeds-8Nyd_X_L8X42M7vB36pq4KuR4Eu3LBAQFlHOHcTUmw6IkVqTPsak2Mr7NKJ7PEinMbe2dYGHtfn9VTuZKYr97s___z__-__v__79f_r-3_3_vp9V---2BxIBJhqXwEWYljgSTRpVCiBCFcSHQAgAooRhaJrCAlcFOyuAj9BAwAQGoCMCIEGIKMWQQAAAABJREBIAeCARAEQCAAEAKkBCAAjQBBYASBgEAAoBoWAEUAQgSEGRwVHKYEBEi0UE8lYAlF3sYYQhlFADQIAAAA.f_gAD_gAAAAA",
"buyeruid": "va:GII73KIK-4IGG-8185-HJIH-59K1J01JGHK0:64497"
},
"source": {
"tid": "685e1fff-5d45-4d74-8e6e-9163dcca628a",
"ext": {
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [
{
"asi": "advertising-sys.com",
"sid": "99999",
"hp": 1
}
]
}
}
},
"ext": {}
}{
"id": "f20ef65c-be19-4c3a-b44f-52ff22451b42",
"tmax": 1200,
"imp": [
{
"id": "1",
"tagid": "12993405",
"instl": 0,
"clickbrowser": 0,
"secure": 1,
"native": {
"request": "{\"ver\":\"1.2\",\"context\":2,\"contextsubtype\":20,\"plcmttype\":1,\"seq\":0,\"assets\":[{\"required\":1,\"title\":{\"len\":90}},{\"required\":1,\"img\":{\"type\":1,\"w\":20,\"wmin\":20,\"h\":20,\"hmin\":20}},{\"required\":1,\"img\":{\"type\":3,\"w\":200,\"wmin\":200,\"h\":200,\"hmin\":200}},{\"required\":1,\"data\":{\"type\":1,\"len\":90}},{\"required\":1,\"data\":{\"type\":2,\"len\":-1}},{\"required\":1,\"data\":{\"type\":12,\"len\":-1}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1,2]}]}",
"ver": "1.2"
},
"metric": [
{
"type": "viewability",
"value": 0.85
}
],
"ext": {
"gpid": "/4145/fnc/desk/art/sports/nat1"
}
}
],
"app": {
"name": "My App",
"bundle": "org.mobile.myapp",
"cat": [
"IAB9",
"IAB9-30",
"IAB1",
"IAB19",
"IAB3"
],
"paid": 0,
"privacypolicy": 1,
"storeurl": "https://play.google.com/store/apps/details?id=org.mobile.myapp",
"ver": "1.0.0",
"publisher": {
"id": "1000"
},
"ext": {
"pagetype": "topic",
"category": "home"
}
},
"device": {
"ifa": "469203a9-7bf5-4827-ad7b-29e00af35f32",
"ext": {
"ifa_type": "dpid"
},
"ua": "Mozilla\/5.0 (Linux; Android 15; sdk_gphone64_arm64 Build\/AE3A.240806.036; wv) AppleWebKit\/537.36 (KHTML, like Gecko) Version\/4.0 Chrome\/124.0.6367.219 Mobile Safari\/537.36",
"lmt": 0,
"dnt": 0,
"geo": {
"lat": 42.71,
"lon": -78.83,
"type": 1,
"country": "USA",
"region": "NY",
"metro": "716",
"city": "Hamburg",
"zip": 14075
},
"devicetype": 4,
"ip": "1.1.1.1",
"make": "Google",
"model": "sdk_gphone64_arm64",
"os": "Android",
"osv": "15",
"hwv": "Google sdk_gphone64_arm64",
"language": "en",
"carrier": "T-Mobile",
"mccmnc": "310-260",
"h": 2400,
"w": 1080,
"connectiontype": 2,
"pxratio": 2.625
},
"regs": {
"ext": {
"gdpr": 1
}
},
"user": {
"consent": "CO9boCtO9boCtAJAEBENBBCsAP_AAH_AACiQHGtd_X_fb39j-_59_9t0eY1f9_7_v20zjgeds-8Nyd_X_L8X42M7vB36pq4KuR4Eu3LBAQFlHOHcTUmw6IkVqTPsak2Mr7NKJ7PEinMbe2dYGHtfn9VTuZKYr97s___z__-__v__79f_r-3_3_vp9V---2BxIBJhqXwEWYljgSTRpVCiBCFcSHQAgAooRhaJrCAlcFOyuAj9BAwAQGoCMCIEGIKMWQQAAAABJREBIAeCARAEQCAAEAKkBCAAjQBBYASBgEAAoBoWAEUAQgSEGRwVHKYEBEi0UE8lYAlF3sYYQhlFADQIAAAA.f_gAD_gAAAAA"
},
"source": {
"tid": "f20ef65c-be19-4c3a-b44f-52ff22451b42",
"ext": {
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [
{
"asi": "advertising-sys.com",
"sid": "99999",
"hp": 1
}
]
}
}
},
"ext": {}
}{
"id": "73b10f06-fb28-4bb4-8b8d-a083f4d8d72b",
"tmax": 1200,
"imp": [
{
"id": "1",
"tagid": "12303405",
"secure": 1,
"banner": {
"api": [
3,
5,
6,
7
],
"format": [
{
"w": 320,
"h": 50
}
]
},
"video": {
"mimes": [
"video\/mp4",
"video\/3gpp",
"video\/webm",
"video\/mkv"
],
"playbackend": 2,
"protocols": [
2,
5
],
"w": 300,
"h": 250,
"linearity": 1,
"placement": 2,
"delivery": [
3
]
},
"metric": [
{
"type": "viewability",
"value": 0.85
}
],
"ext": {
"gpid": "/4145/fnc/desk/art/sports/ban1"
}
}
],
"app": {
"name": "My App",
"bundle": "org.mobile.myapp",
"cat": [
"IAB9",
"IAB9-30",
"IAB1",
"IAB19",
"IAB3"
],
"paid": 0,
"privacypolicy": 1,
"storeurl": "https://play.google.com/store/apps/details?id=org.mobile.myapp",
"ver": "1.0.0",
"publisher": {
"id": "1000"
},
"ext": {
"pagetype": "topic",
"category": "home"
}
},
"device": {
"ifa": "469203a9-7bf5-4827-ad7b-29e00af35f32",
"ext": {
"ifa_type": "dpid"
},
"ua": "Mozilla\/5.0 (Linux; Android 15; sdk_gphone64_arm64 Build\/AE3A.240806.036; wv) AppleWebKit\/537.36 (KHTML, like Gecko) Version\/4.0 Chrome\/124.0.6367.219 Mobile Safari\/537.36",
"lmt": 0,
"dnt": 0,
"geo": {
"lat": 42.71,
"lon": -78.83,
"type": 1,
"country": "USA",
"region": "NY",
"metro": "716",
"city": "Hamburg",
"zip": 14075
},
"devicetype": 4,
"ip": "1.1.1.1",
"make": "Google",
"model": "sdk_gphone64_arm64",
"os": "Android",
"osv": "15",
"hwv": "Google sdk_gphone64_arm64",
"language": "en",
"carrier": "T-Mobile",
"mccmnc": "310-260",
"h": 2400,
"w": 1080,
"connectiontype": 2,
"pxratio": 2.625
},
"regs": {
"ext": {
"gdpr": 1
}
},
"user": {
"consent": "CO9boCtO9boCtAJAEBENBBCsAP_AAH_AACiQHGtd_X_fb39j-_59_9t0eY1f9_7_v20zjgeds-8Nyd_X_L8X42M7vB36pq4KuR4Eu3LBAQFlHOHcTUmw6IkVqTPsak2Mr7NKJ7PEinMbe2dYGHtfn9VTuZKYr97s___z__-__v__79f_r-3_3_vp9V---2BxIBJhqXwEWYljgSTRpVCiBCFcSHQAgAooRhaJrCAlcFOyuAj9BAwAQGoCMCIEGIKMWQQAAAABJREBIAeCARAEQCAAEAKkBCAAjQBBYASBgEAAoBoWAEUAQgSEGRwVHKYEBEi0UE8lYAlF3sYYQhlFADQIAAAA.f_gAD_gAAAAA"
},
"source": {
"tid": "73b10f06-fb28-4bb4-8b8d-a083f4d8d72b",
"ext": {
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [
{
"asi": "advertising-sys.com",
"sid": "99999",
"hp": 1
}
]
}
}
}
}Bid Response
{
"id": "60681242-4b80-473c-a395-4743ec6f1696",
"seatbid": [
{
"bid": [
{
"id": "1234567890",
"impid": "1",
"price": 6.1208928,
"adm": "<a href=\"http://myadserver.com/click><img src=\"http://image.com/\"/><img src=\"http://myadserver.com/impression/1.0\"/></a>",
"adomain": [
"www.addomain.com"
],
"crid": "creative111",
"w": 320,
"h": 480,
"mtype": 1
}
],
"seat": "8"
}
],
"statuscode": 0
}{
"id": "685e1fff-5d45-4d74-8e6e-9163dcca628a",
"seatbid": [
{
"bid": [
{
"id": "1234567890",
"impid": "1",
"price": 6.4133128,
"adm": "<VAST version=\"4.2\" xmlns:_xmlns=\"xmlns\" _xmlns:xs=\"http://www.w3.org/2001/XMLSchema\" xmlns=\"http://www.iab.com/VAST\"><Ad id=\"20001\"><InLine><AdSystem version=\"1\"><![CDATA[iabtechlab]]></AdSystem><Error><![CDATA[https://example.com/error]]></Error><Impression id=\"Impression-ID\"><![CDATA[https://example.com/track/impression]]></Impression><AdServingId><![CDATA[a532d16d-4d7f-4440-bd29-2ec05553fc80]]></AdServingId><AdTitle><![CDATA[Inline Simple Ad]]></AdTitle><Advertiser><![CDATA[IAB Sample Company]]></Advertiser><Category authority=\"https://www.iabtechlab.com/categoryauthority\"><![CDATA[AD CONTENT description category]]></Category><Creatives><Creative id=\"5480\" sequence=\"1\" adId=\"2447226\"><Linear><TrackingEvents><Tracking event=\"start\"><![CDATA[https://example.com/tracking/start]]></Tracking><Tracking event=\"progress\" offset=\"00:00:10\"><![CDATA[http://example.com/tracking/progress-10]]></Tracking><Tracking event=\"firstQuartile\"><![CDATA[https://example.com/tracking/firstQuartile]]></Tracking><Tracking event=\"midpoint\"><![CDATA[https://example.com/tracking/midpoint]]></Tracking><Tracking event=\"thirdQuartile\"><![CDATA[https://example.com/tracking/thirdQuartile]]></Tracking><Tracking event=\"complete\"><![CDATA[https://example.com/tracking/complete]]></Tracking></TrackingEvents><Duration><![CDATA[00:00:16]]></Duration><MediaFiles><MediaFile id=\"5241\" delivery=\"progressive\" type=\"video/mp4\" bitrate=\"2000\" width=\"1280\" height=\"720\" minBitrate=\"1500\" maxBitrate=\"2500\" scalable=\"1\" maintainAspectRatio=\"1\" codec=\"H.264\"><![CDATA[ https://storage.googleapis.com/assets.adagio.io/videos/VAST-4.0-Short-Intro.mp4 ]]></MediaFile></MediaFiles><VideoClicks><ClickThrough id=\"blog\"><![CDATA[https://iabtechlab.com]]></ClickThrough></VideoClicks></Linear><UniversalAdId idRegistry=\"Ad-ID\"><![CDATA[8465]]></UniversalAdId></Creative></Creatives><Extensions><Extension type=\"DFP\"><SkippableAdType><![CDATA[Generic]]></SkippableAdType></Extension></Extensions><Impression><![CDATA[http://burl.com]]></Impression><Impression><![CDATA[https://c-testing.4dex.io/imp-testing.gif?adg_com=0.2&adu_code=685e1fff-5d45-4d74-8e6e-9163dcca628a&auction_id=685e1fff-5d45-4d74-8e6e-9163dcca628a&bid_id=1234567890&bid_ts=1738332107&bidder=onetag&breq_id=dd73f597-31d2-41bf-988f-fd22b7d3f4d4&browser=chrome&bttl=300&buid=0&buids=0&cpm=8.016641&crea_id=creative111&curr=USD&discrp_adjst=0.035&domn=botasot.info&dvc=4&environment=phone&h=0&it=ortb&ivt_adjst=0&lzy=0&mt=vidout&net_cpm=6.4133128&org_id=1015&os=android&partid=2025013114&plcmt=unknown&pltfrm=app&plyr=other&pn=1&pv_id=4fc0ecc6-1e69-41f8-ac3c-1fa57e6cc3cb&rpmadc_smpl=0&rule_id=2566&seat_id=5&seattyp=shared&site=67404-botasot-info&spr_id=241&sspv=3.0.0-gcp-ams&tiv=-1&ve=organic&vr=-1&w=0&src=vast&v=2]]></Impression></InLine></Ad></VAST>",
"adomain": [
"www.addomain.com"
],
"crid": "creative111",
"apis": [
2
],
"api": 2,
"protocol": 8,
"mtype": 2
}
],
"seat": "5"
}
],
"statuscode": 0,
"ext": {
"responsetimemillis": {
"5": 41
}
}
}{
"id": "f20ef65c-be19-4c3a-b44f-52ff22451b42",
"seatbid": [
{
"bid": [
{
"id": "1234567890",
"impid": "1",
"price": 6.4536112,
"adm":"{\"ver\":\"1.2\",\"link\":{},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"http://burl.com\"},{\"event\":1,\"method\":1,\"url\":\"https://c-testing.4dex.io/imp-testing.gif?adg_com=0.2\&adu_code=f20ef65c-be19-4c3a-b44f-52ff22451b42\&auction_id=f20ef65c-be19-4c3a-b44f-52ff22451b42\&bid_id=1234567890\&bid_ts=1738332511\&bidder=onetag\&breq_id=3a449e47-f4f5-4114-a6eb-85b1d0712282\&browser=chrome\&bttl=300\&buid=0\&buids=0\&cpm=8.067014\&crea_id=creative111\&curr=USD\&discrp_adjst=0.035\&domn=botasot.info\&dvc=4\&environment=phone\&h=1\&it=ortb\&ivt_adjst=0\&lzy=0\&mt=nat\&net_cpm=6.453611200000001\&org_id=1015\&os=android\&partid=2025013114\&plcmt=unknown\&pltfrm=app\&pn=1\&pv_id=4294946e-6382-4e27-aecd-0e2b7da3b72c\&rpmadc_smpl=0\&rule_id=2566\&seat_id=5\&seattyp=shared\&site=67404-botasot-info\&spr_id=241\&sspv=3.0.0-gcp-ams\&tiv=-1\&ve=organic\&vr=-1\&w=1\"}]}",
"adomain": [
"www.addomain.com"
],
"crid": "creative111",
"w": 1,
"h": 1,
"mtype": 4
}
],
"seat": "5"
}
],
"statuscode": 0
}{
"id": "73b10f06-fb28-4bb4-8b8d-a083f4d8d72b",
"seatbid": [
{
"bid": [
{
"id": "1234567890",
"impid": "1",
"price": 6.1208928,
"adm": "<a href=\"http://myadserver.com/click><img src=\"http://image.com/\"/><img src=\"http://myadserver.com/impression/1.0\"/></a>",
"adomain": [
"www.addomain.com"
],
"crid": "creative111",
"w": 320,
"h": 480,
"mtype": 1
}
],
"seat": "8"
}
],
"statuscode": 0
}Last updated
Was this helpful?