BidRequest.app

An App object describing the non-browser application where the impression appears: bundle, store URL, publisher, and content. Recommended for app inventory, and never sent together with BidRequest.site or BidRequest.dooh.

CurrentobjectRecommendedSince 2.0

Field facts

Path: app
Object: BidRequest
Type: object
Requirement: Recommended
Added: OpenRTB 2.0
Spec section: 3.2.1

How it is used

Buyers check App.bundle against app-ads.txt and their own allow and block lists, so the bundle should be the store identifier: a package name on Google Play, a numeric ID on the Apple App Store, and the store-assigned ID on CTV platforms.

Example

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

{
  "id": "req-1",
  "app": {
    "id": "app-55",
    "bundle": "com.example.puzzlegame",
    "storeurl": "https://play.google.com/store/apps/details?id=com.example.puzzlegame",
    "publisher": {
      "id": "pub-4791"
    }
  }
}

Common mistakes

Sending site and app together. Pick the object that matches the actual inventory.
Putting the app's display name in App.bundle instead of its store identifier.

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.

Versions	Type in the spec	Required	Deprecated
2.0 to 2.2	object	No	No
2.3 to 2.6-202606	object	Recommended	No

Related fields

Other BidRequest fields

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