To discuss and provide feedback on our products, join the official Display & Video 360 API and Structured Data Files Discord channel in the Google Advertising and Measurement Community server.

BiddingStrategy

Page Summary

Bid strategy settings control the bid price and can be a fixed bid, optimize spend to meet a performance goal, meet or beat a performance goal, or be specific for YouTube and Partners resources.
FixedBidStrategy uses a predetermined bid amount in micros of the advertiser's currency.
MaximizeSpendBidStrategy automatically adjusts bids to achieve a performance goal while spending the full budget, with support for various performance goal types and custom bidding algorithms.
PerformanceGoalBidStrategy automatically adjusts bids to meet or exceed a specified performance goal, applicable only to line items.
YoutubeAndPartnersBiddingStrategy offers different bidding types for YouTube and Partners resources, including manual and automated options like Target CPA, Target ROAS, and Maximize Conversions.

JSON representation
FixedBidStrategy
- JSON representation
MaximizeSpendBidStrategy
- JSON representation
BiddingStrategyPerformanceGoalType
PerformanceGoalBidStrategy
- JSON representation
YoutubeAndPartnersBiddingStrategy
- JSON representation
YoutubeAndPartnersBiddingStrategyType
BiddingSource
DemandGenBiddingStrategy
- JSON representation
DemandGenBiddingStrategyType

Settings that control the bid strategy. Bid strategy determines the bid price.

JSON representation

JSON representation
{ // Union field `bid_strategy_scheme` can be only one of the following: "fixedBid": { object (`FixedBidStrategy`) }, "maximizeSpendAutoBid": { object (`MaximizeSpendBidStrategy`) }, "performanceGoalAutoBid": { object (`PerformanceGoalBidStrategy`) }, "youtubeAndPartnersBid": { object (`YoutubeAndPartnersBiddingStrategy`) }, "demandGenBid": { object (`DemandGenBiddingStrategy`) } // End of list of possible types for union field `bid_strategy_scheme`. }

{

  // Union field bid_strategy_scheme can be only one of the following:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "demandGenBid": {
    object (DemandGenBiddingStrategy)
  }
  // End of list of possible types for union field bid_strategy_scheme.
}

Fields
Union field `bid_strategy_scheme`. Required. `bid_strategy_scheme` can be only one of the following:
`fixedBid`	`object (FixedBidStrategy)` A strategy that uses a fixed bid price.
`maximizeSpendAutoBid`	`object (MaximizeSpendBidStrategy)` A strategy that automatically adjusts the bid to optimize to your performance goal while spending the full budget. At insertion order level, the `markupType` of line items cannot be set to `PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM`. In addition, the `performanceGoalType` value assigned to an insertion order determines the possible `lineItemType` values available for line items under that insertion order: `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA`, `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC`, and `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` only allow for `LINE_ITEM_TYPE_DISPLAY_DEFAULT` or `LINE_ITEM_TYPE_VIDEO_DEFAULT` line items. `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` and `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN` only allow for `LINE_ITEM_TYPE_VIDEO_DEFAULT` line items. `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH` only allows for `LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP` line items.
`performanceGoalAutoBid`	`object (PerformanceGoalBidStrategy)` A strategy that automatically adjusts the bid to meet or beat a specified performance goal. It is to be used only for a line item entity.
`youtubeAndPartnersBid`	`object (YoutubeAndPartnersBiddingStrategy)` A bid strategy used by YouTube and Partners resources. It can only be used for a YouTube and Partners line item or ad group entity.
`demandGenBid`	`object (DemandGenBiddingStrategy)` A bid strategy used by Demand Gen resources. It can only be used for a Demand Gen line item or ad group entity.

FixedBidStrategy

A strategy that uses a fixed bidding price.

JSON representation
{ "bidAmountMicros": string }

Fields

Fields
`bidAmountMicros`	`string (int64 format)` The fixed bid amount, in micros of the advertiser's currency. For insertion order entity, `bidAmountMicros` should be set as 0. For line item entity, `bidAmountMicros` must be greater than or equal to billable unit of the given currency and smaller than or equal to the upper limit 1000000000. For example, 1500000 represents 1.5 standard units of the currency.

bidAmountMicros

string (int64 format)

The fixed bid amount, in micros of the advertiser's currency. For insertion order entity, bidAmountMicros should be set as 0. For line item entity, bidAmountMicros must be greater than or equal to billable unit of the given currency and smaller than or equal to the upper limit 1000000000.

For example, 1500000 represents 1.5 standard units of the currency.

MaximizeSpendBidStrategy

A strategy that automatically adjusts the bid to optimize a specified performance goal while spending the full budget.

JSON representation
{ "performanceGoalType": enum (`BiddingStrategyPerformanceGoalType`), "maxAverageCpmBidAmountMicros": string, "raiseBidForDeals": boolean, "customBiddingAlgorithmId": string }

Fields
`performanceGoalType`	`enum (BiddingStrategyPerformanceGoalType)` Required. The type of the performance goal that the bidding strategy tries to minimize while spending the full budget. `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` is not supported for this strategy.
`maxAverageCpmBidAmountMicros`	`string (int64 format)` The maximum average CPM that may be bid, in micros of the advertiser's currency. Must be greater than or equal to a billable unit of the given currency. For example, 1500000 represents 1.5 standard units of the currency.
`raiseBidForDeals`	`boolean` Whether the strategy takes deal floor prices into account.
`customBiddingAlgorithmId`	`string (int64 format)` The ID of the Custom Bidding Algorithm used by this strategy. Only applicable when `performanceGoalType` is set to `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`. Assigning a custom bidding algorithm that uses floodlight activities not identified in `floodlightActivityConfigs` will return an error.