Site object
The Site object describes website inventory: the site's domain, the URL of the page the ad will appear on, its content categories, and the publisher and content behind the impression. It sits at BidRequest.site, and a request that carries it must not also carry BidRequest.app or BidRequest.dooh.
How it is used
Buyers price web inventory mostly on Site.domain and Site.page, then check the domain against the publisher's ads.txt and the seller path in Source.schain. The spec marks nothing on Site as required and calls a site ID or page URL the useful minimum, but a request with only an ID gives most bidders too little to work with. Since OpenRTB 2.6 the category fields are read in the taxonomy named by Site.cattax, and since 2.6-202211 Site.inventorypartnerdomain is a core field rather than an extension.
Fields
| Field | Type | Requirement | Since | Status |
|---|---|---|---|---|
cat | string array | Optional | 2.0 | Current |
cattax | integer, default 1 | Optional | 2.6-202204 | Current |
content | object | Optional | 2.0 | Current |
domain | string | Optional | 2.0 | Current |
ext | object | Optional | 2.1 | Current |
id | string | Recommended | 2.0 | Current |
inventorypartnerdomain | string | Optional | 2.6-202211 | Current |
keywords | string | Optional | 2.0 | Current |
kwarray | string array | Optional | 2.6-202204 | Current |
mobile | integer | Optional | 2.3 | Current |
name | string | Optional | 2.0 | Current |
page | string | Optional | 2.0 | Current |
pagecat | string array | Optional | 2.0 | Current |
privacypolicy | integer | Optional | 2.0 | Current |
publisher | object | Optional | 2.0 | Current |
ref | string | Optional | 2.0 | Current |
search | string | Optional | 2.0 | Current |
sectioncat | string array | Optional | 2.0 | Current |
Where it sits
Contained in: BidRequest.
All objects
The field reference index lists every OpenRTB 2.x object.