BiddingStrategy
Stay organized with collections
Save and categorize content based on your preferences.
Fields |
resource_name
|
string
Immutable. The resource name of the bidding strategy. Bidding strategy resource names have the form: customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
|
status
|
BiddingStrategyStatus
Output only. The status of the bidding strategy. This field is read-only.
|
type
|
BiddingStrategyType
Output only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only.
|
currency_code
|
string
Immutable. The currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this currency can be set on creation and defaults to the manager customer's currency. For serving customers, this field cannot be set; all strategies in a serving customer implicitly use the serving customer's currency. In all cases the effective_currency_code field returns the currency used by the strategy.
|
aligned_campaign_budget_id
|
int64
ID of the campaign budget that this portfolio bidding strategy is aligned with. When a portfolio and a campaign budget are aligned, that means that they are attached to the same set of campaigns. After a bidding strategy is aligned with a campaign budget, campaigns that are added to the bidding strategy must also use the aligned campaign budget.
|
id
|
int64
Output only. The ID of the bidding strategy.
|
name
|
string
The name of the bidding strategy. All bidding strategies within an account must be named distinctly. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
|
effective_currency_code
|
string
Output only. The currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this is the currency set by the advertiser when creating the strategy. For serving customers, this is the customer's currency_code. Bidding strategy metrics are reported in this currency. This field is read-only.
|
campaign_count
|
int64
Output only. The number of campaigns attached to this bidding strategy. This field is read-only.
|
non_removed_campaign_count
|
int64
Output only. The number of non-removed campaigns attached to this bidding strategy. This field is read-only.
|
scheme
Union field scheme . The bidding scheme. scheme . The bidding scheme.Only one can be set. scheme can be only one of the following: scheme can be only one of the following: |
enhanced_cpc
|
EnhancedCpc
A bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.
|
maximize_conversion_value
|
MaximizeConversionValue
An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.
|
maximize_conversions
|
MaximizeConversions
An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.
|
target_cpa
|
TargetCpa
A bidding strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
|
target_impression_share
|
TargetImpressionShare
A bidding strategy that automatically optimizes towards a chosen percentage of impressions.
|
target_roas
|
TargetRoas
A bidding strategy that helps you maximize revenue while averaging a specific target Return On Ad Spend (ROAS).
|
target_spend
|
TargetSpend
A bid strategy that sets your bids to help get as many clicks as possible within your budget.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-07 UTC.
[null,null,["Last updated 2025-08-07 UTC."],[],[],null,["# BiddingStrategy\n\nA bidding strategy.\n\n| Fields ||\n|----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `resource_name` | `string` Immutable. The resource name of the bidding strategy. Bidding strategy resource names have the form: `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}` |\n| ### `status` | [BiddingStrategyStatus](/google-ads/api/reference/rpc/v21/BiddingStrategyStatusEnum.BiddingStrategyStatus) Output only. The status of the bidding strategy. This field is read-only. |\n| ### `type` | [BiddingStrategyType](/google-ads/api/reference/rpc/v21/BiddingStrategyTypeEnum.BiddingStrategyType) Output only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only. |\n| ### `currency_code` | `string` Immutable. The currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this currency can be set on creation and defaults to the manager customer's currency. For serving customers, this field cannot be set; all strategies in a serving customer implicitly use the serving customer's currency. In all cases the effective_currency_code field returns the currency used by the strategy. |\n| ### `aligned_campaign_budget_id` | `int64` ID of the campaign budget that this portfolio bidding strategy is aligned with. When a portfolio and a campaign budget are aligned, that means that they are attached to the same set of campaigns. After a bidding strategy is aligned with a campaign budget, campaigns that are added to the bidding strategy must also use the aligned campaign budget. |\n| ### `id` | `int64` Output only. The ID of the bidding strategy. |\n| ### `name` | `string` The name of the bidding strategy. All bidding strategies within an account must be named distinctly. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed). |\n| ### `effective_currency_code` | `string` Output only. The currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this is the currency set by the advertiser when creating the strategy. For serving customers, this is the customer's currency_code. Bidding strategy metrics are reported in this currency. This field is read-only. |\n| ### `campaign_count` | `int64` Output only. The number of campaigns attached to this bidding strategy. This field is read-only. |\n| ### `non_removed_campaign_count` | `int64` Output only. The number of non-removed campaigns attached to this bidding strategy. This field is read-only. |\n| ### `scheme` Union field `scheme`. The bidding scheme. `scheme`. The bidding scheme. Only one can be set. `scheme` can be only one of the following: `scheme` can be only one of the following: ||\n| ### `enhanced_cpc` | [EnhancedCpc](/google-ads/api/reference/rpc/v21/EnhancedCpc) A bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely. |\n| ### `maximize_conversion_value` | [MaximizeConversionValue](/google-ads/api/reference/rpc/v21/MaximizeConversionValue) An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget. |\n| ### `maximize_conversions` | [MaximizeConversions](/google-ads/api/reference/rpc/v21/MaximizeConversions) An automated bidding strategy to help get the most conversions for your campaigns while spending your budget. |\n| ### `target_cpa` | [TargetCpa](/google-ads/api/reference/rpc/v21/TargetCpa) A bidding strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set. |\n| ### `target_impression_share` | [TargetImpressionShare](/google-ads/api/reference/rpc/v21/TargetImpressionShare) A bidding strategy that automatically optimizes towards a chosen percentage of impressions. |\n| ### `target_roas` | [TargetRoas](/google-ads/api/reference/rpc/v21/TargetRoas) A bidding strategy that helps you maximize revenue while averaging a specific target Return On Ad Spend (ROAS). |\n| ### `target_spend` | [TargetSpend](/google-ads/api/reference/rpc/v21/TargetSpend) A bid strategy that sets your bids to help get as many clicks as possible within your budget. |"]]