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`

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 6 days ago