Contents

BidStrategy

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

Declaration

object 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 object defines how an ad group or campaign competes in auctions.

You must send bidStrategyType and bidStrategyGoal together and match one of the pairings listed in the properties below, whether creating a bid strategy or updating one. See BidStrategyCreate and BidStrategyUpdate. See AdGroupUpdate.BidStrategy for how ad groups under an auto-bidding campaign can echo the campaign’s bid strategy.

Example

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

Topics

Type Aliases

See Also