SeatBid.group

Whether the seat's bids must be won together: 0, the default, lets each impression be won on its own, while 1 means the seat wants all of them or none.

CurrentintegerOptionalSince 2.0

Field facts

Path: seatbid.group
Object: SeatBid
Type: integer
Default: 0
Requirement: Optional
Added: OpenRTB 2.0
Spec section: 4.2.2

How it is used

Group bidding supports roadblocks, where an advertiser wants every placement in a context. It only makes sense when the request offers several impressions, ideally with BidRequest.allimps set to 1, and the exchange must support all-or-nothing evaluation for the flag to have any effect.

Allowed values

0, 1.

Example

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

{
  "seatbid": [
    {
      "group": 1
    }
  ]
}

Common mistakes

Sending true instead of 1. The field is an integer flag.

Version history

Added in OpenRTB 2.0, 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.0 to 2.2	integer	No	No
2.3 to 2.6-202606	integer, default 0	No	No

Related fields

Other SeatBid fields

For a walkthrough of the whole object, read Bid response anatomy.