# BiddingStrategy

> [!WARNING]
> Display \& Video 360 API v1 has been sunset.

- [JSON representation](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#SCHEMA_REPRESENTATION)
- [FixedBidStrategy](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#FixedBidStrategy)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#FixedBidStrategy.SCHEMA_REPRESENTATION)
- [MaximizeSpendBidStrategy](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#MaximizeSpendBidStrategy)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#MaximizeSpendBidStrategy.SCHEMA_REPRESENTATION)
- [BiddingStrategyPerformanceGoalType](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#BiddingStrategyPerformanceGoalType)
- [PerformanceGoalBidStrategy](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#PerformanceGoalBidStrategy)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#PerformanceGoalBidStrategy.SCHEMA_REPRESENTATION)

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

| JSON representation |
|---|
| ``` { // Union field `bid_strategy_scheme` can be only one of the following: "fixedBid": { object (`https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#FixedBidStrategy`) }, "maximizeSpendAutoBid": { object (`https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#MaximizeSpendBidStrategy`) }, "performanceGoalAutoBid": { object (`https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#PerformanceGoalBidStrategy`) } // 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 (`https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#FixedBidStrategy`)`` A strategy that uses a fixed bid price. |
| `maximizeSpendAutoBid` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#MaximizeSpendBidStrategy`)`` A strategy that automatically adjusts the bid to optimize to your performance goal while spending the full budget. At insertion order level, the `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#PartnerRevenueModel.FIELDS.markup_type` of line items cannot be set to `PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM`. In addition, when `https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#MaximizeSpendBidStrategy.FIELDS.performance_goal_type` is one of: - `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA` - `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC` - `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` , the `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.line_item_type` of the insertion order line items must be either: - `LINE_ITEM_TYPE_DISPLAY_DEFAULT` - `LINE_ITEM_TYPE_VIDEO_DEFAULT` , and when `https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#MaximizeSpendBidStrategy.FIELDS.performance_goal_type` is either: - `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` - `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN` the `https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.line_item_type` of the insertion order line items must be `LINE_ITEM_TYPE_VIDEO_DEFAULT`. |
| `performanceGoalAutoBid` | ``object (`https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#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. |

## FixedBidStrategy

A strategy that uses a fixed bidding price.

| JSON representation |
|---|
| ``` { "bidAmountMicros": string } ``` |

| Fields ||
|---|---|
| `bidAmountMicros` | `string (https://developers.google.com/discovery/v1/type-format format)` The fixed bid amount, in micros of the advertiser's currency. For insertion order entity, `https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#FixedBidStrategy.FIELDS.bid_amount_micros` should be set as 0. For line item entity, `https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#FixedBidStrategy.FIELDS.bid_amount_micros` 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 (`https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#BiddingStrategyPerformanceGoalType`), "maxAverageCpmBidAmountMicros": string, "raiseBidForDeals": boolean, "customBiddingAlgorithmId": string } ``` |

| Fields ||
|---|---|
| `performanceGoalType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#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 (https://developers.google.com/discovery/v1/type-format 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 (https://developers.google.com/discovery/v1/type-format format)` The ID of the Custom Bidding Algorithm used by this strategy. Only applicable when `https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#MaximizeSpendBidStrategy.FIELDS.performance_goal_type` is set to `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`. |

## BiddingStrategyPerformanceGoalType

Possible types of performance goal for bidding strategy.

| Enums ||
|---|---|
| `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED` | Type value is not specified or is unknown in this version. |
| `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA` | Cost per action. |
| `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC` | Cost per click. |
| `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` | Viewable CPM. |
| `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO` | Custom bidding algorithm. |
| `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` | Completed inview and audible views. |
| `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN` | Inview time over 10 secs views. |
| `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` | Viewable impressions. |

## PerformanceGoalBidStrategy

A strategy that automatically adjusts the bid to meet or beat a specified performance goal.

| JSON representation |
|---|
| ``` { "performanceGoalType": enum (`https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#BiddingStrategyPerformanceGoalType`), "performanceGoalAmountMicros": string, "maxAverageCpmBidAmountMicros": string, "customBiddingAlgorithmId": string } ``` |

| Fields ||
|---|---|
| `performanceGoalType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#BiddingStrategyPerformanceGoalType`)`` Required. The type of the performance goal that the bidding strategy will try to meet or beat. For line item level usage, the value must be one of: - `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA` - `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC` - `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` - `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`. |
| `performanceGoalAmountMicros` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. The performance goal the bidding strategy will attempt to meet or beat, in micros of the advertiser's currency or in micro of the ROAS (Return On Advertising Spend) value which is also based on advertiser's currency. Must be greater than or equal to a billable unit of the given currency and smaller or equal to upper bounds. Each `https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#PerformanceGoalBidStrategy.FIELDS.performance_goal_type` has its upper bound: - when `https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#PerformanceGoalBidStrategy.FIELDS.performance_goal_type` is `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA`, upper bound is 10000.00 USD. - when `https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#PerformanceGoalBidStrategy.FIELDS.performance_goal_type` is `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC`, upper bound is 1000.00 USD. - when `https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#PerformanceGoalBidStrategy.FIELDS.performance_goal_type` is `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM`, upper bound is 1000.00 USD. - when `https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#PerformanceGoalBidStrategy.FIELDS.performance_goal_type` is `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`, upper bound is 1000.00 and lower bound is 0.01. Example: If set to `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM`, the bid price will be based on the probability that each available impression will be viewable. For example, if viewable CPM target is $2 and an impression is 40% likely to be viewable, the bid price will be $0.80 CPM (40% of $2). For example, 1500000 represents 1.5 standard units of the currency or ROAS value. |
| `maxAverageCpmBidAmountMicros` | `string (https://developers.google.com/discovery/v1/type-format 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. Not applicable when `https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#PerformanceGoalBidStrategy.FIELDS.performance_goal_type` is set to `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM`. For example, 1500000 represents 1.5 standard units of the currency. |
| `customBiddingAlgorithmId` | `string (https://developers.google.com/discovery/v1/type-format format)` The ID of the Custom Bidding Algorithm used by this strategy. Only applicable when `https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#PerformanceGoalBidStrategy.FIELDS.performance_goal_type` is set to `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`. |