Versions Compared

Old Version 3

changes.mady.by.user Dan Barnett

Saved on

compared with

New Version 4

changes.mady.by.user Dan Barnett

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Bid Response Specification

Note that all auctions utilize USD for currency.

...

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

Code Block
languagejson
{
    "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

Code Block
{
    "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
                }
            ]
        }
    ]
}