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"
}
Last Modified: November 29, 2021 at 2:00 pm