BidRequest.id
The exchange's ID for this bid request, used to track the responses that come back. Required. The exchange may send a different ID to each bidder for the same auction.
Field facts
- Path
id- Object
- BidRequest
- Type
- string
- Requirement
- Required
- Added
- OpenRTB 2.0
- Spec section
- 3.2.1
How it is used
Bidders echo it in BidResponse.id, and the exchange can substitute it into notice URLs through ${AUCTION_ID}. Because the value may differ per recipient, do not use it to join one auction across bidders or exchanges; Source.tid exists for that.
Example
Where the field sits in a payload, with everything else left out:
{
"id": "80ce30c53c16e6ede735f123ef6e3236"
}Common mistakes
- Reusing one ID for different auctions breaks response matching and log joins.
- Sending a number instead of a string is a type mismatch.
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 | string | Yes | No |
| 2.3 to 2.6-202606 | string | Yes | No |
Related fields
Other BidRequest fields
acatallimpsappatbadvbappbcatbseatcattaxcurdevicedoohextimpregssitesourcetesttmaxuserwlangwlangbwseat
For a walkthrough of the whole object, read Bid request anatomy.