BidResponse.bidid

A response ID the bidder generates for its own logging and tracking. The exchange can return it in win and billing notices through the ${AUCTION_BID_ID} macro.

CurrentstringOptionalSince 2.0

Field facts

Path
bidid
Object
BidResponse
Type
string
Requirement
Optional
Added
OpenRTB 2.0
Spec section
4.2.1

How it is used

It lets a bidder use one static notice URL for every bid and still find the response a notice refers to. OpenRTB 2.3.1 corrected the macro definition so ${AUCTION_BID_ID} reads from this field.

Example

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

{
  "bidid": "resp-8f2a01"
}

Common mistakes

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.

VersionsType in the specRequiredDeprecated
2.0 to 2.2stringNoNo
2.3 to 2.6-202606stringNoNo

Related fields

Other BidResponse fields

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