Bid Responses

Bid Response Specification

Note that all auctions utilize USD for currency.

4.2.1 Object: BidResponse

FieldTypeDescription
idstringID of the bid request to which this is a response.
bididstringMobileFuse generated response ID to assist with logging/tracking
seatbidobjectArray of seatbid objects. See 4.2.2 Object: SeatBid

4.2.2 Object: SeatBid

FieldTypeDescription
seatstringDSP buyer ID of bidder
bidarray of objectsArray 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

FieldTypeDescription
idstringID of the bid request to which this is a response.
impidstringID of the Imp object in the related bid request.
pricefloatThe bid price expressed in USD CPM.
admstringHTML markup of ad (for banner), XML (for video), or Native Ad JSON response for native
adomainarray of stringsA list of URLs associated with the brand of the creative in the bid.
apiinteger; optionalAPI required by the markup if applicable. Refer to OpenRTB 2.5 List 5.6
attrarray of integers; optionalSet of attributes describing the creative. Refer to OpenRTB 2.5 List 5.3
catarray of strings; optionalIAB content categories of the creative. Refer to OpenRTB 2.5 List 5.1
cridstring; optionalCreative ID to assist with ad quality checking
wintegerThe width of the creative, in pixels.
hintegerThe height of the creative, in pixels.
iurlstring; optionalURL without cache-busting to an image that is representative of the content of the campaign for ad quality/safety checking.
extobjectMay 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

FieldTypeDescription
render_eventstringA URL which can be called for MFX to record Ad Renders
cache_eventstringA URL which can be called for MFX to record Ad Caches
sdk_click_eventstringA 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"
      }
    ]
}