Bid Response Specification
Note that all auctions utilize USD for currency.
4.2.1 Object: BidResponse
Field | Type | Description |
id | string | ID of the bid request to which this is a response. |
bidid | string | MobileFuse generated response ID to assist with logging/tracking |
seatbid | object | Array of seatbid objects. See 4.2.2 Object: SeatBid |
4.2.2 Object: SeatBid
Field | Type | Description |
seat | string | DSP buyer ID of bidder |
bid | array of objects | Array of 1+ Bid objects each related to an impression. Multiple bids can relate to the same impression. See 4.2.3 Object: Bid |
4.2.3 Object: Bid
Field | Type | Description |
id | string | ID of the bid request to which this is a response. |
impid | string | ID of the Imp object in the related bid request. |
price | float | The bid price expressed in USD CPM. |
adm | string | HTML markup of ad (for banner) or XML (for video) |
adomain | array of strings | A list of URLs associated with the brand of the creative in the bid. |
api | integer; optional | API required by the markup if applicable. Refer to OpenRTB 2.5 List 5.6. |
attr | array of integers; optional | Set of attributes describing the creative. Refer to OpenRTB 2.5 List 5.3. |
cat | array of strings; optional | IAB content categories of the creative. Refer to OpenRTB 2.5 List 5.1. |
crid | string; optional | Creative ID to assist with ad quality checking |
w | integer | The width of the creative, in pixels. |
h | integer | The height of the creative, in pixels. |
Bid Response Samples
Banner
{
"id": "a755c4161fdbe9eb7d237f39160f0508",
"bidid": "e6f80dde0ea0f562ef8683517f94bcb6",
"seatbid": [
{
"seat": "454",
"bid": [
{
"id": "7239058383128277756",
"adomain": [
"site.com"
],
"impid": "1",
"adm": "<script src=\"https://nym1-ib.adnxs.com/ab?an_audit=0&referrer=play.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.test&e=wqT_3QLvEOhvCAAAAwDWAAUBCI75kfkFEI7197zMxp-3eBjC_Oe789rEigoqNgkxULWbT1zgPxGNKO0NvjDZPxkAAAEC8MIIQCEhVudn1nHhPym3lzRG66jmPzEAAADA9Sj4PzDBgNkHOMwVQMYDSAJQ1eGhbVjp-kdgAGjZg5EBeMmUBYABAYoBA1VTRJIBA1VTRJgBrAKgAfoBqAEBsAEAuAECwAEFyAEC0AEC2AE34AEA8AEAigKVAXVmKCdhJywgNDQyMjQzNywgMTU5NjIyNjcwMik7dWYoJ2knLCA0MDY4MDAyLCAxNTk2MjI2NzAyKTt1ZignZycsIDExODI0MjYwLCAxNTkyHgAAYwE7FDE0NDQ5OUpZADByJywgMjI5MTQyNzQxNlsA9NMBkgLNBiF3Ykl6RkFpRXplRVRFTlhob1cwWUFDRHAta2N3QURnQVFBQkl4Z05Rd1lEWkIxZ0FZTG9FYUFCd0tuZ0FnQUZhaUFFQWtBRUJtQUVCb0FFQnFBRUJzQUVBdVFGemRkTkE2YWptUDhFQmMzWFRRT21vNWpfSkFRQUFBQUFBQVBBXzJRRUFBQUFBQUFEd1AtQUJvcVg0QWZVQkFBQmdRSmdDQUtBQ0FiVUNBQUFBQUwwQ0FBQUFBTUFDV3NnQ0FOQUNXdGdDQU9BQzZQSHdEdWdDMTQyUi1RWHlBZ1J6WWpneS1BSnVnQU1CbUFNQm9nTVhDS1R6eXcwUUFoZ0JMUUFBQUFBeUIyUmxabUYxYkhTaUF4UUk2UEh3RGhBSUdBQXRvOE9nUGpJRWMySTRNcUlERkFqbzhmQU9FQWtZQUMyanc2QS1NZ1J6WWpneW9nTU9DTmY2eWcwUUN4Z0NMUUFBQUFDb0E0WE40Uk82QXdsT1dVMHlPalF5TWpmZ0E2WWtnQVNWZ2RRRGlBVG42dllEa0FRQm1BUUJzZ1FKQ1BUNkRSQzd3TlVNc2dRSkNKcThCaENHNE5ZTXVnUVlDQ2NSTXpNek16TXo2ejhaQUFBIVYBATRnOVBvTnVnUVpDS1lERTFwDE5BX0cRDDhBQUFJSnE4QnNFRW1wbVoBAhA4VF9KQgEZDQEEMFENLSRNQWhRTmdFQVBFMa1kQUFBQ0lCWU1oa0FYcTRoaVlCWVhONFJPcEINMxhBUEFfc1FVASkJAQhNRUYJCRRBQURFREoFKBxPQjVudVFfMC4oAAROawUo8G1ZSFFZMURfZ0JaeXBCT29GSmdnREVpSUFBQU9pY2RkTjlnX3IxOVZKUGhYMGV6RERtZnM1QkhMajJHYXdrRVZObTlvVThBV0UyZEVGLUFXbDlvMENnZ1lEVlZORWlBWUFrQVlCbUFZQW9RWUFBQQWaLE1RS2dHQkxJR0pBawURBQEAQh3zBEJrBRMFAQBDHRhETGdHQ2cuLpoCiQEhWWhWcnFRNlEDJDZmcEhJQUFvQUQVNVRNUURvSlRsbE5Nam8wTWpJM1FLWWtTPT0AVREMDEFBQVcdDAhZWnElrRBtZkVfYR0YAGMNDPBVd0NGQWVBQS7YAqYR4ALNq1fqAjNwbGF5Lmdvb2dsZS5jb20vc3RvcmUvYXBwcy9kZXRhaWxzP2lkPWNvbS50YWdnZWRhcHDyAhEKBkFEVl9JRBIHNDSFtzTyAhIKBkNQR19JRBIIMY2RASkIBUNQBRSRh5DyAg4KCEFEVl9GUkVREgI0NfICDQoIUkVNX1VTRVISATDyAgwKBSEUQ09ERRIABQ8BWREPEAsKB0NQFQ4QEAoFSU8BYQgHNDClIwDyASEESU8VITgbCg9DVVNUT01fTU9ERUwBKzQIMzEyMDk3MDTyAh4KFjIeAExMRUFGX05BTUUSBHNiODLyAigKGjYhAAhBU1QBSmhJRklFRBIKMTU5NjIxMjk1MfICFAoIU1BMSVQFYxHv8FKAAwCIAwGQA-riGJgDFKADAaoDAMADrALIAwDSAzAIEBIkODYxNTRiZWUtMGQ0MS00OWMwLTg0NWUtMTEzNDkxYTZlMjQwGAEiBGRwaWTSAyoICpozAPB5ANgD-t9Z4AMA6AMC-AMAgAQAkgQJL29wZW5ydGIymAQAogQOMTcyLjU4LjE1OC4xOTWoBPHyArIEDAgAEAAYACAAMAA4ALgEAMAEAMgEANIEDTQ1NCNOWU0yOjQyMjfaBAIIAeAEAPAE1eGhbfoEEgkAAADAFAxCQBHhMRw48FPAggUNYy44AiCIBQGYBQCgBf8RAaABqgUgNTMyNjQ5NTllMmFmNDIzNDIyYTM2OTdiMzBhNmIwMjjABQDJBeGcHAAA8D_SBQkJCQx4AADYBQHgBQHwBefIFvoFBAgAEACQBgCYBgC4BgDBBgklJPA_0AZ82gYWChAJEBkBXBAAGADgBgHyBgIIAIAHAYgHAKAHAboHEQFHUBgAKgQxLU4tOOYeQAHIB8mUBdIHDRV3MBAAGADaBwYIABAAGAA.&s=802627974098a08cb74d40a3f5ea6581b61ae839&pp=0.3936\"></script><img src=\"https://mfx.mobilefuse.com/imp?reqid=53264959e2af423422a3697b30a6b028&resid=e6f80dde0ea0f562ef8683517f94bcb6&tagid=413671&dsp=apn&crid=229142741&did=405866&advid=369767&adom=site.com&w=300&h=250&r=MC4zOTM2&c=MC4yNw%3D%3D&st=454&bndl=com.test&ifa=86154bee-0d41-49c0-845e-113491a6e240&test=0&cb=1596226702.9612\" style=\"width:1px;height:1px;position:absolute\">",
"cat": [
"IAB3"
],
"crid": "229142741",
"h": 250,
"price": 2.7,
"w": 300
}
]
}
]
}
Video
{
"id": "af8e7e43501a34ffb3445002ca2918b4",
"bidid": "db6176f54245ce664ba15ccba621b6bf",
"seatbid": [
{
"seat": "2764",
"bid": [
{
"id": "8650286840235369327",
"adomain": [
"http://site.com"
],
"impid": "1",
"adm": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><VAST version=\"2.0\"><Ad id=\"232401211\"><Wrapper><AdSystem version=\"2.0\">adnxs</AdSystem><VASTAdTagURI><![CDATA[https://nym1-ib.adnxs.com/ab?an_audit=0&referrer=play.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.test&e=wqT_3QLnDaDnBgAAAwDWAAUBCJP5kfkFEMbn9aChs9DyOxiL2b-Yqp3hyggqNgkAAAECCBpAEQEHNAAAGkAZAAAAwB4FIEAhERIAKREJ0DEAAACAPQoaQDDf6qEIOMwVQMwVSAJQu9LobliOo3hgAGj45pIBeNWpBYABAYoBA1VTRJIBAQbwT5gBAaABAagBAbABALgBA8ABBMgBAtABANgBAOABAPABAIoCWXVmKCdhJywgMTEyNDcwOSwgMTU5NjIyNjcwNyk7dWYoJ2knLCAzNjg3MTEzRh0AMHInLCAyMzI0MDEyMTE2HwDwsJIClQQhcDEwZm93anY5UElVRUx2UzZHNFlBQ0NPbzNnd0FEZ0FRQVJJekJWUTMtcWhDRmdBWVBfX19fOFBhQUJ3QVhnQmdBRUJpQUVCa0FFQm1BRUJvQUVCcUFFRHNBRUF1UUVqNHIzVkFBQWFRTUVCSS1LOTFRQUFHa0RKQWMtX3dBTmpGZXNfMlFFQUFBQUFBQUR3UC1BQnlZWGhBZlVCQUFBQUFKZ0NBS0FDQUxVQwUlCEwwQwUI8FtNQUNBY2dDQWRBQ0FkZ0NBZUFDQU9nQ0FQZ0NBSUFEQVpnREFhZ0Q3X1R5RkxvRENVNVpUVEk2TkRVNU5PQURwaVNBQkxxZmhnU0lCTm1maGdTUUJBQ1lCQUhCQgVhCQEIeVFRCQkBAQhORUUBByxBQURBSVVEWUJBRHgJpQkBHGlBWHlJNmtGCQ4YQUE4RC14Qh0_CHdRVREbCEFBTRkoDEFBRFIuKAAAMi4oALBPQUZrTlluOEFXaTVkc0YtQVhsMGtTQ0JnTlZVMFNJQmdDUUJnR1lCZ0NoQmcNXyxCcEFxQVlCc2dZa0MdgABFHQwARx0MAEkdDDh1QVlvmgKJASE5aEE4Vnc2GQIkanFONElBUW9BRC0IIdlMRG9KVGxsTk1qbzBOVGswUUtZa1MRUQxQQV9VEQwMQUFBVx0MAFkdDABhHQwAYw0M8N53Q0ZBZUFBLtgCphHgAvTPVeoCRHBsYXkuZ29vZ2xlLmNvbS9zdG9yZS9hcHBzL2RldGFpbHM_aWQ9Y29tLm1lbG9uc2FwcC5wcml2YWN5bWVzc2VuZ2Vy8gIRCgZBRFZfSUQSBzExMjQ3MDnyAhIKBkNQR19JRBIIMTE5ODk2NjbyAhEKBUNQX0lEEgg0MzgyNTc3NfICDQoIQURWX0ZSRVESATDyAg0KCFJFTV9VU0VSEgEw8gIMCghBRFZfQ09ERRIA8gIMCghDUEdfQ09ERRIA8gILCgdDUF9DT0RFAQ4oEAoFSU9fSUQSBzNpvxjyAgsKB0lPFT44EwoPQ1VTVE9NX01PREVMASsUAPICGgoWMhYAIExFQUZfTkFNRQEdCB4KGjYdAAhBU1QBPhBJRklFRAEhHA0KCFNQTElUAU3wVQEwgAMAiAMBkAMAmAMUoAMBqgMAwAPgqAHIAwDSAzAIEBIkZDA1ZjViMmUtZjMyNy00ZmVhLThkM2MtMzBkYTNiMjQxZDFlGAEiBGRwaWTSAyoIChIkkjMA8HkA2APE0pYB4AMA6AMC-AMAgAQAkgQJL29wZW5ydGIymAQAogQMMTcyLjU2LjIwLjYzqAQAsgQOCAAQABicAyD6ATAAOAK4BADABADIBADSBA4yNzY0I05ZTTI6NDU5NNoEAggB4AQA8AS70uhuggUeY29tLm1lbG9uc04VAiCIBQGYBQCgBf8RAaABqgUgZTc1ODM5MmZjZTJjZmQ0M2U1ZjM0YjJhNDMxYWY4ZTLABQDJBckDFPA_0gUJCQkMPAAA2AUB4AUB8AWlkwH6BQQBsyiQBgGYBgC4BgDBBgklKPA_0AaYCtoGFgoQCREZAVwQABgA4AYE8gYCCACABwGIBwCgB0C6BxEBSFAYACoEMS1OLTj4HkAByAfVqQXSBw0VeDAQABgA2gcGCAAQABgA&s=b9561f7d56e4fa90fedd965678fe40977b751399&pp=6.5]]></VASTAdTagURI><Impression><![CDATA[https://ib.adnxs.com/nop]]></Impression><Impression><![CDATA[https://mfx.mobilefuse.com/imp?reqid=e758392fce2cfd43e5f34b2a431af8e2&resid=db6176f54245ce664ba15ccba621b6bf&tagid=414959&dsp=apn&crid=232401211&did=&advid=18853&adom=http%3A%2F%2Fsite.com&w=1&h=1&r=MTM%3D&c=NC41NQ%3D%3D&st=2764&bndl=com.test&ifa=d05f5b2e-f327-4fea-8d3c-30da3b241d1e&test=0&cb=1596226707.2428]]></Impression><Creatives><Creative AdID=\"232401211\"><Linear></Linear></Creative></Creatives></Wrapper></Ad></VAST>",
"cat": [
"IAB20-25",
"IAB20-21",
"IAB20-23",
"IAB20-15",
"IAB20-19",
"IAB20-24",
"IAB20-22",
"IAB20-8",
"IAB20-14",
"IAB20-5",
"IAB20-10",
"IAB20-11",
"IAB20-20",
"IAB20-2",
"IAB20-16",
"IAB20-4",
"IAB20-27",
"IAB20-13"
],
"crid": "232401211",
"h": 1,
"price": 8.55,
"w": 1
}
]
}
]
}