Contents

AdGroup.BidStrategy

Defines how this ad group competes in auctions, including bid type, optimization goal, and bid amount.

Declaration

object AdGroup.BidStrategy

Properties

NameTypeDescription
bidStrategyTypeBidStrategy.BidStrategyType

The bid strategy type. Values: MANUAL_CPT (goal TAP, supported on App Store and Apple Maps), MANUAL_CPM (goal IMPRESSION, Apple Maps only), MAX_CONVERSIONS (goal INSTALL, App Store only), MAX_ENGAGEMENTS (goal TAP, Apple Maps only). See BidStrategyType. Mutable.

bidStrategyGoalBidStrategy.BidStrategyGoal

The optimization goal for this bid strategy. Values: TAP (pairs with MANUAL_CPT or MAX_ENGAGEMENTS), IMPRESSION (pairs with MANUAL_CPM), INSTALL (pairs with MAX_CONVERSIONS). See BidStrategyGoal. Mutable. Must be paired with a matching bidStrategyType.

bidMoney

The bid amount, setting the monetary ceiling for each auction entry. For MANUAL_CPT strategies, this value directly governs auction participation. For automated strategies, it acts as an upper bound. See Money. Mutable.

Discussion

The bidStrategy field ties this ad group’s bidding mechanics to its optimization goal, determining how Apple Ads evaluates the ad group’s bids in auctions. The bidStrategyType and bidStrategyGoal fields must be sent together and match one of these pairings: MANUAL_CPT↔TAP, MANUAL_CPM↔IMPRESSION, MAX_CONVERSIONS↔INSTALL, MAX_ENGAGEMENTS↔TAP.

Example

{
  "bidStrategy": {
    "bidStrategyType": "MANUAL_CPT",
    "bidStrategyGoal": "TAP",
    "bid": {
      "amount": "5.00",
      "currency": "USD"
    }
  }
}