Deal.wseat

Buyer seats allowed to bid on this deal, such as advertisers or agencies, named by seat ids the exchange and bidders agreed in advance. Absent means no seat restriction.

Currentstring arrayOptionalSince 2.3

Field facts

Path
imp.pmp.deals.wseat
Object
Deal
Type
string array
Requirement
Optional
Added
OpenRTB 2.3
Spec section
3.2.12

How it is used

A bid on the deal comes back under SeatBid.seat, and that value should be one of these ids. To express no restriction, leave the field out rather than sending an empty array.

Example

Where the field sits in a payload, with everything else left out:

{
  "id": "req-1",
  "imp": [
    {
      "pmp": {
        "deals": [
          {
            "wseat": [
              "seat-417",
              "seat-902"
            ]
          }
        ]
      }
    }
  ]
}

Common mistakes

  • Using display names such as an agency's name instead of the agreed seat ids.
  • Sending an empty array, which some readers take to mean nobody may bid.

Version history

Added in OpenRTB 2.3, and present in the latest snapshot. The table shows how each version's spec text types the field.

VersionsType in the specRequiredDeprecated
2.3 to 2.3.1string arrayNoNo
2.4string arrayNoNo
2.5 to 2.6-202606string arrayNoNo

Related fields

Other Deal fields

For a walkthrough of the whole object, read Deals and PMP.