AdsApp.​KeywordBidding

AI-generated Key Takeaways

• Provides methods to manage a keyword's cost-per-click (CPC) and cost-per-thousand impressions (CPM) bids.

• Allows retrieval of the keyword's bidding strategy information, including type and source.

• Enables clearing existing CPC or CPM bids, letting the keyword inherit bids from higher levels.

• Offers functionality to set new CPC or CPM bids for the keyword.

• Note that changes to bids might not impact actual bidding if the keyword uses a bidding strategy that doesn't involve those bid types.

Provides access to a keyword's bidding fields.

Methods:

Member	Type	Description
clearCpc()	void	Clears the max CPC bid for this keyword.
clearCpm()	void	Clears the CPM bid for this keyword.
getCpc()	double	Returns the max CPC bid for this keyword.
getCpm()	double	Returns the CPM bid for this keyword.
getStrategy()	AdsApp.BiddingStrategy	Returns the flexible bidding strategy of the keyword.
getStrategySource()	String	Returns the bidding strategy source of this keyword.
getStrategyType()	String	Returns the bidding strategy type of this keyword.
setCpc(cpc)	void	Sets the max CPC bid for this keyword.
setCpm(cpm)	void	Sets the CPM bid for this keyword.

clearCpc()

Clears the max CPC bid for this keyword. This will allow this keyword to inherit its bid from the ad group level.

Please note that although this method will effectively clear the max CPC bid for this keyword, the change may have no effect on actual bidding if this keyword has a BiddingStrategy which does not involve max CPC bids.

Returns nothing.

clearCpm()

Clears the CPM bid for this keyword. This will allow this keyword to inherit its bid from the ad group level.

Please note that although this method will effectively clear the CPM bid for this keyword, the change may have no effect on actual bidding if this keyword has a BiddingStrategy which does not involve CPM bids.

See Cost-per-thousand impressions (CPM) for more information.

Returns nothing.

getCpc()

Returns the max CPC bid for this keyword.

Return values:

Type	Description
double	The max CPC bid for this keyword.

getCpm()

Returns the CPM bid for this keyword.

See Cost-per-thousand impressions (CPM) for more information.

Return values:

Type	Description
double	The CPM bid for this keyword.

getStrategy()

Returns the flexible bidding strategy of the keyword. If this keyword has an anonymous bidding strategy, or no bidding strategy, null is returned.

Return values:

Type	Description
AdsApp.BiddingStrategy	The flexible bidding strategy associated with this keyword.

getStrategySource()

Returns the bidding strategy source of this keyword. Always returns 'CAMPAIGN'.

Deprecated. Google Ads does not support setting bidding strategies at different levels. As a result, 'CAMPAIGN' is the only possible source for bidding strategies.

Return values:

Type	Description
String	The bidding strategy source of this keyword.

getStrategyType()

Returns the bidding strategy type of this keyword. This may either be an anonymous bidding strategy, or the type of a flexible bidding strategy.

Return values:

Type	Description
String	The strategy type of this keyword.

setCpc(cpc)

Sets the max CPC bid for this keyword.

Please note that although this method will effectively set the max CPC bid for this keyword, the change may have no effect on actual bidding if this keyword has a BiddingStrategy which does not involve max CPC bids.

Returns nothing.

Arguments:

Name	Type	Description
cpc	double	The max CPC bid for this keyword.

setCpm(cpm)

Sets the CPM bid for this keyword.

Please note that although this method will effectively set the CPM bid for this keyword, the change may have no effect on actual bidding if this keyword has a BiddingStrategy which does not involve CPM bids.

See Cost-per-thousand impressions (CPM) for more information.

Returns nothing.

Arguments:

Name	Type	Description
cpm	double	The CPM bid for this keyword.