Below there are samples of request & response.
VAST
Vast video request sample
{ "id": "example", "imp": [ { "id": "example", "video": { "w": 320, "h": 480, "minduration": 5, "maxduration": 60, "protocols": [ 5, 6, 2, 3 ], "battr": [ 5, 10, 14, 1, 9, 13, 2, 17, 12, 3, 8, 4 ], "api": [ 7 ], "mimes": [ "video/mpeg", "video/mp4", "video/quicktime", "video/avi" ], "skip": 1, "placement": 5, "skipafter": 5, "companionad": [ { "w": 320, "h": 480, "api": [ 3, 4, 5, 6 ], "pos": 7 } ], "companiontype": [ 1, 2, 3 ], "ext": { "videotype": "skippable", "placementtype": "interstitial" } }, "displaymanager": "example", "displaymanagerver": "2.6.0", "instl": 1, "tagid": "default", "bidfloor": 0.18, "bidfloorcur": "USD", "ext": {} } ], "badv": [ "example.com" ], "bcat": [ "IAB8-18", "IAB7-39", "IAB19-3", "IAB25-6", "IAB26-4" ], "app": { "id": "example", "bundle": "com.example", "name": "example name", "ver": "2.07.00", "storeurl": "https://play.google.com/store/apps/details?id=com.example", "cat": [ "IAB9-30", "IAB1-6" ], "publisher": { "id": "example", "name": "example" } }, "device": { "ifa": "example-47d378d50916", "devicetype": 4, "make": "example", "model": "example", "hwv": "example", "w": 720, "h": 1612, "os": "android", "osv": "14.0.0", "ua": "Mozilla/5.0 (Linux; Android 14; example Build/SP1A.example.016; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/example Mobile Safari/537.36", "connectiontype": 2, "carrier": "example", "mccmnc": "example", "ip": "example", "geo": { "type": 2, "lat": example, "lon": example, "country": "USA", "region": "ny", "city": "New York", "utcoffset": example, "ipservice": 3 }, "language": "id", "js": 1, "pxratio": 2, "ext": {} }, "user": { "id": "example", "ext": {} }, "at": 1, "tmax": 400, "cur": [ "USD" ], "source": { "ext": { "schain": { "ver": "1.0", "complete": 1, "nodes": [ { "asi": "example.com", "sid": "570", "rid": "example", "hp": 1 }, { "asi": "bidease.com", "sid": "bidease_seller_8", "rid": "example", "hp": 1 } ] } } }, "ext": {} }
Vast video response sample
{ "id": "example", "seatbid": [ { "bid": [ { "id": "example", "impid": "example", "price": 0.22070965, "burl": "https://example/openrtb/bil/example/?r=9431508028157955&sid=__etgwfi3gwxp4rot51q5w8p1qpum87ubquiq734cyk11&adid=__qde5onqtudksxthoz7ffowc774c&p=${AUCTION_PRICE}&mw=", "adm": "<?xml version=\"1.0\" encoding=\"utf-8\" ?><VAST version=\"3.0\"><Ad id=\"example\"><InLine><AdSystem>example</AdSystem><AdTitle><![CDATA[example Ad]]></AdTitle><Error><![CDATA[https://example/example/SaveErrorEvent2?ssp=example&sid=__ribxjwihwk3k5a&err=[ERRORCODE]&r=]]></Error><Impression><![CDATA[https://example/example/SaveImpression2?ssp=example&sid=__46kxee1krsfsii7bme5ttfpzsqrtensen4dwz3fi94dfer&adid=__drmew3ji31d6wr47rpjtmcxwu71mpgzeh3ex9qkpa1&p=&mw=&hsed=__1y7nudrzkiw536pznebkj97687nfarrt5hogtq1io85wcz61gw69maujsn33mfdd56rzo8cy7grzqe3wnb&erid=&rdu=&r=]]></Impression><Impression><![CDATA[https://example/ddm/trackimp/example.example/exx.example;dc_trk_aid=example;dc_trk_cid=example;ord=example;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;gdpr=;gdpr_consent=;ltd=;dc_tdv=1?]]></Impression><Creatives><Creative><Linear skipoffset=\"00:00:05\"><Duration>00:00:05</Duration><TrackingEvents><Tracking event=\"start\"><![CDATA[https://example/example/SaveStartEvent2?ssp=example&sid=__fe9rg74h7dat9nxagbjhdmh1f6dtpribxjwihwk3k5a&r=]]></Tracking><Tracking event=\"skip\"><![CDATA[https://example/example/SaveSkipEvent2?ssp=example&sid=__ik8xzbdgcmzgeui7iae9rg74h7dat9nxaihwk3k5a&r=]]></Tracking><Tracking event=\"firstQuartile\"><![CDATA[https://example/example/SaveView2?ssp=example&sid=__examplegwjkpwm4yh9uwt4h5o9qq4a1ohzwj3gmwiowoe81cxynrucfpt7ssiduewajgrewfiao6&r=]]></Tracking><Tracking event=\"firstQuartile\"><![CDATA[https://example/example/SaveFirstQuartileEvent2?ssp=example&sid=__33_f7stte5fmdwfyfm3iik8xzbdgcmzgeui7iae9rg74h7dat9nxagbjhdmh1f6dtpribxjwihwk3k5a&r=]]></Tracking><Tracking event=\"midpoint\"><![CDATA[https://example/example/SaveMidpointEvent2?ssp=example&sid=__9rg74h7dat9nxagbjhdmh1f6dtpribxjwihwk3k5a&r=]]></Tracking><Tracking event=\"thirdQuartile\"><![CDATA[https://example/example/SaveThirdQuartileEvent2?ssp=example&sid=__exampledwfyfm3iik8xzbdgcmzgeui7iae9rg74h7dat9nxagbvjwihwk3k5a&r=]]></Tracking><Tracking event=\"complete\"><![CDATA[https://example/example/SaveCompleteEvent2?ssp=example&sid=__exampleat9nxagbjhdmh1f6dtpribxjwihwk3k5a&r=]]></Tracking><Tracking event=\"mute\"><![CDATA[https://example/example/SaveMuteEvent2?ssp=example&sid=__examplezgeui7iae9rg74h7dat9nxagbjhdmh1f6dtpribxjwihwk3k5a&r=]]></Tracking><Tracking event=\"unmute\"><![CDATA[https://example/example/SaveUnmuteEvent2?ssp=example&sid=__example5a&r=]]></Tracking><Tracking event=\"pause\"><![CDATA[https://example/example/SavePauseEvent2?ssp=example&sid=__examplepribxjwihwk3k5a&r=]]></Tracking><Tracking event=\"rewind\"><![CDATA[https://example/example/SaveRewindEvent2?ssp=example&sid=__exampledgcmzgeui7iae9rg74h7dat9nxaexamplek3k5a&r=]]></Tracking><Tracking event=\"resume\"><![CDATA[https://example/example/SaveResumeEvent2?ssp=example&sid=__exampledgcmzgeui7iae9rg74h7dexamplewihwk3k5a&r=]]></Tracking><Tracking event=\"fullscreen\"><![CDATA[https://example/example/SaveFullscreenEvent2?ssp=example&sid=__example3iik8xzbdgcmzgeui7iae9rgexamplebxjwihwk3k5a&r=]]></Tracking><Tracking event=\"expand\"><![CDATA[https://example/example/SaveExpandEvent2?ssp=example&sid=__exampletpribxjwihwk3k5a&r=]]></Tracking><Tracking event=\"collapse\"><![CDATA[https://example/example/SaveCollapseEvent2?ssp=example&sid=__example8xzbdgcmzgeui7iae9examplexjwihwk3k5a&r=]]></Tracking><Tracking event=\"acceptInvitation\"><![CDATA[https://example/example/SaveAcceptInvitationEvent2?ssp=example&sid=__examplenxagbjhdmh1f6dtpribxjwihwk3k5a&r=]]></Tracking><Tracking event=\"close\"><![CDATA[https://example/example/SaveCloseEvent2?ssp=example&sid=__example5a&r=]]></Tracking></TrackingEvents><VideoClicks><ClickThrough><![CDATA[https://example/example/SaveClick2?sid=__examplegsoj8xgnso4sbnbcy&ssp=example&bn=__examplebzrcuruqtf489ke4gj4r4nm1&hsed=__example8o1ws5juz1sfh7qmud74wgapus7wpr7bakmpe1h81ne4n5is667zm89mywmyyafcmkkyy9y1bqfgt5ns8x83gkkews5pr&erid=&di=&dst=__examplea3tq5y9j513smhfxrtrjuxrq8bbuktdwo1xcmh7nt7wzqqcsat7xktmpparu4spcd3oye7cahofxxg4hexampleg6g8i5uoqjcd5f8ajogrj8awhb153hurmx6tq15gde1owdttzfxi9zk3hua4ad3cwjho5mr1d77nn5yy9cuexampley&bct=&r=]]></ClickThrough></VideoClicks><MediaFiles><MediaFile delivery=\"progressive\" type=\"video/mp4\" bitrate=\"528\" width=\"320\" height=\"480\"><![CDATA[https://content.example.ai/example/0C/46/example.mp4]]></MediaFile></MediaFiles></Linear></Creative></Creatives><Extensions></Extensions></InLine></Ad></VAST>", "adid": "example", "adomain": [ "example" ], "iurl": "https://example.example.com/example/0C/46/example.mp4", "cid": "example", "crid": "example", "cat": [ "IAB1" ], "attr": [ 16 ], "protocol": 3, "w": 320, "h": 480, "exp": 3600, "dur": 5, "mtype": 2, "ext": { "duration": 5, "length": 5, "crtype": "VAST 3.0", "advertiser_name": "example/example", "advertisername": "example/example", "agency_name": "example", "agency_id": "example", "buyer_id": "example" } } ] } ], "bidid": "example", "cur": "USD" }
Native
Native request sample
{ "id": "example", "imp": [ { "id": "1", "native": { "request": "{\"native\":{\"assets\":[{\"id\":3,\"img\":{\"type\":1,\"w\":50,\"h\":50,\"wmin\":50,\"hmin\":50}},{\"id\":2,\"required\":1,\"img\":{\"type\":3,\"w\":627,\"h\":627,\"wmin\":627,\"hmin\":627}},{\"id\":1,\"required\":1,\"title\":{\"len\":50}},{\"id\":8,\"data\":{\"type\":1,\"len\":25}},{\"id\":4,\"data\":{\"type\":2,\"len\":150}},{\"id\":6,\"data\":{\"type\":3,\"len\":140}},{\"id\":5,\"required\":1,\"data\":{\"type\":12,\"len\":15}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1,2]}]}}" }, "displaymanager": "example", "displaymanagerver": "11.5.0", "tagid": "example", "bidfloorcur": "USD", "ext": {} } ], "bcat": [ "IAB26-4", "IAB26-2", "IAB25-6", "IAB25-5", "IAB25-4", "IAB25-3", "IAB25-1", "IAB25-7", "IAB8-18", "IAB26-3", "IAB26-1", "IAB8-5", "IAB25-2", "IAB11-4" ], "app": { "id": "example", "bundle": "com.example", "name": "example app name", "ver": "4.4", "storeurl": "https://play.google.com/store/apps/details?id=com.example", "cat": [ "IAB9-30" ], "publisher": { "id": "example", "name": "example" } }, "device": { "ifa": "example-043d9475c1d9", "devicetype": 4, "make": "example make", "model": "example model", "hwv": "example", "w": 180, "h": 300, "os": "android", "osv": "12.0.0", "ua": "Mozilla/5.0 (Linux; Android 12; example Build/LMY48Z; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/example ip Mobile Safari/537.36", "connectiontype": 2, "mccmnc": "example", "ip": "example ip", "geo": { "type": 2, "lat": example, "lon": example, "country": "USA", "region": "ny", "city": "New York", "zip": "example zip", "utcoffset": example, "ipservice": 3 }, "language": "en", "js": 1, "pxratio": 0.475, "ppi": 76, "ext": {} }, "user": { "id": "example-7f861619f3ed", "ext": {} }, "at": 1, "tmax": 500, "cur": [ "USD" ], "source": { "ext": { "schain": { "ver": "1.0", "complete": 1, "nodes": [ { "asi": "example.com", "sid": "example", "rid": "example", "hp": 1 }, { "asi": "bidease.com", "sid": "bidease_seller_26", "rid": "example", "hp": 1 } ] } } }, "ext": {} }
Native response sample
{ "id": "example", "seatbid": [ { "bid": [ { "id": "example", "impid": "1", "price": 0.051792182, "burl": "https://example/openrtb/bil/example/?r=6734117258029194&sid=examplembfidsks487u3qimtgfii9rezfa7eeorc9hmn8zd9575d8a66&adid=__examplebtaosncoqxx1icskqe659f9nqa6za457x138tycsb651z9tbem4hefpfie&p=${AUCTION_PRICE}&mw=", "adm": "{\"native\":{\"ver\":\"1.0\",\"assets\":[{\"id\":3,\"img\":{\"url\":\"https://example/example/AC/48/AC48147B3example0D56.jpg\",\"w\":50,\"h\":50}},{\"id\":2,\"img\":{\"url\":\"https://example/example/10/E2/example.png\",\"w\":627,\"h\":627}},{\"id\":1,\"title\":{\"text\":\"example title\"}},{\"id\":8,\"data\":{\"value\":\"examle\"}},{\"id\":4,\"data\":{\"value\":\"example\"}},{\"id\":5,\"data\":{\"value\":\"example\"}}],\"link\":{\"url\":\"https://example/example/SaveClick2?sid=__example63r4o344q8q99f4cpkr9iznh8giqqbq5rp7b539udguqg1j3gqmyioy3wit53yw&ssp=example&bn=__exampleqndq566mondutnfiyk5ocsoeoxkd5zwgycif3bofxzfqpfs1g5qzfo9brtz96jeeit6n&hsed=__33_1u4xeijgcdh91o5n9ezuwtzduj89obkic8gathbsfrmtyq7fde8uunyt7tzynwidmd1chc9w84njs1syqcg3onn7qyysr1mzkd1i41rcxuem16hgeb5jy1zjqusqdp45xgo4jz35o3ueq4zbsti9d1swyc&erid=2SDnjcVxTAR&di=&dst=__example3ox3it51p84jnu9q6tc4nnbod5t1kwfzayxqccn9c8nq333kno8tk4gizhtfx6ty4j36nqk7pttfr97xwq6fk9bi5u6y1ru687ywzw7akz3uhth59uw1ug&bct=&r=\"},\"imptrackers\":[\"https://example/Deexamplence/SaveImpression2?ssp=example&sid=__exampleddho9r7iz8yamo9igkbu853wqog4fwzznudbc1a13uywkeg9oca13t1pd1mw8yhaq&adid=__examplezd45pugkbudsjufjs53tejissyf6obfa9r6e6czpoksxbtgzaeaada6q8ezr&p=&mw=&hsed=__example8xstqo83gqwmd9qsj3oi9g6gsdszyixue7cxqwtpm5cff9qrpfut5wswp8t1t3m79jccbisgqa6opsedpce4urj5ro7hiijrj6roxtmdyczx5n1s58t&erid=example&rdu=&r=\"]}}", "adid": "example", "adomain": [ "example.com" ], "iurl": "https://example/Ad/Preview?scr=True&aid=example&w=&h=&prids=&uad=False", "cid": "example", "crid": "example", "cat": [ "IAB8" ], "exp": 5400, "mtype": 4, "ext": { "crtype": "native", "advertiser_name": "example // example // example", "advertisername": "example // example // example", "agency_name": "example", "agency_id": "example", "buyer_id": "example", "nroa": { "erid": "example", "contractor": { "inn": "example", "name": "example", "legal_form": "ul" }, "client": { "inn": "example", "name": "example", "legal_form": "ul" }, "initial_contract": { "id": "example", "ado_id": "example", "type": "example", "number": "example", "subject_type": "example", "action_type": "example", "sign_date": "example-03-17" } }, "erid": "example" } } ] } ], "bidid": "example", "cur": "USD" }
MRAID
MRAID request sample
{ "id": "example", "imp": [ { "id": "1", "banner": { "w": 320, "h": 480, "btype": [ 1, 4 ], "battr": [ 1, 2, 5, 8, 9, 14, 17 ], "api": [ 3, 5, 6, 7 ], "format": [ { "w": 320, "h": 480 } ], "pos": 7 }, "video": { "w": 320, "h": 480, "minduration": 5, "maxduration": 60, "protocols": [ 2, 3, 4, 5, 6, 7 ], "battr": [ 1, 2, 5, 8, 9, 14, 17 ], "api": [ 3, 5, 6, 7 ], "mimes": [ "video/mp4", "video/3gpp", "video/3gpp2", "video/x-m4v" ], "placement": 5, "skipafter": 5, "companiontype": [ 1, 2, 3 ], "ext": {} }, "displaymanager": "example", "displaymanagerver": "11.5.5", "instl": 1, "tagid": "example", "bidfloor": 0.01, "bidfloorcur": "USD", "ext": {} } ], "bcat": [ "IAB26-4", "IAB26-2", "IAB25-6", "IAB25-5", "IAB25-4", "IAB25-3", "IAB25-1", "IAB25-7", "IAB8-18", "IAB26-3", "IAB26-1", "IAB8-5", "IAB25-2", "IAB11-4" ], "app": { "id": "example", "bundle": "com.example", "name": "", "ver": "32.8", "storeurl": "https://play.google.com/store/apps/details?id=com.example", "cat": [ "IAB9-30" ], "publisher": { "id": "example", "name": "example" } }, "device": { "devicetype": 4, "make": "example make", "model": "example201", "hwv": "example", "w": 720, "h": 1600, "os": "android", "osv": "10.0.0", "ua": "Mozilla/5.0 (Linux; Android 10; example Build/QP1A.190711.020; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/example Mobile Safari/537.36", "dnt": 1, "lmt": 1, "connectiontype": 6, "carrier": "example carrier", "mccmnc": "example", "ip": "example ip", "geo": { "type": 2, "lat": example, "lon": example, "country": "USA", "region": "ny", "city": "New York", "zip": "example zip", "utcoffset": example, "ipservice": example }, "language": "en", "js": 1, "pxratio": 2, "ppi": 320, "ext": {} }, "user": { "id": "082dd124-exapmple-4295-a299-example", "ext": {} }, "at": 1, "tmax": 500, "cur": [ "USD" ], "source": { "ext": { "schain": { "ver": "1.0", "complete": 1, "nodes": [ { "asi": "example.com", "sid": "example", "rid": "example", "hp": 1 }, { "asi": "bidease.com", "sid": "example", "rid": "example", "hp": 1 } ] } } }, "ext": {} }
MRAID response sample
{ "id": "example", "seatbid": [ { "bid": [ { "id": "exampleid", "impid": "1", "price": 0.11, "burl": "https://example/openrtb/bil/1991/?r=43395&sid=_example6&adid=_examplep=${AUCTION_PRICE}&mw=", "adm": "<img height=\"0\" width=\"0\" style=\"display:none\" src=\"https://example/example/SaveImpression2?ssp=1111&sid=__examplepx3tbio6f3kp7z4rpwq5fjs3djuztske&adid=__33_wfy9gxtz1qfjnb647twos8qkq559gni674c7jkue5ndgqzcs3818fq6cywcgww6qjbguq5o6r3xuk&p=&mw=&hsed=__33_etx7qazmxkjskzt95jgtc45z56ftc38x5s3mc5t9mw75hwqugtg7hfjzjecxsh4e84rjukgsyjb8ec59oq9mn3zdpcebowfw9iyec&erid=&rdu=&r=\" /><span style=\"display:flex;justify-content:center;align-items:center;height:100%;line-height:0px;vertical-align:bottom;\"><span id=\"tx_container_yccbqcjxlu\" style=\"display:inline-block;line-height:0px;vertical-align:bottom;\"><span id=\"tx_mrw_container_yccbqcjxlu\" style=\"position:absolute;cursor:pointer;z-index:10;width:320px;height:480px;\"></span><iframe id=\"tx_frame_yccbqcjxlu\" name=\"tx_frame_yccbqcjxlu\" src=\"https://example/Ad/Load?ssp=example&sid=__33_eh45kcodi98gaodrwnhi5k9s4adiquhy6sp5x71uzoxbxspxirgcc1uwte3q9dw9bjqo89wpo4xrxhgjumhpo4xcy6uj936m5bb7gp7y&ctu=\" frameborder=\"0\" scrolling=\"no\" hspace=\"0\" vspace=\"0\" width=\"320\" height=\"480\" style=\"border:0px;width:320px;height:480px;\"></iframe></span><script src=\"mraid.js\"></script><script id=\"tx_script_yccbqcjxlu\" type=\"text/javascript\">var s=document.createElement(\"script\");s.type=\"text/javascript\";s.async=true;s.src=\"https://example/dsp.js\";var cdf=function(){var p={mcw:1,awh:0,clu:\"https://example/example/SaveClick2?sid=exampleowb8c9964nh9z3s1dwg9nsy1sxe3nfmoiy4nqn&ssp=exa96kjeyfpk5mtx8a3wkmn1d4scqi93c6khm49ryynudwfnjnrpatrttsahsiifsddq9x53gbt3gbd6n1trucf7r8nq4wic45fmcoui587uqyhmnc7qiaoadte8tq9qu65nkaw4ynxr49dc9639dh7cjuse81am8az784jnozac5hs63p67mnp3z3hwfjnn8u9c5hb87wpida4m1g1o&bct=&r=\"};var vu=[];_tx.load3(\"ycexamplecjxlu\",p,vu);};if(s.addEventListener){s.addEventListener(\"load\",cdf,false);}else if(s.readyState){s.onreadystatechange=cdf;}else if(s.attachEvent){s.attachEvent(\"onload\",cdf);}(document.getElementsByTagName(\"head\")[0] || document.getElementsByTagName(\"body\")[0]).appendChild(s);</script></span>", "adid": "example", "adomain": [ "example.com" ], "iurl": "https://example/example/3D/21/3D9A28.jpeg", "cid": "example", "crid": "example", "cat": [ "IAB18" ], "apis": [ 6 ], "api": 6, "w": 320, "h": 480, "exp": example, "mtype": 1, "ext": { "crtype": "MRAID 3.0", "advertiser_name": "example | example (example/) example", "advertisername": "example | example (example/) example", "agency_name": "example", "agency_id": "example", "buyer_id": "example" } } ] } ], "bidid": "example", "cur": "USD" }
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article