type BiddingStrategyConfiguration (v201809)

Service

AdGroupCriterionService AdGroupService CampaignService

Dependencies

AdGroup

▼

BiddingStrategyConfiguration

Encapsulates the information about bids and bidding strategies.

Note: Starting with v201705, bidding strategies can only be set on campaigns. In earlier versions, bidding strategies can be set on campaigns, ad groups and ad group criteria.

A bidding strategy can be set using one of the following:

• bidding scheme
• bidding strategy type
• bidding strategy ID for flexible bid strategies.

If the bidding strategy type is used, then schemes are created using default values.

Bids can be set only on ad groups and ad group criteria. They cannot be set on campaigns. Multiple bids can be set at the same time. Only the bids that apply to the effective bidding strategy will be used. Effective bidding strategy is considered to be the directly attached strategy or inherited strategy from above level(s) when there is no directly attached strategy.

For more information on flexible bidding, visit the Help Center.

---

Namespace

https://adwords.google.com/api/adwords/cm/v201809

Field
biddingStrategyId	xsd:long Id of the bidding strategy to be associated with the campaign, ad group or ad group criteria. A bidding strategy is created using the BiddingStrategyService ADD operation and is assigned a BiddingStrategyId. The BiddingStrategyId can be shared across campaigns, ad groups and ad group criteria. Starting with v201705, this field cannot be set at the ad group or ad group criterion level. This field can be selected using the value "BiddingStrategyId". This field can be filtered on. This is disabled for AdX. This field may not be set.
biddingStrategyName	xsd:string Name of the bidding strategy. This is applicable only for flexible bidding strategies. This field can be selected using the value "BiddingStrategyName". This field can be filtered on. This field is read only and will be ignored when sent to the API.
biddingStrategyType	BiddingStrategyType The type of the bidding strategy to be attached. For details on portfolio vs. standard availability, see the bidding guide. Starting with v201705, this field cannot be set at the ad group or ad group criterion level to any value other than BiddingStrategyType.NONE. Enumerations MANUAL_CPC Manual click based bidding where user pays per click. See ManualCpcBiddingScheme for more details. MANUAL_CPM Manual impression based bidding where user pays per thousand impressions. See ManualCpmBiddingScheme for more details. PAGE_ONE_PROMOTED Page-One Promoted is an automated bid strategy that sets max CPC bids to target impressions on page one or page one promoted slots on google.com. See PageOnePromotedBiddingScheme for more details. TARGET_SPEND Target Spend (Maximize Clicks) is an automated bid strategy that sets your bids to help get as many clicks as possible within your budget. See TargetSpendBiddingScheme for more details. TARGET_CPA Target CPA is an automated bid strategy that sets bids to help get as many conversions as possible at the target cost per acquisition (CPA) you set. See TargetCpaBiddingScheme for more details. TARGET_ROAS Target ROAS is an automated bidding strategy that helps you maximize revenue while averaging a specific target return on average spend (ROAS). See TargetRoasBiddingScheme for more details. MAXIMIZE_CONVERSIONS Maximize conversions is an automated bidding strategy that automatically sets bids to help get the most conversions for your campaign while spending your budget. See MaximizeConversionsBiddingScheme for more details. MAXIMIZE_CONVERSION_VALUE Maximize conversion value is an automated bidding strategy that automatically sets bids to maximize revenue while spending your budget. See MaximizeConversionValueBiddingScheme for more details. TARGET_OUTRANK_SHARE Target Outrank Share is an automated bidding strategy that sets bids based on the target fraction of auctions where the advertiser should outrank a specific competitor. See TargetOutrankShareBiddingScheme for more details. NONE Special bidding strategy type used to reset the bidding strategy at AdGroup and AdGroupCriterion. UNKNOWN This field can be selected using the value "BiddingStrategyType". This field can be filtered on. This field may only be set to NONE.
biddingStrategySource	BiddingStrategySource Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. Enumerations CAMPAIGN Bidding strategy is defined on campaign level. ADGROUP Bidding strategy is defined on adgroup level. CRITERION Bidding strategy is defined on criterion level. This field can be selected using the value "BiddingStrategySource". This field can be filtered on. This field is read only and will be ignored when sent to the API.
biddingScheme	BiddingScheme ManualCpcBiddingScheme ManualCpmBiddingScheme MaximizeConversionValueBidd... MaximizeConversionsBiddingS... PageOnePromotedBiddingScheme TargetCpaBiddingScheme TargetOutrankShareBiddingSc... TargetRoasBiddingScheme TargetSpendBiddingScheme The bidding strategy metadata. Bidding strategy can be associated using the BiddingStrategyConfiguration.biddingStrategyType or the bidding scheme. For details on portfolio vs. standard availability, see the bidding guide. Starting with v201705, this field cannot be set at the ad group or ad group criterion level. This field may not be set.
bids	Bids[] CpaBid CpcBid CpmBid Specifies the bids. Bids can be set only on ad groups and ad group criteria. Bids cannot be set on campaign. Default CPC and CPM bid values will be set if they are not provided during AdGroup creation. Default CPC and CPM values are minimal billable amounts in local currencies. For example, for US Dollars CPC and CPM default values are $0.01 and $0.01, respectively.
targetRoasOverride	xsd:double The target return on average spend (ROAS). This target can only be set on ad groups. If this ad group's effective bidding strategy is a standard TARGET_ROAS strategy attached to the campaign, then the target overrides the target roas specified in the campaign's bidding strategy. Otherwise, this value is ignored. This field can be selected using the value "TargetRoasOverride". This field can be filtered on. This field must be between 0.01 and 1000.0, inclusive.