type BiddingStrategyConfiguration (v201809)

Service
AdGroupCriterionService AdGroupService CampaignService
Dependencies
Campaign
▼
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:

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.

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 the values: MANUAL_CPC, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSION_VALUE, MAXIMIZE_CONVERSIONS, TARGET_OUTRANK_SHARE for campaign channel type SEARCH.
This field may only be set to the values: MANUAL_CPC, TARGET_ROAS, TARGET_SPEND for campaign channel type SHOPPING.
This field may only be set to MAXIMIZE_CONVERSION_VALUE for campaign channel type SHOPPING with campaign channel subtype SHOPPING_GOAL_OPTIMIZED_ADS.
This field may only be set to the values: MANUAL_CPC, MANUAL_CPM, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS for campaign channel type DISPLAY.
This field may only be set to the values: MANUAL_CPC, TARGET_CPA for campaign channel type DISPLAY with campaign channel subtype DISPLAY_MOBILE_APP.
This field may only be set to the values: MANUAL_CPC, MAXIMIZE_CONVERSIONS, PAGE_ONE_PROMOTED, TARGET_CPA, TARGET_OUTRANK_SHARE, TARGET_ROAS, TARGET_SPEND for campaign channel subtype SEARCH_MOBILE_APP.
This field may only be set to the values: TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS for campaign channel type MULTI_CHANNEL with campaign channel subtype UNIVERSAL_APP_CAMPAIGN.
This field may only be set to the values: TARGET_ROAS, TARGET_CPA, MAXIMIZE_CONVERSIONS for campaign channel type DISPLAY with campaign channel subtype DISPLAY_SMART_CAMPAIGN.
This field may only be set to the values: MANUAL_CPC, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS for campaign channel type DISPLAY with campaign channel subtype DISPLAY_GMAIL_AD.

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 is read only and will be ignored when sent to the API.

biddingScheme

  1. BiddingScheme
    1. ManualCpcBiddingScheme
    2. ManualCpmBiddingScheme
    3. MaximizeConversionValueBidd...
    4. MaximizeConversionsBiddingS...
    5. PageOnePromotedBiddingScheme
    6. TargetCpaBiddingScheme
    7. TargetOutrankShareBiddingSc...
    8. TargetRoasBiddingScheme
    9. 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.

bids

  1. Bids[]
    1. CpaBid
    2. CpcBid
    3. 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.

This field may not be set.

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 may not be set.
This field must be between 0.01 and 1000.0, inclusive.