Contents

BidStrategyUpdate

The request body for updating a bid strategy on an ad group or campaign.

Declaration

object BidStrategyUpdate

Properties

NameTypeDescription
bidStrategyTypeBidStrategyUpdate.BidStrategyType

The bid strategy type to apply. See BidStrategyType.

bidStrategyGoalBidStrategyUpdate.BidStrategyGoal

The optimization goal to apply. Must match bidStrategyType per the pairings in BidStrategy. See BidStrategyUpdate.BidStrategyGoal.

bidMoney

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

Discussion

Use BidStrategyUpdate as the bidStrategy field value when updating an ad group (PUT /v1/adgroups/{id} (Update an Ad Group)) or a campaign (PUT /v1/campaigns/{id} (Update a Campaign)). Include only the fields you want to change. The bidStrategyType must remain compatible with the parent campaign’s billingEvent. Changing the type to an incompatible combination returns a 400 error.

The bidStrategyGoal field can be changed together with bidStrategyType. Omitting one, or sending a goal that doesn’t match the type, returns an error. For ad group-specific behavior when the parent campaign uses an automated bidStrategyType (MAX_CONVERSIONS or MAX_ENGAGEMENTS), see AdGroupUpdate.BidStrategy.

Example

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

Topics

Type Aliases

See Also