BidRequest.badv
A block list of advertiser domains, such as competitors of the publisher. Bidders must not bid with creatives whose Bid.adomain matches an entry.
Field facts
- Path
badv- Object
- BidRequest
- Type
- string array
- Requirement
- Optional
- Added
- OpenRTB 2.0
- Spec section
- 3.2.1
How it is used
Entries should be bare domains without scheme or path. Exchanges enforce the list by comparing it with Bid.adomain, so a bid that leaves out its advertiser domain gives them nothing to check.
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"badv": [
"rivalbrand.example",
"casino.example"
]
}Common mistakes
- Full URLs such as https://www.brand.example/ instead of brand.example.
- One comma-separated string instead of an array.
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.1 | Array of String | No | No |
| 2.2 | array of strings | No | No |
| 2.3 to 2.6-202606 | string array | No | No |
Related fields
Other BidRequest fields
For a walkthrough of the whole object, read Bid request anatomy.