Bid.adomain

The advertiser's domain, used to check the bid against the publisher's advertiser block list. Several entries are allowed for rotating creatives, though an exchange may insist on exactly one.

Currentstring arrayOptionalSince 2.0

Field facts

Path
seatbid.bid.adomain
Object
Bid
Type
string array
Requirement
Optional
Added
OpenRTB 2.0
Spec section
4.2.3

How it is used

Send the advertiser's bare domain, the one a user would land on, not an ad server or tracking domain. Exchanges compare it with BidRequest.badv, so a bid without it cannot be checked.

Example

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

{
  "seatbid": [
    {
      "bid": [
        {
          "adomain": [
            "brand.example"
          ]
        }
      ]
    }
  ]
}

Common mistakes

  • Sending a click tracker or DSP domain instead of the advertiser's own domain.
  • A full URL such as https://www.brand.example/offer instead of brand.example.

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.1Array of stringNoNo
2.2array of stringsNoNo
2.3 to 2.4string arrayNoNo
2.5arrayNoNo
2.6-202210 to 2.6-202606string arrayNoNo

Related fields

Other Bid fields

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