AdsApp.​AdGroupBidding

AI-generated Key Takeaways

• Provides access to an AdGroup's bidding fields, allowing retrieval and modification of bidding strategies and values.

• Enables retrieval of Target CPA, max CPC, and CPM bids using getCpa(), getCpc(), and getCpm() respectively.

• Allows setting Target CPA, max CPC, and CPM bids using setCpa(), setCpc(), and setCpm() respectively.

• Offers methods to retrieve the flexible bidding strategy and its type associated with the ad group.

• Note: Changes to bid values might not affect actual bidding if the ad group's bidding strategy doesn't utilize them.

Provides access to an AdGroup's bidding fields.

Methods:

Member	Type	Description
getCpa()	double	Returns the Target CPA bid for this ad group.
getCpc()	double	Returns the max CPC bid for this ad group.
getCpm()	double	Returns the CPM bid for this ad group.
getStrategy()	AdsApp.BiddingStrategy	Returns the flexible bidding strategy of the ad group.
getStrategySource()	String	Returns the bidding strategy source of this ad group.
getStrategyType()	String	Returns the bidding strategy type of this ad group.
setCpa(cpa)	void	Sets the Target CPA bid for this ad group.
setCpc(cpc)	void	Sets the max CPC bid for this ad group.
setCpm(cpm)	void	Sets the CPM bid for this ad group.

getCpa()

Returns the Target CPA bid for this ad group.

Return values:

Type	Description
double	The Target CPA bid for this ad group.

getCpc()

Returns the max CPC bid for this ad group.

Return values:

Type	Description
double	The max CPC bid for this ad group.

getCpm()

Returns the CPM bid for this ad group.

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

Return values:

Type	Description
double	The CPM bid for this ad group.

getStrategy()

Returns the flexible bidding strategy of the ad group. If this ad group 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 ad group.

getStrategySource()

Returns the bidding strategy source of this ad group. 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 ad group.

getStrategyType()

Returns the bidding strategy type of this ad group. 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 ad group.

setCpa(cpa)

Sets the Target CPA bid for this ad group.

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

Returns nothing.

Arguments:

Name	Type	Description
cpa	double	The Target CPA bid for this ad group.

setCpc(cpc)

Sets the max CPC bid for this ad group.

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

Returns nothing.

Arguments:

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

setCpm(cpm)

Sets the CPM bid for this ad group.

Please note that although this method will effectively set the CPM bid for this ad group, the change may have no effect on actual bidding if this ad group 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 ad group.