Details

To transact Private Marketplace Deals (Preferred Deal/Private Exchange), Smaato offers two options, depending on the Buyer's standard:

OpenRTB 2.0/2.1: Extension Object

OpenRTB 2.2 or later: PMP/Direct Deal Object (dealid)

What's a Deal ID?

Deal ID, or deal identifier, is the unique number of an automated ad buy, usually an alphanumeric string, e.g. f4eeb063-c564-45e4-9da3-4929de5943b5.

What's a Preferred Deal?

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.

What's a 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.

PMP/Direct Deal Object (2.4)

Bid Request (iOS)

{
  "id":"CxU0032U8a",
  "at":2,
  "allimps":0,
  "imp":[
    {
      "id":"1",
      "banner":{
        "w":320,
        "h":50,
        "format":[
          {
            "w":320,
            "h":50
          }
        ],
        "btype":[
          1,
          3
        ],
        "battr":[
          1,
          3,
          5,
          6,
          8,
          9
        ],
        "pos":0,
        "mimes":[
          "image/jpeg",
          "image/png",
          "image/gif"
        ],
        "api":[

        ]
      },
      "ext":{
        "strictbannersize":0
      },
      "pmp":{
        "private_auction":1,
        "deals":[
          {
            "id":"4bd3cdd8-2d58-4a68-8e34-632e74218029",
            "at":2,
            "bidfloorcur":"USD",
            "bidfloor":8.0
          }
        ]
      },
      "instl":0,
      "displaymanager":"SOMA",
      "tagid":"101000124",
      "secure":0
    }
  ],
  "device":{
    "geo":{
      "lat":53.550003,
      "lon":10.0,
      "ipservice":3,
      "country":"DEU",
      "region":"04",
      "zip":"20099",
      "metro":"0",
      "city":"Hamburg",
      "type":2
    },
    "make":"Apple",
    "model":"iPhone",
    "os":"iOS",
    "osv":"6.1",
    "ua":"Mozilla/5.0 (iPhone; CPU iPhone OS 6_1_4 like Mac OS X) AppleWebKit/536.26 (KHTML, like Gecko) Version/6.0 Mobile/10B350 Safari/8536.25",
    "ip":"201.252.0.0",
    "js":0,
    "connectiontype":0,
    "ifa":"e4273e31-97a9-4b29-93a8-8a99f0cea068",
    "devicetype":1,
    "didsha1":"31f455635a12252f8cedb39cd7533fc58a064bff",
    "didmd5":"af2d48f2495881aed1737bb21017f9b6",
    "dpidsha1":"a5ab171d2c5551c4b0552b6280b42b578e08e490",
    "dpidmd5":"285a23d862ebbec44bd5520643e2a9eb",
    "macsha1":"d76f4f17da290fb7b96d953a1b9a01a733cf4d9d",
    "macmd5":"f244cddbc7f5161e9dcd758d0c3d7796"
  },
  "app":{
    "id":"1000049",
    "name":"PrivateExchange_private_exchange_320x50_iOS_XXLARGE_320x50_IAB1",
    "domain":"www.smaato.com",
    "cat":[
      "IAB1"
    ],
    "storeurl":"www.smaato.com",
    "keywords":"",
    "publisher":{
      "id":"1001008809",
      "name":"PrivateExchange_private_exchange_320x50_iOS_XXLARGE_320x50_IAB1"
    }
  },
  "bcat":[
    "IAB17-18",
    "IAB7-42",
    "IAB23",
    "IAB11",
    "IAB7-28",
    "IAB26",
    "IAB25",
    "IAB9-9",
    "IAB24"
  ],
  "badv":[
    "4chan.com"
  ],
  "ext":{
    "udi":{
      "imei":"356938035643809",
      "imeimd5":"af2d48f2495881aed1737bb21017f9b6",
      "imeisha1":"31f455635a12252f8cedb39cd7533fc58a064bff",
      "macmd5":"f244cddbc7f5161e9dcd758d0c3d7796",
      "macsha1":"d76f4f17da290fb7b96d953a1b9a01a733cf4d9d",
      "odin":"d76f4f17da290fb7b96d953a1b9a01a733cf4d9d"
    },
    "operaminibrowser":0,
    "carriername":"unknown - probably WLAN"
  },
  "regs":{
    "coppa":0,
    "ext":{
      "gdpr":1
    }
  },
  "user":{
    "keywords":"",
    "ext":{
      "consent":"BONZC5sONZC5sAAABAENAAoAAAAFIgAAAAAAAAAAAAI"
    }
  }
}

Bid Request (Android)

{
  "id":"CxU0032U8a",
  "at":2,
  "allimps":0,
  "imp":[
    {
      "id":"1",
      "banner":{
        "w":320,
        "h":50,
        "format":[
          {
            "w":320,
            "h":50
          }
        ],
        "btype":[
          1,
          3
        ],
        "battr":[
          1,
          3,
          5,
          6,
          8,
          9
        ],
        "pos":0,
        "mimes":[
          "image/jpeg",
          "image/png",
          "image/gif"
        ],
        "api":[

        ]
      },
      "ext":{
        "strictbannersize":0
      },
      "pmp":{
        "private_auction":1,
        "deals":[
          {
            "id":"4bd3cdd8-2d58-4a68-8e34-632e74218029",
            "at":2,
            "bidfloorcur":"USD",
            "bidfloor":8.0
          }
        ]
      },
      "instl":0,
      "displaymanager":"SOMA",
      "tagid":"101000124",
      "secure":0
    }
  ],
  "device":{
    "geo":{
      "lat":53.550003,
      "lon":10.0,
      "ipservice":3,
      "country":"DEU",
      "region":"04",
      "zip":"20099",
      "metro":"0",
      "city":"Hamburg",
      "type":2
    },
    "make":"Google",
    "model":"Nexus 6P",
    "os":"Android",
    "osv":"6.0",
    "ua":"Mozilla/5.0 (Linux; Android 6.0; Nexus 6P Build/MDA83) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/45.0.2454.94 Mobile Safari/537.36",
    "ip":"201.252.0.0",
    "js":0,
    "connectiontype":0,
    "devicetype":1,
    "didsha1":"31f455635a12252f8cedb39cd7533fc58a064bff",
    "didmd5":"af2d48f2495881aed1737bb21017f9b6",
    "dpidsha1":"a5ab171d2c5551c4b0552b6280b42b578e08e490",
    "dpidmd5":"285a23d862ebbec44bd5520643e2a9eb",
    "macsha1":"d76f4f17da290fb7b96d953a1b9a01a733cf4d9d",
    "macmd5":"f244cddbc7f5161e9dcd758d0c3d7796"
  },
  "app":{
    "id":"1000049",
    "name":"PrivateExchange_private_exchange_320x50_iOS_XXLARGE_320x50_IAB1",
    "domain":"www.smaato.com",
    "cat":[
      "IAB1"
    ],
    "storeurl":"www.smaato.com",
    "keywords":"",
    "publisher":{
      "id":"1001008809",
      "name":"PrivateExchange_private_exchange_320x50_iOS_XXLARGE_320x50_IAB1"
    }
  },
  "bcat":[
    "IAB17-18",
    "IAB7-42",
    "IAB23",
    "IAB11",
    "IAB7-28",
    "IAB26",
    "IAB25",
    "IAB9-9",
    "IAB24"
  ],
  "badv":[
    "4chan.com"
  ],
  "ext":{
    "udi":{
      "androidid":"3840000210b96e40",
      "androididmd5":"285a23d862ebbec44bd5520643e2a9eb",
      "androididsha1":"a5ab171d2c5551c4b0552b6280b42b578e08e490",
      "imei":"356938035643809",
      "imeimd5":"af2d48f2495881aed1737bb21017f9b6",
      "imeisha1":"31f455635a12252f8cedb39cd7533fc58a064bff",
      "macmd5":"f244cddbc7f5161e9dcd758d0c3d7796",
      "macsha1":"d76f4f17da290fb7b96d953a1b9a01a733cf4d9d",
      "odin":"d76f4f17da290fb7b96d953a1b9a01a733cf4d9d"
    },
    "operaminibrowser":0,
    "carriername":"unknown - probably WLAN"
  },
  "regs":{
    "coppa":0,
    "ext":{
      "gdpr":1
    }
  },
  "user":{
    "keywords":"",
    "ext":{
      "consent":"BONZC5sONZC5sAAABAENAAoAAAAFIgAAAAAAAAAAAAI"
    }
  }
}

Bid Response

{
  "id": "dsp-below-floor-price",
  "seatbid": [
	{
  	"seat": "seatdeal1",
  	"bid": [
    	{
      	"impid": "1",
      	"price": 4.0,
      	"id": "image-ad1",
      	"adm": "<ad xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:noNamespaceSchemaLocation=\"smaato_ad_v0.9.xsd\" modelVersion=\"0.9\">
					<imageAd>
						<imgUrl>http://soma.smaatolabs.net/image</imgUrl>
						<clickUrl>http://soma.smaatolabs.net/click</clickUrl>
						<width>320</width>
						<height>50</height>
					</imageAd>
				</ad>",
      	"adomain": [
        	"http://soma.smaatolabs.net"
      	],
      	"crid": "16969426",
      	"cid": "2445",
      	"iurl": "http://soma.smaatolabs.net:3001/image",
      	"nurl": "https://soma-bidder.smaatolabs.net/win",
      	"dealid": "b2ca4a36-3b6d-449b-b741-7900545db4de"
    	}
  	]
	}
  ]
}

PMP/Direct Deal Object (2.2)

Bid Request

{
  "app": {
    "cat": [
      "IAB3"
    ],
    "domain": "www.smaato.com",
    "id": "101000000",
    "name": "PreferredDeal_PreferredDealSingleAuctionSuccessUATestCase_iOS_XXLARGE_320x50_IAB3",
    "publisher": {
      "id": "1001000000",
      "name": "PreferredDeal_PreferredDealSingleAuctionSuccessUATestCase_iOS_XXLARGE_320x50_IAB3"
    }
  },
  "badv": [
    "8anch.com"
  ],
  "bcat": [
    "IAB7-28",
    "IAB17-18",
    "IAB26",
    "IAB25",
    "IAB7-42",
    "IAB9-9",
    "IAB24",
    "IAB23",
    "IAB11"
  ],
  "device": {
    "connectiontype": 0,
    "devicetype": 1,
	"dnt":0,
	"ifa":"F585B1EF-D543-4F9C-A39F-A204BD9C1E33",
    "didsha1":"03791cf87e352da6434e4d964f54f0f64db933aa",
    "didmd5":"68b329da9893e34099c7d8ad5cb9c940",
    "dpisha1":"bfc523f83fa54a19e7b2d8bdf8acd687a09fba09",
	"dpimd5":"223632c428784fecaaa3e2a6aaaf6d8e",
    "geo": {
      "city": "Hamburg",
      "country": "DEU",
      "lat": 53.550003,
      "lon": 10.0,
      "metro": "0",
      "region": "04",
      "type": 2,
      "zip": "20099"
    },
    "ip": "95.90.255.47",
    "js": 0,
    "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": {
    "carriername": "unknown - probably WLAN",
    "operaminibrowser": 0,
    "udi":{
        "atuid":"edc22bd4-aa58-f32a-63b7-8c7fcadfb1b7",
        "idfa":"F585B1EF-D543-4F9C-A39F-A204BD9C1E33",
        "idfatracking":1
    }
  },
  "id": "FVdBNIomFK",
  "imp": [
    {
      "banner": {
        "btype": [
          1,
          3
        ],
        "h": 50,
        "mimes": [
          "image/png",
          "image/jpeg",
          "image/gif"
        ],
        "pos": 0,
        "w": 320
      },
      "displaymanager": "SOMA",
      "id": "1",
      "instl": 0,
      "pmp": {
        "deals": [
          {
            "at": 3,
            "bidfloor": 8.0,
            "bidfloorcur": "USD",
            "id": "35b58a32-d954-4472-989c-b5133655f3d3"
          }
        ],
        "private_auction": 1
      },
      "secure": 0
    }
  ],
  "regs": {
    "coppa": 0
  },
  "user": {}
}

Bid Response

{
  "id": "dsp-below-floor-price",
  "seatbid": [
	{
  	"seat": "seatdeal1",
  	"bid": [
    	{
      	"impid": "1",
      	"price": 4.0,
      	"id": "image-ad1",
      	"adm": "<ad xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:noNamespaceSchemaLocation=\"smaato_ad_v0.9.xsd\" modelVersion=\"0.9\">
					<imageAd>
						<imgUrl>http://soma.smaatolabs.net/image</imgUrl>
						<clickUrl>http://soma.smaatolabs.net/click</clickUrl>
						<width>320</width>
						<height>50</height>
					</imageAd>
				</ad>",
      	"adomain": [
        	"http://soma.smaatolabs.net"
      	],
      	"crid": "16969426",
      	"cid": "2445",
      	"iurl": "http://soma.smaatolabs.net:3001/image",
      	"nurl": "https://soma-bidder.smaatolabs.net/win",
      	"dealid": "b2ca4a36-3b6d-449b-b741-7900545db4de"
    	}
  	]
	}
  ]
}

Extension Object (2.0/2.1)

Bid Request

{
  "app": {
    "cat": [
      "IAB1-5",
      "IAB3"
    ],
    "domain": "www.smaato.com",
    "id": "1010000000",
    "name": "PreferredDeal_PreferedDealRTB2.0_iOS_XXLARGE_320x50_IAB1-5,IAB3",
    "publisher": {
      "id": "1001000000",
      "name": "PreferredDeal_PreferedDealRTB2.0_iOS_XXLARGE_320x50_IAB1-5,IAB3"
    }
  },
  "bcat": [
    "IAB7-28",
    "IAB17-18",
    "IAB26",
    "IAB25",
    "IAB7-42",
    "IAB9-9",
    "IAB24",
    "IAB23"
  ],
  "device": {
    "connectiontype": 0,
    "devicetype": 1,
	"dnt":0,
	"ifa":"F585B1EF-D543-4F9C-A39F-A204BD9C1E33",
    "didsha1":"03791cf87e352da6434e4d964f54f0f64db933aa",
    "didmd5":"68b329da9893e34099c7d8ad5cb9c940",
    "dpisha1":"bfc523f83fa54a19e7b2d8bdf8acd687a09fba09",
	"dpimd5":"223632c428784fecaaa3e2a6aaaf6d8e",
    "geo": {
      "city": "Hamburg",
      "country": "DEU",
      "lat": 53.550003,
      "lon": 10.0,
      "metro": "0",
      "region": "04",
      "type": 2,
      "zip": "20099"
    },
    "ip": "95.90.255.47",
    "js": 0,
    "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": {
    "carriername": "unknown - probably WLAN",
    "coppa": 0,
    "operaminibrowser": 0,
    "udi":{
        "atuid":"edc22bd4-aa58-f32a-63b7-8c7fcadfb1b7",
        "idfa":"F585B1EF-D543-4F9C-A39F-A204BD9C1E33",
        "idfatracking":1
    }
  },
  "id": "CVERBeHT9g",
  "imp": [
    {
      "banner": {
        "btype": [
          1,
          3
        ],
        "h": 50,
        "mimes": [
          "image/gif",
          "image/jpeg",
          "image/png"
        ],
        "pos": 1,
        "w": 320
      },
      "displaymanager": "SOMA",
      "ext": {
        "pmp": {
          "deals": [
            {
              "at": 3,
              "bidfloor": 8.0,
              "bidfloorcur": "USD",
              "id": "83fafb25-09d2-4ace-812a-70c260cdf70b"
            }
          ],
          "private_auction": 1
        }
      },
      "id": "1",
      "instl": 0
    }
  ],
  "user": {}
}

Bid Response

 {
  "id": "dsp-image-ad-preferred-deal",
  "seatbid": [
	{
  	"seat": "seatdeal1",
  	"bid": [
    	{
      	"impid": "1",
      	"price": 11.0,
      	"id": "image-ad1",
      	"adm": "<ad xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:noNamespaceSchemaLocation=\"smaato_ad_v0.9.xsd\" modelVersion=\"0.9\">
					<imageAd>
						<imgUrl>http://soma.smaatolabs.net/image</imgUrl>
						<clickUrl>http://soma.smaatolabs.net/click</clickUrl>
						<width>320</width>
						<height>50</height>
					</imageAd>
				</ad>",
      	"adomain": [
        	"http://soma.smaatolabs.net"
      	],
      	"crid": "16969426",
      	"cid": "2445",
      	"iurl": "http://soma.smaatolabs.net/image",
      	"nurl": "https://soma-bidder.smaatolabs.net/win",
      	"ext": {
         	"dealid": "83fafb25-09d2-4ace-812a-70c260cdf7b0"
      	}
    	}
  	]
	}
  ]
}