SeatBid Object

A bid response can contain multiple SeatBid objects, each on behalf of a different bidder seat and each containing one or more individual bids. If multiple impressions are presented in the request, the group attribute can be used to specify if a seat is willing to accept any impressions that it can win or if it is only interested in winning any if it can win them all as a group.

Attribute

Triplelift Required

Type

Description

bid

yes

array of objects

Array of 1+ Bid objects each related to an impression. Multiple bids can relate to the same impression

seat

no

string

ID of the buyer seat on whose behalf this bid is made

group

no

integer

0 = impressions can be won individually; 1 = impressions must be won or lost as a group

ext

no

object

Placeholder for bidder-specific extensions to OpenRTB

Bid Object

A SeatBid object contains one or more Bid objects, each of which relates to a specific impression in the bid request via the impid attribute and constitutes an offer to buy that impression for a given price.

Attribute

Triplelift Required

Type

Description

id

yes

string

Bidder generated bid ID to assist with logging/tracking

impid

yes

string

ID of the Imp object in the related bid request

price

yes

float

Bid price expressed as CPM although the actual transaction is for a unit impression only

adid

no

string

ID of a preloaded ad to be served if the bid wins

nurl

no

string

Win notice URL called by the exchange if the bid wins

burl

no

string

Billing notice URL called by the exchange when a winning bid becomes billable based on exchange-specific business policy

lurl

no

string

Loss notice URL called by the exchange when a bid is known to have been lost

adm

no

string

Optional means of conveying ad markup in case the bid wins

adomain

no

array of strings

Advertiser domain for blocklist checking

bundle

no

string

A platform-specific application identifier intended to be unique to the app and independent of the exchange

iurl

no

string

URL without cache-busting to an image that is representative of the content of the campaign for ad quality/safety checking

cid

no

string

Campaign ID to assist with ad quality checking; the collection of creatives for which iurl should be representative

crid

no

string

Creative ID to assist with ad quality checking

cat

no

array of strings

IAB content categories of the creative

attr

no

array of integers

Set of attributes describing the creative

dealid

no

string

Reference to deal.id from the bid request if this bid pertains to a private marketplace direct deal

w

no

integer

Width of the creative in device independent pixels

h

no

integer

Height of the creative in device independent pixels

language

no

string

Language of the creative using ISO-639-1-alpha-2

exp

no

integer

Advisory as to the number of seconds the bidder is willing to wait between the auction and the actual impression

ext

no

object

Placeholder for bidder-specific extensions to OpenRTB