Bid Responses
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), XML (for video), or Native Ad JSON response for native |
| 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. |
| iurl | string; optional | URL without cache-busting to an image that is representative of the content of the campaign for ad quality/safety checking. |
| ext | object | May contain skadn field if the creative is signed for iOS attribution and intended to be handled for install tracking by the SDK. May contain mf field containing MobileFuse specific fields. See Bid ext mf |
Bid ext mf
mf| Field | Type | Description |
|---|---|---|
| render_event | string | A URL which can be called for MFX to record Ad Renders |
| cache_event | string | A URL which can be called for MFX to record Ad Caches |
| sdk_click_event | string | A URL which can be called for MFX to record Clicks |
Bid Response Samples
Check the tabs below for different sample responses:
{
"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
}
]
}
]
}
{
"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-13"
],
"crid": "232401211",
"h": 1,
"price": 8.55,
"w": 1
}
]
}
]
}
{
"id": "8e9a999bd524b4fd652967e122f97bd5",
"bidid": "894b2e51afaf15a43e80af6e8d6f2ed8",
"seatbid": [
{
"bid": [
{
"id": "6c46edc41463db5dac1a240b32bb81fd_native",
"adomain": [
"mobilefuse.com"
],
"impid": "1",
"adm": "{\"imptrackers\":[\"https://mfx.mobilefuse.com/imp\"],\"link\":{\"url\":\"https://mobilefuse.com/native?imp=x\"},\"privacy\":\"https://mobilefuse.com/ad-privacy\",\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://mfx.mobilefuse.com/imp?id=x\"},{\"event\":1,\"method\":2,\"url\":\"https://mfx.mobilefuse.com/imp_tracker.js\"}],\"assets\":[{\"title\":{\"text\":\"Native Test Ad\"},\"id\":100},{\"img\":{\"type\":1,\"w\":102,\"h\":102,\"url\":\"https://cdn.mobilefuse.com/test-ads/native/mf_logo.png\"},\"id\":200},{\"video\":{\"vasttag\":\"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?><VAST version=\\\"2.0\\\"><Ad id=\\\"1\\\"><InLine><AdSystem>MobileFuse</AdSystem><AdTitle>Native Video Test Ad</AdTitle><Error><![CDATA[https://mobilefuse.com/]]></Error><Impression><![CDATA[https://mobilefuse.com/]]></Impression><Creatives><Creative sequence=\\\"1\\\"><Linear><Duration>00:00:30</Duration><TrackingEvents><Tracking event=\\\"complete\\\"><![CDATA[https://mobilefuse.com/]]></Tracking></TrackingEvents><VideoClicks><ClickThrough><![CDATA[https://mobilefuse.com/]]></ClickThrough><ClickTracking><![CDATA[https://mobilefuse.com/]]></ClickTracking></VideoClicks><MediaFiles><MediaFile delivery=\\\"progressive\\\" width=\\\"600\\\" height=\\\"500\\\" type=\\\"video/mp4\\\" bitrate=\\\"1000\\\" scalable=\\\"true\\\" maintainAspectRatio=\\\"true\\\"><![CDATA[https://cdn.mobilefuse.com/test-ads/native/video.mp4]]></MediaFile></MediaFiles></Linear></Creative></Creatives></InLine></Ad></VAST>\"},\"id\":300},{\"data\":{\"value\":\"MobileFuse.com\",\"type\":1},\"id\":400},{\"data\":{\"value\":\"This is a MobileFuse native test ad! The text you're reading is the description field\",\"type\":2},\"id\":401},{\"data\":{\"value\":\"mobilefuse.com/native\",\"type\":11},\"id\":402},{\"data\":{\"value\":\"Download\",\"type\":12},\"id\":403}]}",
"crid": "test_native",
"h": 0,
"price": 1.008,
"w": 0,
"lurl": "https://mfx.mobilefuse.com/lurl?reqid=6c46edc41463db5dac1a240b32bb81fd&loss=${AUCTION_LOSS}&price=${AUCTION_PRICE}",
"exp": 3600,
"ext": {
"mf": {
"media_type": "native"
}
}
}
],
"seat": "mf"
}
]
}
Updated 5 months ago