Bid.bundle

The app store ID of the app this creative advertises, for app install and app promotion ads. Added in 2.3; a package name on Google Play and a numeric ID on the Apple App Store.

CurrentstringOptionalSince 2.3

Field facts

Path: seatbid.bid.bundle
Object: Bid
Type: string
Requirement: Optional
Added: OpenRTB 2.3
Spec section: 4.2.3

How it is used

Exchanges compare it with BidRequest.bapp. Leave it out for ads that do not promote an app. CTV store IDs follow the IAB guidelines for store-assigned IDs.

Example

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

{
  "seatbid": [
    {
      "bid": [
        {
          "bundle": "com.example.puzzlegame"
        }
      ]
    }
  ]
}

Common mistakes

Copying the bundle of the app where the ad will appear, from App.bundle, instead of the advertised app.

Version history

Added in OpenRTB 2.3, 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.3 to 2.4	string	No	No
2.5	string	No	No
2.6-202210 to 2.6-202606	string	No	No

Related fields

Other Bid fields

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