Skip to main content
The adomain verify gate inspects the adomain array on every bid in the response. Advertisers are required by OpenRTB to declare which domains their creatives represent. Bidding agents that submit placeholder values like example.com or advertiserdomain.com — or that omit the field entirely — produce unusable signals for brand safety and supply chain auditing.

​
Usage

​
What the gate checks

For every bid in seatbid[].bid[], the gate validates each entry in bid.adomain:
  1. Missing adomain — the bid.adomain array is empty and requireAdomain is true → fails with "bid has no adomain"
  2. Placeholder domain — the domain matches a known test/placeholder value (case-insensitive) → fails with "placeholder adomain: <domain>"
  3. Invalid format — the domain does not match a valid hostname pattern → fails with "invalid adomain format"

​
Built-in placeholder list

The following domains are always rejected:
All comparisons are lowercased and trimmed before matching.

​
Options

​
boolean
default:"true"
When true, any bid with an empty adomain array fails the gate. Set to false if your pipeline legitimately allows bids without declared advertiser domains.
​
string[]
Additional domain strings to treat as placeholders. Values are lowercased before comparison, so "TestDomain.COM" and "testdomain.com" are equivalent.
​
string
default:"rtb.adomain-verify"
Override the gate’s name in evaluation results and telemetry.

​
Example: failing bid

A bid agent under test that has not populated real advertiser data:
The gate matches advertiserdomain.com against the built-in placeholder set and returns:

​
Adding your own placeholders

If your pipeline has internal test domains you want to block in production:
Setting requireAdomain: false disables the check for bids with an empty adomain array. Only do this if your downstream demand sources have confirmed they do not provide domain declarations.