Private Marketplace (2.2)

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

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

Preferred Deal Bid Request

{
	"app":{ 
		"bundle":"defaultBundleId",
		"cat":[ 
			"IAB7-42"
		],
		"id":"5020478",
		"name":"defaultAppName",
		"publisher":{ 
			"id":"5020355",
			"name":"PublisherName"
		}
	},
	"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",
			"lat":42.360504,
			"lon":-71.0548,
			"metro":"506",
			"region":"MA",
			"type":2,
			"zip":"02109"
		},
		"ip":"50.255.150.200",
		"js":1,
		"language":"en",
		"make":"Apple",
		"model":"iPhone",
		"os":"iOS",
		"osv":"4.3.2",
		"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"
	},
	"ext":{ 
		"pchain":"07bcf65f187117b4:5020355"
	},
	"id":"7b410db4-db0a-4bdf-aee4-ff9086637e43",
	"imp":[ 
		{ 
			"banner":{ 
				"battr":[ 
					1,
					3,
					5,
					6,
					8,
					9
				],
				"btype":[ 
					1
				],
				"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":{ 

		}
	},
	"tmax":1500,
	"user":{ 
		"ext":{ 

		}
	}
}

Preferred Deal Bid Response

{
	"id":"openDealTwoBids",
	"seatbid":[ 
		{ 
			"bid":[ 
				{ 
					"id":"firstBidWithDealId",
					"impid":"1",
					"price":10.0,
					"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,
					"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"
				}
			]
		}
	]
}

Private Exchange

Private Exchange Bid Request

{
	"app":{ 
		"bundle":"defaultBundleId",
		"cat":[ 
			"IAB7-42"
		],
		"id":"5020562",
		"name":"defaultAppName",
		"publisher":{ 
			"id":"5020406",
			"name":"PublisherName"
		}
	},
	"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",
			"lat":42.360504,
			"lon":-71.0548,
			"metro":"506",
			"region":"MA",
			"type":2,
			"zip":"02109"
		},
		"ip":"50.255.150.200",
		"js":0,
		"language":"en",
		"make":"Apple",
		"model":"iPhone",
		"os":"iOS",
		"osv":"4.3.2",
		"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"
	},
	"ext":{ 
		"pchain":"07bcf65f187117b4:5020406"
	},
	"id":"d512d096-0253-49f0-82e2-e6563344bab0",
	"imp":[ 
		{ 
			"banner":{ 
				"battr":[ 
					1,
					3,
					5,
					6,
					8,
					9
				],
				"btype":[ 
					1,
					3
				],
				"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":{ 

		}
	},
	"tmax":1499,
	"user":{ 
		"ext":{ 

		}
	}
}

Private Exchange Bid Response

{
	"id":"dspForPX",
	"seatbid":[ 
		{ 
			"bid":[ 
				{ 
					"id":"dspForPX",
					"impid":"1",
					"price":99.0,
					"adid":"534365",
					"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:03 pm