Private Marketplace (2.5)

Here you will find example preferred deal and private exchange bid requests and responses for OpenRTB 2.5

Preferred Deals:

A preferred deal (PD) is a deal ID-driven programmatic 1-on-1 integration/relationship with a publisher. The publisher creates a deal ID and sets or negotiates a rate that the buyer can accept (by submitting a valid bid response) or decline (by not submitting a valid bid response) on an impression-by-impression basis.

Private Exchange:

Also known as private or closed auction; similar to a preferred deal, a private exchange (PX) is a closed-exchange setup where up to 25 DSPs with the PX’s deal ID can bid on a publisher’s traffic. There’s no fixed rate. Instead, there is a floor price which is also submitted in the bid request.

Preferred Deal

Bid Request

{
  "allimps": 0,
  "app": {
    "bundle": "defaultBundleId",
    "cat": [
      "IAB7-42"
    ],
    "id": "256",
    "name": "defaultAppName",
    "publisher": {
      "id": "5020355",
      "name": "PublisherName"
    },
    "storeurl": "https://itunes.apple.com/app/apple-store/id953922567567341232323"
  },
  "bcat": [
    "IAB17-18",
    "IAB7-42",
    "IAB23",
    "IAB7-28",
    "IAB26",
    "IAB25",
    "IAB9-9",
    "IAB24"
  ],
  "device": {
    "connectiontype": 0,
    "devicetype": 4,
    "didmd5": "d1c553888076489a45af4b6dfb9392eb",
    "didsha1": "81407cd1808b59681f2da1341d8ac62dfa9293fa",
    "geo": {
      "city": "Boston",
      "country": "USA",
      "ipservice": 3,
      "lat": 42.360504,
      "lon": -71.0548,
      "metro": "506",
      "region": "MA",
      "type": 2,
      "zip": "02109"
    },
    "h": 480,
    "ip": "50.255.150.200",
    "js": 1,
    "language": "en",
    "make": "Apple",
    "model": "iPhone",
    "os": "iOS",
    "osv": "4.3.2",
    "pxratio": 1,
    "ua": "Mozilla/5.0 (iPhone; U; CPU iPhone OS 4_3_2 like Mac OS X; en-us) AppleWebKit/533.17.9 (KHTML, like Gecko) Version/5.0.2 Mobile/8H7 Safari/6533.18.5",
    "w": 320
  },
  "id": "136c8024-1688-4110-95af-daf3a8468e3d",
  "imp": [
    {
      "banner": {
        "battr": [
          1,
          3,
          5,
          6,
          8,
          9
        ],
        "btype": [
          1
        ],
        "format": [
          {
            "h": 50,
            "w": 320
          }
        ],
        "h": 50,
        "mimes": [
          "image/jpeg",
          "image/png",
          "image/gif",
          "text/javascript",
          "application/javascript"
        ],
        "pos": 0,
        "w": 320
      },
      "displaymanager": "SOMA",
      "ext": {
        "strictbannersize": 0
      },
      "id": "1",
      "instl": 0,
      "pmp": {
        "deals": [
          {
            "at": 3,
            "bidfloor": 1,
            "bidfloorcur": "USD",
            "id": "deal-id-with-bid"
          }
        ],
        "private_auction": 1
      },
      "secure": 0,
      "tagid": "5020478"
    }
  ],
  "regs": {
    "coppa": 0,
    "ext": {
      
    }
  },
  "source": {
    "pchain": "07bcf65f187117b4:5020355"
  },
  "tmax": 1498,
  "user": {
    "ext": {
      
    }
  }
}

Bid Response

{
  "id": "openDealTwoBids",
  "seatbid": [
    {
      "bid": [
        {
          "id": "firstBidWithDealId",
          "impid": "1",
          "price": 10.0,
          "burl":"http://us-east-user.demo.net/bill_notice/smaato_bid?rid=2G2J5QmI7JIKuEoeOyv-Fob7-MI19Iwm6q7tBiURHo8KCBFQ1tLBZTZHYH66VyIYN5amxUtCifKIY_l6IzDfJmiku4ukesiP5GdMtQ-0WRWnbtImXV7MWGTRUV23mQhIN9n8lAe_GfyhvwBOYX3ZcQEG8rlKkdBMM9iWRmAW25QjbJ6p6uS6KpTkujKcXqDXeDn76blEVDMdsOtyAd8871FPeN8MHxWK4bSKHy8uwN5P_LEMJL87i3yBG4UaZnxm--KUTpdLGo_ZqNmIQclot1VbuTcWZu9Z_wlDpq62FmP6vKHOs5o73onK9xlhP8IWiM_jEZGozvP7EHQiA0wpZ9jDKyEwUkLGkj_XyMkGqTjhjyeskjEbP5RAFojdXNp4EfuiVt6q-ToRHZ_Pjsq3HOurWfmZl2TVig7JAOVpYBt-sV8Nwiw67oxN3R1rQfhsHvhMBcFapqiAu0sOlNmMyJjwCAThPYX2eii3xy9MUe6KXUJSAcxj6xPFHM-TIm9KHKhFrilqpk6E2-8GLBIGoVMbKojd74bf9i5qIG14HJEb99zoHxG5rh_nXJ4DytgftwphiiKRmqSkpEIxsCjj0mGfeOXVWDBNpHF2GJ738XF9DTSE33IUkfYD7Ug&p=${AUCTION_PRICE}&aid=",
          "lurl":"http://us-east-user.demo.net/bidloss?lossreason=${AUCTION_LOSS}",
          "nurl": "http://ajkfkjd.net/winnotice/win",
          "adm": "<ad xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:noNamespaceSchemaLocation=\"smaato_ad_v0.9.xsd\" modelVersion=\"0.9\"><imageAd><imgUrl>http://ajkfkjd.net/images/image.png</imgUrl><clickUrl>http://ajkfkjd.net/click</clickUrl><width>320</width><height>50</height></imageAd></ad>",
          "adomain": [
            "example.com"
          ],
          "iurl": "http://ajkfkjd.net/images/image.png",
          "cid": "11111111111",
          "crid": "222222222",
          "dealid": "deal-id-with-bid"
        }
      ]
    },
    {
      "bid": [
        {
          "id": "secondBidWithoutDealId",
          "impid": "1",
          "price": 10.0,
          "burl":"http://us-east-user.demo.net/bill_notice/smaato_bid?rid=2G2J5QmI7JIKuEoeOyv-Fob7-MI19Iwm6q7tBiURHo8KCBFQ1tLBZTZHYH66VyIYN5amxUtCifKIY_l6IzDfJmiku4ukesiP5GdMtQ-0WRWnbtImXV7MWGTRUV23mQhIN9n8lAe_GfyhvwBOYX3ZcQEG8rlKkdBMM9iWRmAW25QjbJ6p6uS6KpTkujKcXqDXeDn76blEVDMdsOtyAd8871FPeN8MHxWK4bSKHy8uwN5P_LEMJL87i3yBG4UaZnxm--KUTpdLGo_ZqNmIQclot1VbuTcWZu9Z_wlDpq62FmP6vKHOs5o73onK9xlhP8IWiM_jEZGozvP7EHQiA0wpZ9jDKyEwUkLGkj_XyMkGqTjhjyeskjEbP5RAFojdXNp4EfuiVt6q-ToRHZ_Pjsq3HOurWfmZl2TVig7JAOVpYBt-sV8Nwiw67oxN3R1rQfhsHvhMBcFapqiAu0sOlNmMyJjwCAThPYX2eii3xy9MUe6KXUJSAcxj6xPFHM-TIm9KHKhFrilqpk6E2-8GLBIGoVMbKojd74bf9i5qIG14HJEb99zoHxG5rh_nXJ4DytgftwphiiKRmqSkpEIxsCjj0mGfeOXVWDBNpHF2GJ738XF9DTSE33IUkfYD7Ug&p=${AUCTION_PRICE}&aid=",
          "lurl":"http://us-east-user.demo.net/bidloss?lossreason=${AUCTION_LOSS}",
          "nurl": "http://ajkfkjd.net/winnotice/win",
          "adm": "<ad xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:noNamespaceSchemaLocation=\"smaato_ad_v0.9.xsd\" modelVersion=\"0.9\"><imageAd><imgUrl>http://ajkfkjd.net/images/image.png</imgUrl><clickUrl>http://ajkfkjd.net/click</clickUrl><width>320</width><height>50</height></imageAd></ad>",
          "adomain": [
            "example.com"
          ],
          "iurl": "http://ajkfkjd.net/images/image.png",
          "cid": "11111111111",
          "crid": "222222222"
        }
      ]
    }
  ]
}

PrivateExchange

Bid Request

{
  "allimps": 0,
  "app": {
    "bundle": "defaultBundleId",
    "cat": [
      "IAB7-42"
    ],
    "id": "307",
    "name": "defaultAppName",
    "publisher": {
      "id": "5020406",
      "name": "PublisherName"
    },
    "storeurl": "https://itunes.apple.com/app/apple-store/id953922567567341232323"
  },
  "at": 2,
  "bcat": [
    "IAB17-18",
    "IAB7-42",
    "IAB23",
    "IAB7-28",
    "IAB26",
    "IAB25",
    "IAB9-9",
    "IAB24"
  ],
  "device": {
    "connectiontype": 0,
    "devicetype": 4,
    "didmd5": "d1c553888076489a45af4b6dfb9392eb",
    "didsha1": "81407cd1808b59681f2da1341d8ac62dfa9293fa",
    "geo": {
      "city": "Boston",
      "country": "USA",
      "ipservice": 3,
      "lat": 42.360504,
      "lon": -71.0548,
      "metro": "506",
      "region": "MA",
      "type": 2,
      "zip": "02109"
    },
    "h": 480,
    "ip": "50.255.150.200",
    "js": 0,
    "language": "en",
    "make": "Apple",
    "model": "iPhone",
    "os": "iOS",
    "osv": "4.3.2",
    "pxratio": 1,
    "ua": "Mozilla/5.0 (iPhone; U; CPU iPhone OS 4_3_2 like Mac OS X; en-us) AppleWebKit/533.17.9 (KHTML, like Gecko) Version/5.0.2 Mobile/8H7 Safari/6533.18.5",
    "w": 320
  },
  "ext": {
    "udi": {
      "googlednt": 0,
      "idfatracking": 0,
    }
  },
  "id": "93cd8f83-c5c7-44ed-8294-01c9d7de81fc",
  "imp": [
    {
      "banner": {
        "battr": [
          1,
          3,
          5,
          6,
          8,
          9
        ],
        "btype": [
          1,
          3
        ],
        "format": [
          {
            "h": 50,
            "w": 320
          }
        ],
        "h": 50,
        "mimes": [
          "image/jpeg",
          "image/png",
          "image/gif"
        ],
        "pos": 0,
        "w": 320
      },
      "bidfloor": 0,
      "bidfloorcur": "USD",
      "displaymanager": "SOMA",
      "ext": {
        "strictbannersize": 0
      },
      "id": "1",
      "instl": 0,
      "pmp": {
        "deals": [
          {
            "at": 2,
            "bidfloor": 3.4,
            "bidfloorcur": "USD",
            "id": "83fafb25-09d2-4ace-812a-70c260cdf70c"
          }
        ],
        "private_auction": 1
      },
      "secure": 0,
      "tagid": "5020562"
    }
  ],
  "regs": {
    "coppa": 0,
    "ext": {
      
    }
  },
  "source": {
    "pchain": "07bcf65f187117b4:5020406"
  },
  "tmax": 1499,
  "user": {
    "ext": {
      
    }
  }
}

Bid Response

{
  "id": "dspForPX",
  "seatbid": [
    {
      "bid": [
        {
          "id": "dspForPX",
          "impid": "1",
          "price": 99.0,
          "adid": "534365",
          "burl":"http://us-east-user.demo.net/bill_notice/smaato_bid?rid=2G2J5QmI7JIKuEoeOyv-Fob7-MI19Iwm6q7tBiURHo8KCBFQ1tLBZTZHYH66VyIYN5amxUtCifKIY_l6IzDfJmiku4ukesiP5GdMtQ-0WRWnbtImXV7MWGTRUV23mQhIN9n8lAe_GfyhvwBOYX3ZcQEG8rlKkdBMM9iWRmAW25QjbJ6p6uS6KpTkujKcXqDXeDn76blEVDMdsOtyAd8871FPeN8MHxWK4bSKHy8uwN5P_LEMJL87i3yBG4UaZnxm--KUTpdLGo_ZqNmIQclot1VbuTcWZu9Z_wlDpq62FmP6vKHOs5o73onK9xlhP8IWiM_jEZGozvP7EHQiA0wpZ9jDKyEwUkLGkj_XyMkGqTjhjyeskjEbP5RAFojdXNp4EfuiVt6q-ToRHZ_Pjsq3HOurWfmZl2TVig7JAOVpYBt-sV8Nwiw67oxN3R1rQfhsHvhMBcFapqiAu0sOlNmMyJjwCAThPYX2eii3xy9MUe6KXUJSAcxj6xPFHM-TIm9KHKhFrilqpk6E2-8GLBIGoVMbKojd74bf9i5qIG14HJEb99zoHxG5rh_nXJ4DytgftwphiiKRmqSkpEIxsCjj0mGfeOXVWDBNpHF2GJ738XF9DTSE33IUkfYD7Ug&p=${AUCTION_PRICE}&aid=",
          "lurl":"http://us-east-user.demo.net/bidloss?lossreason=${AUCTION_LOSS}",
          "nurl": "http://ajkfkjd.net/winnotice/win?dspForPX",
          "adm": "<ad xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:noNamespaceSchemaLocation=\"smaato_ad_v0.9.xsd\" modelVersion=\"0.9\"><imageAd><imgUrl>http://ajkfkjd.net/images/image.png</imgUrl><clickUrl>http://ajkfkjd.net/click</clickUrl><width>320</width><height>50</height></imageAd></ad>",
          "adomain": [
            "example.com"
          ],
          "iurl": "http://ajkfkjd.net/images/image.png?dspForPX",
          "cid": "435435435",
          "crid": "435435",
          "attr": [
          ],
          "dealid": "83fafb25-09d2-4ace-812a-70c260cdf70c"
        }
      ],
      "seat": "seat1",
      "group": 0
    }
  ],
  "bidid": "dspForPX_bidid",
  "cur": "USD"
}
Doc Feedback Product Feedback

Last Modified: November 29, 2021 at 2:00 pm