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 |
|
---|---|
|
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.
|
|
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.
|
|
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
Enumerations
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, TARGET_SPEND, TARGET_CPA, TARGET_ROAS,
MAXIMIZE_CONVERSION_VALUE, MAXIMIZE_CONVERSIONS for campaign
channel type SEARCH.
This field may only be set to the values:
MANUAL_CPC, TARGET_SPEND, TARGET_CPA, TARGET_ROAS,
MAXIMIZE_CONVERSION_VALUE, MAXIMIZE_CONVERSIONS for campaign
channel type SEARCH with campaign channel subtype
SEARCH_EXPRESS.
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
the values: MAXIMIZE_CONVERSION_VALUE, TARGET_ROAS 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, MAXIMIZE_CONVERSION_VALUE for campaign
channel type DISPLAY.
This field may only be set to the values:
MANUAL_CPC, TARGET_CPA, MAXIMIZE_CONVERSION_VALUE 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, TARGET_CPA, 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 not be set for campaign
channel type SEARCH with campaign channel subtype
SEARCH_EXPRESS.
This
field may only be set to the values: TARGET_ROAS, TARGET_CPA,
MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE 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,
MAXIMIZE_CONVERSION_VALUE for campaign channel type DISPLAY with
campaign channel subtype DISPLAY_GMAIL_AD.
This field may not be set for campaign
channel type DISPLAY with campaign channel subtype
DISPLAY_EXPRESS.
|
|
Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion. Enumerations
This field is read only and will be ignored when sent to the API.
|
|
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. |
|
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. |
|
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 This field must be between 0.01 and 1000.0, inclusive.
|