More variants: OpenRTB examples
Hosts are placeholders; the example uses OpenRTB 2.6 unless stated otherwise. Fields are described in the specification.
Banner in OpenRTB 2.5
Request
{
"at": 1,
"badv": [
"blocked-brand.example"
],
"bcat": [
"IAB25",
"IAB26"
],
"cur": [
"USD"
],
"device": {
"devicetype": 2,
"ip": "203.0.113.10",
"language": "de",
"os": "Windows",
"ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36"
},
"id": "req-banner-2",
"imp": [
{
"banner": {
"h": 90,
"w": 728
},
"bidfloor": 0.3,
"bidfloorcur": "USD",
"id": "1",
"tagid": "zone-top-728x90"
}
],
"regs": {
"ext": {
"gdpr": 1
}
},
"site": {
"cat": [
"IAB12"
],
"domain": "publisher.example",
"id": "site-1",
"page": "https://publisher.example/news/article-1",
"publisher": {
"ext": {
"subid": "sub-42"
},
"id": "pub-1"
}
},
"tmax": 300,
"user": {
"ext": {
"consent": "CP_EXAMPLE_TCF_STRING"
},
"id": "u-123"
}
}Response
{
"id": "req-banner-2",
"seatbid": [
{
"bid": [
{
"id": "0b9c2f4e-1111-4a2b-9c3d-000000000002",
"impid": "1",
"price": 0.41,
"adid": "1002",
"nurl": "https://notify.example.com/wn?id=0b9c2f4e-1111-4a2b-9c3d-000000000002&t=tk-notice&price=${AUCTION_PRICE}",
"burl": "https://notify.example.com/bn?id=0b9c2f4e-1111-4a2b-9c3d-000000000002&t=tk-notice&price=${AUCTION_PRICE}",
"adm": "<div id='ytrgt-container-6i1a1cz6amr9' style='width: 728px; height: 90px;'></div><script>!function(w,d,s,o,f,js,fjs){ w[o]=w[o]||function(){(w[o].q=w[o].q||[]).push(arguments)}; w[o].q=w[o].q||[]; js=d.createElement(s);fjs=d.getElementsByTagName(s)[0]; js.async=1;js.src=f;fjs.parentNode.insertBefore(js,fjs);}(window,document,'script','ytrgt','https://ads.example.com/js/ytrgt.js');ytrgt('ad:create', '#ytrgt-container-6i1a1cz6amr9');ytrgt('ad:load', '#ytrgt-container-6i1a1cz6amr9', 'https://notify.example.com/bi?creative_id=c1002&id=0b9c2f4e-1111-4a2b-9c3d-000000000002&t=tk-event');ytrgt('sync:pixels', []);</script>",
"adomain": [
"advertiser.example"
],
"cid": "502",
"crid": "1002",
"cat": [
"IAB3"
],
"language": "de",
"w": 728,
"h": 90
}
],
"seat": "77"
}
],
"cur": "USD"
}2.5 field names: regs.ext.gdpr, user.ext.consent; the response has language and no mtype.
MRAID in an app
Request
{
"app": {
"bundle": "com.publisher.example",
"id": "app-1",
"name": "Publisher News",
"publisher": {
"id": "pub-1"
},
"storeurl": "https://play.google.com/store/apps/details?id=com.publisher.example"
},
"at": 1,
"badv": [
"blocked-brand.example"
],
"bcat": [
"IAB25",
"IAB26"
],
"cur": [
"USD"
],
"device": {
"devicetype": 4,
"ifa": "6f1c2a4e-3b5d-4c7e-9a8b-1d2e3f4a5b6c",
"ip": "203.0.113.20",
"language": "en",
"make": "Google",
"model": "Pixel 8",
"os": "Android",
"osv": "14",
"ua": "Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Mobile Safari/537.36"
},
"id": "req-mraid-1",
"imp": [
{
"banner": {
"api": [
3,
5,
6
],
"format": [
{
"h": 480,
"w": 320
}
]
},
"bidfloor": 2,
"bidfloorcur": "USD",
"displaymanager": "PublisherSDK",
"displaymanagerver": "4.2.0",
"id": "1",
"instl": 1,
"tagid": "zone-app-instl"
}
],
"tmax": 300,
"user": {
"id": "u-777"
}
}Response
{
"id": "req-mraid-1",
"seatbid": [
{
"bid": [
{
"id": "0b9c2f4e-1111-4a2b-9c3d-000000000004",
"impid": "1",
"price": 2.4,
"adid": "1004",
"nurl": "https://notify.example.com/wn?id=0b9c2f4e-1111-4a2b-9c3d-000000000004&t=tk-notice&price=${AUCTION_PRICE}",
"burl": "https://notify.example.com/bn?id=0b9c2f4e-1111-4a2b-9c3d-000000000004&t=tk-notice&price=${AUCTION_PRICE}",
"adm": "<script src=\"mraid.js\"></script><script>window.clickTag='https://advertiser.example/landing?click_id=0b9c2f4e-1111-4a2b-9c3d-000000000004';</script><div class=\"ad\"><a href=\"#\" onclick=\"mraid.open('https://advertiser.example/');return false\"><img src=\"https://ads.example.com/c/1004/320x480.jpg\" width=\"320\" height=\"480\"></a></div><script>(function(){var imps=['https://notify.example.com/imp?id=0b9c2f4e-1111-4a2b-9c3d-000000000004&t=tk-imp'],v50=['https://notify.example.com/vimp?event_type=3&id=0b9c2f4e-1111-4a2b-9c3d-000000000004&t=tk-imp'],v100=['https://notify.example.com/vimp?event_type=4&id=0b9c2f4e-1111-4a2b-9c3d-000000000004&t=tk-imp'];function fire(us){for(var i=0;i<us.length;i++){new Image().src=us[i];}}var shown=false;function show(){if(!shown){shown=true;fire(imps);}}function timer(urls,min){var t=null,done=!urls.length;return function(pct){if(done){return;}if(pct>=min){if(!t){t=setTimeout(function(){done=true;fire(urls);},1000);}}else if(t){clearTimeout(t);t=null;}};}var m=window.mraid;if(!m){if(document.readyState==='loading'){document.addEventListener('DOMContentLoaded',show);}else{show();}return;}var open=m.open;m.open=function(){var u='https://notify.example.com/c?id=0b9c2f4e-1111-4a2b-9c3d-000000000004&t=tk-click&r=0';try{fetch(u,{keepalive:true,mode:'no-cors'});}catch(e){new Image().src=u;}return open.apply(m,arguments);};function watch(){if(m.getPlacementType()==='interstitial'){m.addEventListener('viewableChange',function(on){if(on){show();}});if(m.isViewable()){show();}}else{show();}if(typeof m.getVersion==='function'&&parseFloat(m.getVersion())>=3){var t50=timer(v50,50),t100=timer(v100,100);m.addEventListener('exposureChange',function(pct){pct=pct||0;if(pct>0){show();}t50(pct);t100(pct);});}}if(m.getState()==='loading'){m.addEventListener('ready',watch);}else{watch();}})();</script>",
"adomain": [
"advertiser.example"
],
"cid": "504",
"crid": "1004",
"cat": [
"IAB3"
],
"w": 320,
"h": 480,
"apis": [
6
],
"langb": "de",
"mtype": 1
}
],
"seat": "77"
}
],
"cur": "USD"
}banner.api declares MRAID 2 and 3, so apis: [6]; the app SDK provides mraid.js.
HTML banner as is
Request
{
"at": 1,
"badv": [
"blocked-brand.example"
],
"bcat": [
"IAB25",
"IAB26"
],
"cur": [
"USD"
],
"device": {
"devicetype": 2,
"ip": "203.0.113.10",
"language": "de",
"os": "Windows",
"ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36"
},
"id": "req-inline-1",
"imp": [
{
"banner": {
"format": [
{
"h": 600,
"w": 300
}
]
},
"bidfloor": 0.6,
"bidfloorcur": "USD",
"id": "1",
"tagid": "zone-side-300x600"
}
],
"site": {
"cat": [
"IAB12"
],
"domain": "publisher.example",
"id": "site-1",
"page": "https://publisher.example/news/article-1",
"publisher": {
"ext": {
"subid": "sub-42"
},
"id": "pub-1"
}
},
"tmax": 300,
"user": {
"id": "u-321"
}
}Response
{
"id": "req-inline-1",
"seatbid": [
{
"bid": [
{
"id": "0b9c2f4e-1111-4a2b-9c3d-000000000005",
"impid": "1",
"price": 0.9,
"adid": "1005",
"nurl": "https://notify.example.com/wn?id=0b9c2f4e-1111-4a2b-9c3d-000000000005&t=tk-notice&price=${AUCTION_PRICE}",
"burl": "https://notify.example.com/bn?id=0b9c2f4e-1111-4a2b-9c3d-000000000005&t=tk-notice&price=${AUCTION_PRICE}",
"adm": "<script src=\"https://adtag.advertiser.example/tag.js?slot=300x600\" async></script><div id=\"adv-slot-300x600\"></div><img width=\"0\" height=\"0\" src=\"https://notify.example.com/imp?id=0b9c2f4e-1111-4a2b-9c3d-000000000005&t=tk-imp\" alt=\"pixel\" />",
"adomain": [
"advertiser.example"
],
"cid": "505",
"crid": "1005",
"cat": [
"IAB3"
],
"w": 300,
"h": 600,
"langb": "de",
"mtype": 1
}
],
"seat": "77"
}
],
"cur": "USD"
}The request is the same as for a regular banner; adm holds the advertiser's original tag and our impression pixel.
Native in a banner slot
Request
{
"at": 1,
"badv": [
"blocked-brand.example"
],
"bcat": [
"IAB25",
"IAB26"
],
"cur": [
"USD"
],
"device": {
"devicetype": 2,
"ip": "203.0.113.10",
"language": "de",
"os": "Windows",
"ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36"
},
"id": "req-nfb-1",
"imp": [
{
"banner": {
"format": [
{
"h": 250,
"w": 300
}
]
},
"bidfloor": 0.4,
"bidfloorcur": "USD",
"id": "1",
"tagid": "zone-side-300x250"
}
],
"site": {
"cat": [
"IAB12"
],
"domain": "publisher.example",
"id": "site-1",
"page": "https://publisher.example/news/article-1",
"publisher": {
"ext": {
"subid": "sub-42"
},
"id": "pub-1"
}
},
"tmax": 300,
"user": {
"id": "u-333"
}
}Response
{
"id": "req-nfb-1",
"seatbid": [
{
"bid": [
{
"id": "a41c7b2d-3333-4c5d-9e6f-000000000002",
"impid": "1",
"price": 0.7,
"adid": "3002",
"nurl": "https://notify.example.com/wn?id=a41c7b2d-3333-4c5d-9e6f-000000000002&t=tk-notice&price=${AUCTION_PRICE}",
"burl": "https://notify.example.com/bn?id=a41c7b2d-3333-4c5d-9e6f-000000000002&t=tk-notice&price=${AUCTION_PRICE}",
"adm": "<div id='ytrgt-container-x711ga2nskh1' style='width: 300px; height: 250px;'></div><script>!function(w,d,s,o,f,js,fjs){w[o]=w[o]||function(){(w[o].q=w[o].q||[]).push(arguments)};w[o].q=w[o].q||[];js=d.createElement(s);fjs=d.getElementsByTagName(s)[0];js.async=1;js.src=f;fjs.parentNode.insertBefore(js,fjs);}(window,document,'script','ytrgt','https://ads.example.com/js/ytrgt.js');ytrgt('ad:create','#ytrgt-container-x711ga2nskh1');ytrgt('ad:render','#ytrgt-container-x711ga2nskh1',{type:'html',html:atob('PGEgaHJlZj0iaHR0cHM6Ly9ub3RpZnkuZXhhbXBsZS5jb20vYz9pZD1hNDFjN2IyZC0zMzMzLTRjNWQtOWU2Zi0wMDAwMDAwMDAwMDImYW1wO3Q9dGstY2xpY2siIHN0eWxlPSJkaXNwbGF5OmZsZXg7ZmxleC1kaXJlY3Rpb246Y29sdW1uO2JveC1zaXppbmc6Ym9yZGVyLWJveDt3aWR0aDozMDBweDtoZWlnaHQ6MjUwcHg7b3ZlcmZsb3c6aGlkZGVuO3RleHQtZGVjb3JhdGlvbjpub25lO2NvbG9yOiMxMTE7YmFja2dyb3VuZDojZmZmO2ZvbnQtZmFtaWx5Oi1hcHBsZS1zeXN0ZW0sQmxpbmtNYWNTeXN0ZW1Gb250LCdTZWdvZSBVSScsUm9ib3RvLEFyaWFsLHNhbnMtc2VyaWYiPjxkaXYgc3R5bGU9InBvc2l0aW9uOnJlbGF0aXZlO2ZsZXg6MCAwIGF1dG87aGVpZ2h0OjEzN3B4O292ZXJmbG93OmhpZGRlbiI+PGltZyBzcmM9Imh0dHBzOi8vYWRzLmV4YW1wbGUuY29tL2MvMzAwMi8xMjAweDYyOC5qcGciIGFsdD0iIiBzdHlsZT0iZGlzcGxheTpibG9jazt3aWR0aDoxMDAlO2hlaWdodDoxMDAlO29iamVjdC1maXQ6Y292ZXI7Ym9yZGVyOjAiPjwvZGl2PjxkaXYgc3R5bGU9ImZsZXg6MSAxIGF1dG87ZGlzcGxheTpmbGV4O2ZsZXgtZGlyZWN0aW9uOmNvbHVtbjthbGlnbi1pdGVtczpmbGV4LXN0YXJ0O2JveC1zaXppbmc6Ym9yZGVyLWJveDtwYWRkaW5nOjZweCA4cHgiPjxkaXYgc3R5bGU9ImZvbnQtd2VpZ2h0OjYwMDtmb250LXNpemU6MTZweDtsaW5lLWhlaWdodDoyMHB4O2Rpc3BsYXk6LXdlYmtpdC1ib3g7LXdlYmtpdC1saW5lLWNsYW1wOjM7LXdlYmtpdC1ib3gtb3JpZW50OnZlcnRpY2FsO292ZXJmbG93OmhpZGRlbiI+U29tbWVyYW5nZWJvdDogYmlzIHp1IDQwICUgUmFiYXR0PC9kaXY+PGRpdiBjbGFzcz0ieXRyZ3QtbmF0aXZlLWN0YSIgc3R5bGU9Im1heC13aWR0aDoxMDAlO2JveC1zaXppbmc6Ym9yZGVyLWJveDttYXJnaW4tdG9wOjhweDtwYWRkaW5nOjdweCAxNHB4O2JvcmRlci1yYWRpdXM6NHB4O2JhY2tncm91bmQ6IzFhNzNlODtjb2xvcjojZmZmO2ZvbnQtd2VpZ2h0OjYwMDtmb250LXNpemU6MTRweDtsaW5lLWhlaWdodDoxLjI7d2hpdGUtc3BhY2U6bm93cmFwO292ZXJmbG93OmhpZGRlbjt0ZXh0LW92ZXJmbG93OmVsbGlwc2lzIj5NZWhyIGVyZmFocmVuPC9kaXY+PC9kaXY+PC9hPg=='),eventtrackers:[{event:1,method:1,url:'https://notify.example.com/imp?id=a41c7b2d-3333-4c5d-9e6f-000000000002&t=tk-imp'},{event:2,method:1,url:'https://notify.example.com/vimp?event_type=3&id=a41c7b2d-3333-4c5d-9e6f-000000000002&t=tk-imp'},{event:3,method:1,url:'https://notify.example.com/vimp?event_type=4&id=a41c7b2d-3333-4c5d-9e6f-000000000002&t=tk-imp'},{event:4,method:1,url:'https://notify.example.com/vimp?event_type=5&id=a41c7b2d-3333-4c5d-9e6f-000000000002&t=tk-imp'}],showAdMark:false});ytrgt('sync:pixels',[]);</script>",
"adomain": [
"advertiser.example"
],
"cid": "702",
"crid": "3002",
"cat": [
"IAB3"
],
"w": 300,
"h": 250,
"langb": "de",
"mtype": 1
}
],
"seat": "77"
}
],
"cur": "USD"
}A regular banner request; the native creative comes as HTML sized to the slot, mtype: 1.
Rewarded video in an app
Request
{
"app": {
"bundle": "com.publisher.example",
"id": "app-1",
"name": "Publisher News",
"publisher": {
"id": "pub-1"
},
"storeurl": "https://play.google.com/store/apps/details?id=com.publisher.example"
},
"at": 1,
"badv": [
"blocked-brand.example"
],
"bcat": [
"IAB25",
"IAB26"
],
"cur": [
"USD"
],
"device": {
"devicetype": 4,
"ifa": "6f1c2a4e-3b5d-4c7e-9a8b-1d2e3f4a5b6c",
"ip": "203.0.113.20",
"language": "en",
"make": "Google",
"model": "Pixel 8",
"os": "Android",
"osv": "14",
"ua": "Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Mobile Safari/537.36"
},
"id": "req-video-3",
"imp": [
{
"bidfloor": 6,
"bidfloorcur": "USD",
"id": "1",
"instl": 1,
"rwdd": 1,
"tagid": "zone-app-video-fullscreen",
"video": {
"api": [
7
],
"h": 1920,
"linearity": 1,
"maxduration": 30,
"mimes": [
"video/mp4"
],
"minduration": 5,
"playbackmethod": [
1
],
"plcmt": 3,
"protocols": [
3,
6,
7,
8,
11,
12
],
"skip": 0,
"w": 1080
}
}
],
"tmax": 300,
"user": {
"id": "u-791"
}
}Response
{
"id": "req-video-3",
"seatbid": [
{
"bid": [
{
"id": "6d1e0c3a-2222-4b3c-8d4e-000000000004",
"impid": "1",
"price": 7.4,
"adid": "2004",
"nurl": "https://notify.example.com/wn?id=6d1e0c3a-2222-4b3c-8d4e-000000000004&t=tk-notice&price=${AUCTION_PRICE}",
"burl": "https://notify.example.com/bn?id=6d1e0c3a-2222-4b3c-8d4e-000000000004&t=tk-notice&price=${AUCTION_PRICE}",
"adm": "<VAST version=\"4.1\"><Ad id=\"2004\"><Wrapper><AdSystem>DSP</AdSystem><Error><![CDATA[https://notify.example.com/ve?id=6d1e0c3a-2222-4b3c-8d4e-000000000004&t=tk-event&event_type=error&errorcode=[ERRORCODE]]]></Error><Impression id=\"0\"><![CDATA[https://notify.example.com/imp?id=6d1e0c3a-2222-4b3c-8d4e-000000000004&t=tk-imp]]></Impression><Creatives><Creative id=\"2004\"><Linear><TrackingEvents><Tracking event=\"start\"><![CDATA[https://notify.example.com/ve?event_type=start&id=6d1e0c3a-2222-4b3c-8d4e-000000000004&t=tk-event]]></Tracking><Tracking event=\"firstQuartile\"><![CDATA[https://notify.example.com/ve?event_type=firstQuartile&id=6d1e0c3a-2222-4b3c-8d4e-000000000004&t=tk-event]]></Tracking><Tracking event=\"midpoint\"><![CDATA[https://notify.example.com/ve?event_type=midpoint&id=6d1e0c3a-2222-4b3c-8d4e-000000000004&t=tk-event]]></Tracking><Tracking event=\"thirdQuartile\"><![CDATA[https://notify.example.com/ve?event_type=thirdQuartile&id=6d1e0c3a-2222-4b3c-8d4e-000000000004&t=tk-event]]></Tracking><Tracking event=\"complete\"><![CDATA[https://notify.example.com/ve?event_type=complete&id=6d1e0c3a-2222-4b3c-8d4e-000000000004&t=tk-event]]></Tracking><Tracking event=\"skip\"><![CDATA[https://notify.example.com/ve?event_type=skip&id=6d1e0c3a-2222-4b3c-8d4e-000000000004&t=tk-event]]></Tracking></TrackingEvents></Linear></Creative></Creatives><VASTAdTagURI><![CDATA[https://notify.example.com/vast?creative_id=c2004&id=6d1e0c3a-2222-4b3c-8d4e-000000000004&t=tk-event]]></VASTAdTagURI></Wrapper></Ad></VAST>",
"adomain": [
"advertiser.example"
],
"cid": "604",
"crid": "2004",
"cat": [
"IAB3"
],
"protocol": 12,
"w": 1080,
"h": 1920,
"langb": "de",
"dur": 30,
"mtype": 2
}
],
"seat": "77"
}
],
"cur": "USD"
}instl=1 and rwdd=1 leave only fullscreen rewarded video; the newest Wrapper is 12, so the response is VAST 4.1.
Video InLine in OpenRTB 2.5
Request
{
"app": {
"bundle": "com.publisher.example",
"id": "app-1",
"name": "Publisher News",
"publisher": {
"id": "pub-1"
},
"storeurl": "https://play.google.com/store/apps/details?id=com.publisher.example"
},
"at": 1,
"badv": [
"blocked-brand.example"
],
"bcat": [
"IAB25",
"IAB26"
],
"cur": [
"USD"
],
"device": {
"devicetype": 4,
"ifa": "6f1c2a4e-3b5d-4c7e-9a8b-1d2e3f4a5b6c",
"ip": "203.0.113.20",
"language": "en",
"make": "Google",
"model": "Pixel 8",
"os": "Android",
"osv": "14",
"ua": "Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Mobile Safari/537.36"
},
"id": "req-video-2",
"imp": [
{
"bidfloor": 4,
"bidfloorcur": "USD",
"ext": {
"rewarded": 1
},
"id": "1",
"instl": 1,
"tagid": "zone-video-rewarded",
"video": {
"h": 720,
"linearity": 1,
"maxduration": 30,
"mimes": [
"video/mp4"
],
"minduration": 5,
"placement": 5,
"playbackmethod": [
1
],
"protocols": [
2,
3
],
"w": 1280
}
}
],
"tmax": 300,
"user": {
"id": "u-790"
}
}Response
{
"id": "req-video-2",
"seatbid": [
{
"bid": [
{
"id": "6d1e0c3a-2222-4b3c-8d4e-000000000002",
"impid": "1",
"price": 5.2,
"adid": "2002",
"nurl": "https://notify.example.com/wn?id=6d1e0c3a-2222-4b3c-8d4e-000000000002&t=tk-notice&price=${AUCTION_PRICE}",
"burl": "https://notify.example.com/bn?id=6d1e0c3a-2222-4b3c-8d4e-000000000002&t=tk-notice&price=${AUCTION_PRICE}",
"adm": "<VAST version=\"3.0\"><Ad id=\"2002\"><InLine><AdSystem>DSP</AdSystem><AdTitle>Advertisement</AdTitle><Error><![CDATA[https://notify.example.com/ve?id=6d1e0c3a-2222-4b3c-8d4e-000000000002&t=tk-event&event_type=error&errorcode=[ERRORCODE]]]></Error><Impression id=\"0\"><![CDATA[https://notify.example.com/imp?id=6d1e0c3a-2222-4b3c-8d4e-000000000002&t=tk-imp]]></Impression><Creatives><Creative id=\"2002\"><Linear><Duration>00:00:20</Duration><TrackingEvents><Tracking event=\"start\"><![CDATA[https://notify.example.com/ve?event_type=start&id=6d1e0c3a-2222-4b3c-8d4e-000000000002&t=tk-event]]></Tracking><Tracking event=\"firstQuartile\"><![CDATA[https://notify.example.com/ve?event_type=firstQuartile&id=6d1e0c3a-2222-4b3c-8d4e-000000000002&t=tk-event]]></Tracking><Tracking event=\"midpoint\"><![CDATA[https://notify.example.com/ve?event_type=midpoint&id=6d1e0c3a-2222-4b3c-8d4e-000000000002&t=tk-event]]></Tracking><Tracking event=\"thirdQuartile\"><![CDATA[https://notify.example.com/ve?event_type=thirdQuartile&id=6d1e0c3a-2222-4b3c-8d4e-000000000002&t=tk-event]]></Tracking><Tracking event=\"complete\"><![CDATA[https://notify.example.com/ve?event_type=complete&id=6d1e0c3a-2222-4b3c-8d4e-000000000002&t=tk-event]]></Tracking><Tracking event=\"skip\"><![CDATA[https://notify.example.com/ve?event_type=skip&id=6d1e0c3a-2222-4b3c-8d4e-000000000002&t=tk-event]]></Tracking></TrackingEvents><VideoClicks><ClickThrough id=\"0\"><![CDATA[https://notify.example.com/c?id=6d1e0c3a-2222-4b3c-8d4e-000000000002&t=tk-click]]></ClickThrough></VideoClicks><MediaFiles><MediaFile delivery=\"progressive\" type=\"video/mp4\" bitrate=\"2000\" width=\"1280\" height=\"720\"><![CDATA[https://ads.example.com/c/2002/video_1280x720.mp4]]></MediaFile></MediaFiles></Linear></Creative></Creatives></InLine></Ad></VAST>",
"adomain": [
"advertiser.example"
],
"cid": "602",
"crid": "2002",
"cat": [
"IAB3"
],
"protocol": 3,
"language": "de",
"w": 1280,
"h": 720
}
],
"seat": "77"
}
],
"cur": "USD"
}protocols has only InLine versions, so the response is VAST InLine 3.0; rewarded is passed via imp.ext.rewarded.
Native with CPC pricing
Request
{
"at": 1,
"badv": [
"blocked-brand.example"
],
"bcat": [
"IAB25",
"IAB26"
],
"cur": [
"USD"
],
"device": {
"devicetype": 2,
"ip": "203.0.113.10",
"language": "de",
"os": "Windows",
"ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36"
},
"id": "req-native-cpc-1",
"imp": [
{
"bidfloor": 0.02,
"bidfloorcur": "USD",
"id": "1",
"native": {
"request": "{\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":90}},{\"id\":2,\"img\":{\"hmin\":314,\"type\":3,\"wmin\":600},\"required\":1},{\"data\":{\"len\":25,\"type\":12},\"id\":3,\"required\":0}],\"context\":1,\"eventtrackers\":[{\"event\":1,\"methods\":[1]},{\"event\":2,\"methods\":[1]}],\"plcmtcnt\":1,\"plcmttype\":1,\"ver\":\"1.2\"}",
"ver": "1.2"
},
"tagid": "zone-feed-5"
}
],
"site": {
"cat": [
"IAB12"
],
"domain": "publisher.example",
"id": "site-1",
"page": "https://publisher.example/news/article-1",
"publisher": {
"ext": {
"subid": "sub-42"
},
"id": "pub-1"
}
},
"tmax": 300,
"user": {
"id": "u-322"
}
}Response
{
"id": "req-native-cpc-1",
"seatbid": [
{
"bid": [
{
"id": "a41c7b2d-3333-4c5d-9e6f-000000000003",
"impid": "1",
"price": 0.035,
"adid": "3003",
"nurl": "https://notify.example.com/wn?id=a41c7b2d-3333-4c5d-9e6f-000000000003&t=tk-notice&price=${AUCTION_PRICE}",
"burl": "https://notify.example.com/bn?id=a41c7b2d-3333-4c5d-9e6f-000000000003&t=tk-notice&price=${AUCTION_PRICE}",
"adm": "{\"ver\":\"1.1\",\"assets\":[{\"id\":1,\"title\":{\"text\":\"Sommerangebot: bis zu 40 % Rabatt\"}},{\"id\":2,\"img\":{\"url\":\"https://ads.example.com/c/3003/1200x628.jpg\"}},{\"id\":3,\"data\":{\"value\":\"Mehr erfahren\"}}],\"link\":{\"url\":\"https://notify.example.com/c?id=a41c7b2d-3333-4c5d-9e6f-000000000003&t=tk-click\"},\"imptrackers\":[\"https://notify.example.com/imp?id=a41c7b2d-3333-4c5d-9e6f-000000000003&t=tk-imp\"],\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://notify.example.com/imp?id=a41c7b2d-3333-4c5d-9e6f-000000000003&t=tk-imp\"},{\"event\":2,\"method\":1,\"url\":\"https://notify.example.com/vimp?event_type=3&id=a41c7b2d-3333-4c5d-9e6f-000000000003&t=tk-imp\"},{\"event\":3,\"method\":1,\"url\":\"https://notify.example.com/vimp?event_type=4&id=a41c7b2d-3333-4c5d-9e6f-000000000003&t=tk-imp\"},{\"event\":4,\"method\":1,\"url\":\"https://notify.example.com/vimp?event_type=5&id=a41c7b2d-3333-4c5d-9e6f-000000000003&t=tk-imp\"}]}",
"adomain": [
"advertiser.example"
],
"cid": "703",
"crid": "3003",
"cat": [
"IAB3"
],
"w": 1200,
"h": 628,
"langb": "de",
"mtype": 4,
"ext": {
"cpc": 0.035
}
}
],
"seat": "77"
}
],
"cur": "USD"
}bidfloor and price are the click price, which is also in bid.ext.cpc.
Popunder as a separate integration variant
Request
{
"at": 1,
"badv": [
"blocked-brand.example"
],
"bcat": [
"IAB25",
"IAB26"
],
"cur": [
"USD"
],
"device": {
"devicetype": 2,
"ip": "203.0.113.10",
"language": "de",
"os": "Windows",
"ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36"
},
"id": "req-pop-2",
"imp": [
{
"bidfloor": 1,
"bidfloorcur": "USD",
"id": "1",
"tagid": "zone-popunder"
}
],
"site": {
"cat": [
"IAB12"
],
"domain": "publisher.example",
"id": "site-1",
"page": "https://publisher.example/news/article-1",
"publisher": {
"ext": {
"subid": "sub-42"
},
"id": "pub-1"
}
},
"tmax": 300,
"user": {
"id": "u-112"
}
}Response
{
"id": "req-pop-2",
"seatbid": [
{
"bid": [
{
"id": "c63e9d4f-5555-4e7f-9081-000000000002",
"impid": "1",
"price": 2,
"adid": "5002",
"nurl": "https://notify.example.com/wn?id=c63e9d4f-5555-4e7f-9081-000000000002&t=tk-notice",
"burl": "https://notify.example.com/bn?id=c63e9d4f-5555-4e7f-9081-000000000002&t=tk-notice",
"adm": "https://notify.example.com/c?id=c63e9d4f-5555-4e7f-9081-000000000002&t=tk-click",
"adomain": [
"advertiser.example"
],
"cid": "902",
"crid": "5002",
"cat": [
"IAB3"
],
"language": "de"
}
],
"seat": "77"
}
],
"cur": "USD"
}No format objects are needed; adm is the URL as a string, nurl and burl have no ${AUCTION_PRICE}, and the response is in 2.5 form.
DOOH
Request
{
"at": 1,
"badv": [
"blocked-brand.example"
],
"bcat": [
"IAB25",
"IAB26"
],
"cur": [
"USD"
],
"device": {
"ip": "203.0.113.50",
"ua": "DOOH-Player/2.1"
},
"dooh": {
"domain": "dooh-operator.example",
"id": "venue-17",
"name": "Mall screen",
"venuetype": [
101
],
"venuetypetax": 1
},
"id": "req-dooh-1",
"imp": [
{
"banner": {
"h": 1080,
"w": 1920
},
"bidfloor": 3,
"bidfloorcur": "USD",
"id": "1",
"tagid": "screen-17"
}
],
"tmax": 300
}Response
{
"id": "req-dooh-1",
"seatbid": [
{
"bid": [
{
"id": "0b9c2f4e-1111-4a2b-9c3d-000000000006",
"impid": "1",
"price": 4.5,
"adid": "1006",
"nurl": "https://notify.example.com/wn?id=0b9c2f4e-1111-4a2b-9c3d-000000000006&t=tk-notice&price=${AUCTION_PRICE}",
"burl": "https://notify.example.com/bn?id=0b9c2f4e-1111-4a2b-9c3d-000000000006&t=tk-notice&price=${AUCTION_PRICE}",
"adm": "<div id='ytrgt-container-2n0c9aw2u77gh' style='width: 1920px; height: 1080px;'></div><script>!function(w,d,s,o,f,js,fjs){ w[o]=w[o]||function(){(w[o].q=w[o].q||[]).push(arguments)}; w[o].q=w[o].q||[]; js=d.createElement(s);fjs=d.getElementsByTagName(s)[0]; js.async=1;js.src=f;fjs.parentNode.insertBefore(js,fjs);}(window,document,'script','ytrgt','https://ads.example.com/js/ytrgt.js');ytrgt('ad:create', '#ytrgt-container-2n0c9aw2u77gh');ytrgt('ad:load', '#ytrgt-container-2n0c9aw2u77gh', 'https://notify.example.com/bi?creative_id=c1006&id=0b9c2f4e-1111-4a2b-9c3d-000000000006&t=tk-event');ytrgt('sync:pixels', []);</script>",
"adomain": [
"advertiser.example"
],
"cid": "506",
"crid": "1006",
"cat": [
"IAB3"
],
"w": 1920,
"h": 1080,
"langb": "de",
"mtype": 1
}
],
"seat": "77"
}
],
"cur": "USD"
}2.6 only: dooh instead of site and app; if tagid is empty, we take the zone ID from dooh.id.