Deal.guar

Guaranteed flag: 1 marks a guaranteed deal that the bidder must bid on, 0 marks an ordinary deal. Defaults to 0. Added in OpenRTB 2.6-202309.

Currentinteger, default 0OptionalSince 2.6-202309

Field facts

Path
imp.pmp.deals.guar
Object
Deal
Type
integer, default 0
Requirement
Optional
Added
OpenRTB 2.6-202309
Spec section
3.2.12

How it is used

It marks programmatic guaranteed deals, where the buyer has committed to a volume. A bidder that skips guaranteed requests leaves the seller short of committed delivery. It usually appears with Deal.at set to 3 and a fixed price.

Allowed values

0, 1.

Example

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

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

Common mistakes

  • Setting 1 on deals that are not committed buys, which tells the buyer's bidder it must respond when it has no obligation.

Version history

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

VersionsType in the specRequiredDeprecated
2.6-202309 to 2.6-202606integer, default 0NoNo

Related fields

Other Deal fields

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