Deal.at

Auction type for this deal, overriding BidRequest.at: 1 first price, 2 second price plus, 3 means Deal.bidfloor is the agreed deal price. The spec lets exchanges define further values.

CurrentintegerOptionalSince 2.3

Field facts

Path: imp.pmp.deals.at
Object: Deal
Type: integer
Requirement: Optional
Added: OpenRTB 2.3
Spec section: 3.2.12

How it is used

When absent, the request-level auction type applies to the deal. Value 3 turns the floor into a fixed price, the usual way to express preferred deals and programmatic guaranteed: the buyer bids that price, and how an exchange handles a bid above or below it is the exchange's own policy. Values 1 and 2 keep a price auction among the bids on the deal.

Allowed values

1, 2, 3.

Example

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

{
  "id": "req-1",
  "imp": [
    {
      "pmp": {
        "deals": [
          {
            "at": 3
          }
        ]
      }
    }
  ]
}

Common mistakes

Treating 3 as an ordinary floor and bidding well above it. With a fixed price the bid is expected to match the agreed price, and what happens otherwise depends on the exchange.
Sending the value as a string such as "3"; it is an integer.

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.

Versions	Type in the spec	Required	Deprecated
2.3 to 2.3.1	integer	No	No
2.4	integer	No	No
2.5 to 2.6-202606	integer	No	No

Related fields

Other Deal fields

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