---
title: BidStrategy
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/bidstrategy
---

# BidStrategy

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

## Declaration

```data
object BidStrategy
```

## Properties

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. 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. bid: 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

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

- [BidStrategy.BidStrategyGoal](apple-ads-platform-api/bidstrategy/bidstrategygoal-data.typealias.md)
- [BidStrategy.BidStrategyType](apple-ads-platform-api/bidstrategy/bidstrategytype-data.typealias.md)

## See Also

- [AdGroup](apple-ads-platform-api/adgroup.md)
- [AdGroupCreate](apple-ads-platform-api/adgroupcreate.md)
- [AdGroupUpdate](apple-ads-platform-api/adgroupupdate.md)
- [AdGroupResponse](apple-ads-platform-api/adgroupresponse.md)
- [AdGroupQueryResponse](apple-ads-platform-api/adgroupqueryresponse.md)
- [AdGroupTargeting](apple-ads-platform-api/adgrouptargeting.md)
- [AdGroupTargetingCreate](apple-ads-platform-api/adgrouptargetingcreate.md)
- [AdGroupTargetingUpdate](apple-ads-platform-api/adgrouptargetingupdate.md)
- [BidStrategyCreate](apple-ads-platform-api/bidstrategycreate.md)
- [BidStrategyUpdate](apple-ads-platform-api/bidstrategyupdate.md)
- [CPAGoal](apple-ads-platform-api/cpagoal.md)
- [CPAGoalCreate](apple-ads-platform-api/cpagoalcreate.md)
- [CPAGoalUpdate](apple-ads-platform-api/cpagoalupdate.md)
- [TargetingData](apple-ads-platform-api/targetingdata.md)
- [TargetingDataCreate](apple-ads-platform-api/targetingdatacreate.md)