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.

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"
      	}
    	}
  	]
	}
  ]
}

PMP/Direct Deal Object (2.2 or later)

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
  },
  "regs": {
    "coppa": 0,
    "ext": {
      "gdpr": 1
    }
  },
  "user": {
    "ext": {
      "consent": "BONZC5sONZC5sAAABAENAAoAAAAFIgAAAAAAAAAAAAI"
    },
    "gender": "M",
    "yob": 1976
  }
}

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"
    	}
  	]
	}
  ]
}