AdsApp.​BiddingStrategyArgsBuilder

AI-generated Key Takeaways

• The BiddingStrategyArgsBuilder is used to set arguments when applying a bidding strategy to a campaign.

• It provides methods to configure parameters like CPC bid ceiling, Enhanced CPC, target ROAS, and location settings for ads.

• args() returns a JavaScript object representing the specified arguments.

• You can control the desired percentage of ads displayed in targeted locations using withLocationFraction and withLocationType.

• Each method returns a BiddingStrategyArgsBuilder instance for chaining multiple configurations together.

Builder for setting arguments when applying a bidding strategy to a campaign.

Methods:

Member	Type	Description
args()	AdsApp.BiddingStrategyArgs	Returns a JavaScript object representation of the specified args.
withCpcBidCeiling(cpc)	AdsApp.BiddingStrategyArgsBuilder	Sets the cpc bid ceiling for a bidding strategy (specified in the account's currency).
withEnhancedCpcEnabled(enhancedCpcEnabled)	AdsApp.BiddingStrategyArgsBuilder	Enables or disables enhanced cpc for a bidding strategy.
withLocationFraction(locationFraction)	AdsApp.BiddingStrategyArgsBuilder	Sets the desired percentage of ads to be shown in the targeted location.
withLocationType(locationType)	AdsApp.BiddingStrategyArgsBuilder	Sets the targeted location for ads.
withTargetRoas(targetRoas)	AdsApp.BiddingStrategyArgsBuilder	Sets the target roas for a bidding strategy.

args()

Returns a JavaScript object representation of the specified args.

Return values:

Type	Description
AdsApp.BiddingStrategyArgs	A JavaScript object representation of the builder.

withCpcBidCeiling(cpc)

Sets the cpc bid ceiling for a bidding strategy (specified in the account's currency).

Arguments:

Name	Type	Description
cpc	double	The cpc bid ceiling.

Return values:

Type	Description
AdsApp.BiddingStrategyArgsBuilder	A BiddingStrategyArgsBuilder with the specified cpc bid ceiling.

withEnhancedCpcEnabled(enhancedCpcEnabled)

Enables or disables enhanced cpc for a bidding strategy.

Arguments:

Name	Type	Description
enhancedCpcEnabled	boolean	Whether enhanced cpc is enabled or disabled.

Return values:

Type	Description
AdsApp.BiddingStrategyArgsBuilder	A BiddingStrategyArgsBuilder with the specified value for enhanced cpc.

withLocationFraction(locationFraction)

Sets the desired percentage of ads to be shown in the targeted location. Specified as a percentage from 0-100. To specify the targeted location, call withLocationType.

Arguments:

Name	Type	Description
locationFraction	double	The location fraction.

Return values:

Type	Description
AdsApp.BiddingStrategyArgsBuilder	A BiddingStrategyArgsBuilder with the specified location fraction.

withLocationType(locationType)

Sets the targeted location for ads. Accepted values are: ANYWHERE_ON_PAGE, TOP_OF_PAGE, ABSOLUTE_TOP_OF_PAGE

To specify the desired percentage of ads to show at the targeted location, call withLocationFraction.

Arguments:

Name	Type	Description
locationType	String	The location type.

Return values:

Type	Description
AdsApp.BiddingStrategyArgsBuilder	A BiddingStrategyArgsBuilder with the specified location type.

withTargetRoas(targetRoas)

Sets the target roas for a bidding strategy. This is the desired revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0 inclusive.

Arguments:

Name	Type	Description
targetRoas	double	The cpc bid floor.

Return values:

Type	Description
AdsApp.BiddingStrategyArgsBuilder	A BiddingStrategyArgsBuilder with the specified target roas.