Bid Response Fields for Web Inventory
The Bid Response contains one or more SeatBids, each with Bids specifying creative details, price, and targeting. Mandatory fields must follow the OpenRTB spec, while optional fields can improve targeting, analytics, and performance with Adagio’s DSP partners.
Adagio populates as many fields as possible among bid response objects and parameters. The content of each response depends on:
- the information provided in the original ad request,
- the data returned by bidders in their bid responses.
Bid Response Sample for Web
Section titled “Bid Response Sample for Web ”{ "id": "7389fb72-ff8e-49bb-b560-e72286fa4ac9", "seatbid": [ { "seat": "19116", "bid": [ { "id": "1", "impid": "1", "price": 1.2, "adm": "<a href=\"http://myadserver.com/click><img src=\"http://image.com/\"/><img src=\"http://myadserver.com/impression/1.0\"/></a>", "adomain": [ "advertiser.com" ], "cid": "123", "crid": "12", "w": 728, "h": 90 } ] } ], "cur": "USD"}{ "id": "7389fb72-ff8e-49bb-b560-e72286fa4ac9", "seatbid": [ { "seat": "19116", "bid": [ { "id": "1", "impid": "1", "price": 1.2, "adm": "<VAST version=\"4.2\" xmlns:_xmlns=\"xmlns\" _xmlns:xs=\"http://www.w3.org/2001/XMLSchema\" xmlns=\"http://www.iab.com/VAST\"><!-- FAKE BID RESPONSE VAST, copy from https://github.com/InteractiveAdvertisingBureau/VAST_Samples/blob/master/VAST%204.2%20Samples/Inline_Simple.xml but changed the MediaFiles and added Skippable extension. --><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=1&auction_id=de641c15-bace-4f80-8425-d21b4f62fecc&bid_id=1234567890&bid_ts=1736782132&bidder=onetag&breq_id=6f4f2034-7cfb-4e0b-813d-64f2c77b6ff3&bttl=300&buid=0&buids=0&cpm=7.144341&crea_id=creative111&ctry=FRA&curr=USD&discrp_adjst=0.03&domn=maville.com&dvc=4&environment=phone&h=0&it=ortb&ivt_adjst=0&lzy=0&mt=vidin&net_cpm=5.715472800000001&org_id=1004&os=ios&partid=2025011315&plcmt=unknown&pltfrm=web&plyr=other&pn=1&pv_id=bd79a205-fb2b-496f-921e-0890dd22ae1f&rpmadc_smpl=0&rule_id=2142&seat_id=5&seattyp=shared&site=maville&spr_id=201&sspv=3.0.0-gcp-ams&tiv=-1&url=https%3A%2F%2Fmaville.com%2F&ve=organic&vr=-1&w=0&src=vast&v=2]]></Impression></InLine></Ad></VAST>", "adomain": [ "advertiser.com" ], "cid": "123", "crid": "12", "apis": [ 2 ], "api": 2, "mtype": 2 } ], "seat": "5" } ], "cur": "USD"}{ "id": "7389fb72-ff8e-49bb-b560-e72286fa4ac9", "seatbid": [ { "seat": "19116", "bid": [ { "id": "1", "impid": "1", "price": 1.2, "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":4,\"required\":1,\"img\":{\"type\":3,\"url\":\"https://via.placeholder.com/300x250\",\"w\":300,\"h\":250}},{\"id\":3,\"required\":1,\"img\":{\"type\":1,\"url\":\"https://via.placeholder.com/50x50\",\"w\":50,\"h\":50}},{\"id\":2,\"required\":1,\"title\":{\"text\":\"A test Native Ad\",\"len\":50}},{\"id\":6,\"required\":1,\"data\":{\"type\":2,\"value\":\"Random text\"}},{\"id\":1,\"required\":1,\"data\":{\"type\":12,\"value\":\"Random text\"}},{\"id\":5,\"required\":0,\"data\":{\"type\":3,\"value\":\"3\"}}],\"link\":{\"url\":\"http://adserver.com/click?impid=102\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"http://burl.com\"},{\"event\":1,\"method\":2,\"url\":\"./jquery.js\"},{\"event\":1,\"method\":1,\"url\":\"http://adserver.com/native?impid=102\"},{\"event\":1,\"method\":1,\"url\":\"https://c-testing.4dex.io/imp-testing.gif?adg_com=0.2\\u0026adu_code=1\\u0026auction_id=de641c15-bace-4f80-8425-d21b4f62fecc\\u0026bid_id=1234567890\\u0026bid_ts=1736783118\\u0026bidder=pubmatic\\u0026breq_id=9ea346b2-d2af-4362-ac79-c891a2b25ca1\\u0026bttl=300\\u0026buid=0\\u0026buids=0\\u0026cpm=4.0465082\\u0026crea_id=creative111\\u0026ctry=FRA\\u0026curr=USD\\u0026discrp_adjst=0.033\\u0026domn=maville.com\\u0026dvc=4\\u0026environment=phone\\u0026h=1\\u0026it=ortb\\u0026ivt_adjst=0\\u0026lzy=0\\u0026mt=nat\\u0026net_cpm=3.23720656\\u0026org_id=1004\\u0026os=ios\\u0026partid=2025011315\\u0026plcmt=unknown\\u0026pltfrm=web\\u0026pn=1\\u0026pv_id=a0d53304-2375-4f74-aad8-2bebf90d7bc1\\u0026rpmadc_smpl=0\\u0026rule_id=20\\u0026seat_id=6\\u0026seattyp=shared\\u0026site=maville\\u0026spr_id=53\\u0026sspv=3.0.0-gcp-ams\\u0026tiv=-1\\u0026url=https%3A%2F%2Fmaville.com%2F\\u0026ve=organic\\u0026vr=-1\\u0026w=1\"}],\"privacy\":\"https://www.example.com/privacy-notice\"}", "adomain": [ "advertiser.com" ], "cid": "123", "crid": "12", "mtype": 4, "w": 1, "h": 1 } ], "seat": "5" } ], "cur": "USD"}