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.

18 fieldsOpenRTB 2.0 to 2.6-202606At site

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

FieldTypeRequirementSinceStatus
catstring arrayOptional2.0Current
cattaxinteger, default 1Optional2.6-202204Current
contentobjectOptional2.0Current
domainstringOptional2.0Current
extobjectOptional2.1Current
idstringRecommended2.0Current
inventorypartnerdomainstringOptional2.6-202211Current
keywordsstringOptional2.0Current
kwarraystring arrayOptional2.6-202204Current
mobileintegerOptional2.3Current
namestringOptional2.0Current
pagestringOptional2.0Current
pagecatstring arrayOptional2.0Current
privacypolicyintegerOptional2.0Current
publisherobjectOptional2.0Current
refstringOptional2.0Current
searchstringOptional2.0Current
sectioncatstring arrayOptional2.0Current

Where it sits

Contained in: BidRequest.

Contains: Content, Publisher.

All objects

The field reference index lists every OpenRTB 2.x object.