App object

The App object describes inventory inside a non-browser application, which covers mobile apps and connected TV apps alike. It sits at BidRequest.app and takes the place of BidRequest.site for that request. Its key field is App.bundle, the store identifier buyers use for targeting, blocking, and app-ads.txt checks.

18 fieldsOpenRTB 2.0 to 2.6-202606At app

How it is used

CTV inventory uses App as well, with show-level detail in App.content. Nothing on App is required, and the spec calls an app ID or bundle the useful minimum, but several exchange contracts treat a missing bundle as an error. A request carries one of App, Site, or DOOH, never two. Keep App.bundle and App.storeurl pointing at the same store listing, because buyers cross-check them.

Fields

FieldTypeRequirementSinceStatus
bundlestringOptional2.0Current
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
namestringOptional2.0Current
pagecatstring arrayOptional2.0Current
paidintegerOptional2.0Current
privacypolicyintegerOptional2.0Current
publisherobjectOptional2.0Current
sectioncatstring arrayOptional2.0Current
storeurlstringOptional2.1Current
verstringOptional2.0Current

Where it sits

Contained in: BidRequest.

Contains: Content, Publisher.

All objects

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