BidRequest.bapp
A block list of advertised apps by app store ID. Added in 2.4; on Google Play the ID is the package name, on the Apple App Store a numeric ID, and CTV stores follow the IAB guidelines for store-assigned IDs.
Field facts
- Path
bapp- Object
- BidRequest
- Type
- string array
- Requirement
- Optional
- Added
- OpenRTB 2.4
- Spec section
- 3.2.1
How it is used
Exchanges compare it with Bid.bundle, which names the app a creative promotes. It blocks ads for the listed apps; it says nothing about the app where the ad will appear, which is described in BidRequest.app.
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"bapp": [
"com.example.slots",
"1460012345"
]
}Common mistakes
- Listing reverse-domain bundle IDs for Apple App Store apps. The store ID there is numeric.
Version history
Added in OpenRTB 2.4, 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.4 to 2.5 | string array | No | No |
| 2.6-202210 to 2.6-202606 | string array | No | No |
Related fields
Other BidRequest fields
For a walkthrough of the whole object, read Bid request anatomy.