AdsApp.BiddingStrategyArgsBuilder
Stay organized with collections
Save and categorize content based on your preferences.
Builder for setting arguments when applying a bidding strategy to a campaign.
Methods:
args()
Returns a JavaScript object representation of the specified args.
Return values:
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:
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:
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:
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:
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:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-25 UTC.
[null,null,["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThe BiddingStrategyArgsBuilder is used to set arguments when applying a bidding strategy to a campaign.\u003c/p\u003e\n"],["\u003cp\u003eIt provides methods to configure parameters like CPC bid ceiling, Enhanced CPC, target ROAS, and location settings for ads.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eargs()\u003c/code\u003e returns a JavaScript object representing the specified arguments.\u003c/p\u003e\n"],["\u003cp\u003eYou can control the desired percentage of ads displayed in targeted locations using \u003ccode\u003ewithLocationFraction\u003c/code\u003e and \u003ccode\u003ewithLocationType\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEach method returns a BiddingStrategyArgsBuilder instance for chaining multiple configurations together.\u003c/p\u003e\n"]]],[],null,["# AdsApp.BiddingStrategyArgsBuilder\n\nBuilder for setting arguments when applying a bidding strategy to a campaign.\n\n### Methods:\n\n| Member | Type | Description |\n|------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------|\n| [args()](#args) | [AdsApp.BiddingStrategyArgs](/google-ads/scripts/docs/reference/adsapp/adsapp_biddingstrategyargs) | Returns a JavaScript object representation of the specified args. |\n| [withCpcBidCeiling(cpc)](#withCpcBidCeiling_cpc) | [AdsApp.BiddingStrategyArgsBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_biddingstrategyargsbuilder) | Sets the cpc bid ceiling for a bidding strategy (specified in the account's currency). |\n| [withEnhancedCpcEnabled(enhancedCpcEnabled)](#withEnhancedCpcEnabled_enhancedCpcEnabled) | [AdsApp.BiddingStrategyArgsBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_biddingstrategyargsbuilder) | Enables or disables enhanced cpc for a bidding strategy. |\n| [withLocationFraction(locationFraction)](#withLocationFraction_locationFraction) | [AdsApp.BiddingStrategyArgsBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_biddingstrategyargsbuilder) | Sets the desired percentage of ads to be shown in the targeted location. |\n| [withLocationType(locationType)](#withLocationType_locationType) | [AdsApp.BiddingStrategyArgsBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_biddingstrategyargsbuilder) | Sets the targeted location for ads. |\n| [withTargetRoas(targetRoas)](#withTargetRoas_targetRoas) | [AdsApp.BiddingStrategyArgsBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_biddingstrategyargsbuilder) | Sets the target roas for a bidding strategy. |\n\n`args()`\n--------\n\nReturns a JavaScript object representation of the specified args.\n\n### Return values:\n\n| Type | Description |\n|----------------------------------------------------------------------------------------------------|----------------------------------------------------|\n| [AdsApp.BiddingStrategyArgs](/google-ads/scripts/docs/reference/adsapp/adsapp_biddingstrategyargs) | A JavaScript object representation of the builder. |\n\n`withCpcBidCeiling(cpc)`\n------------------------\n\nSets the cpc bid ceiling for a bidding strategy (specified in the account's currency).\n\n### Arguments:\n\n| Name | Type | Description |\n|------|----------|----------------------|\n| cpc | `double` | The cpc bid ceiling. |\n\n### Return values:\n\n| Type | Description |\n|------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------|\n| [AdsApp.BiddingStrategyArgsBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_biddingstrategyargsbuilder) | A BiddingStrategyArgsBuilder with the specified cpc bid ceiling. |\n\n`withEnhancedCpcEnabled(enhancedCpcEnabled)`\n--------------------------------------------\n\nEnables or disables enhanced cpc for a bidding strategy.\n\n### Arguments:\n\n| Name | Type | Description |\n|--------------------|-----------|----------------------------------------------|\n| enhancedCpcEnabled | `boolean` | Whether enhanced cpc is enabled or disabled. |\n\n### Return values:\n\n| Type | Description |\n|------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------|\n| [AdsApp.BiddingStrategyArgsBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_biddingstrategyargsbuilder) | A BiddingStrategyArgsBuilder with the specified value for enhanced cpc. |\n\n`withLocationFraction(locationFraction)`\n----------------------------------------\n\nSets 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.\n\n### Arguments:\n\n| Name | Type | Description |\n|------------------|----------|------------------------|\n| locationFraction | `double` | The location fraction. |\n\n### Return values:\n\n| Type | Description |\n|------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|\n| [AdsApp.BiddingStrategyArgsBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_biddingstrategyargsbuilder) | A BiddingStrategyArgsBuilder with the specified location fraction. |\n\n`withLocationType(locationType)`\n--------------------------------\n\nSets the targeted location for ads. Accepted values are: ANYWHERE_ON_PAGE, TOP_OF_PAGE, ABSOLUTE_TOP_OF_PAGE\n\nTo specify the desired percentage of ads to show at the targeted\nlocation, call withLocationFraction.\n\n### Arguments:\n\n| Name | Type | Description |\n|--------------|----------|--------------------|\n| locationType | `String` | The location type. |\n\n### Return values:\n\n| Type | Description |\n|------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------|\n| [AdsApp.BiddingStrategyArgsBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_biddingstrategyargsbuilder) | A BiddingStrategyArgsBuilder with the specified location type. |\n\n`withTargetRoas(targetRoas)`\n----------------------------\n\nSets 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.\n\n### Arguments:\n\n| Name | Type | Description |\n|------------|----------|--------------------|\n| targetRoas | `double` | The cpc bid floor. |\n\n### Return values:\n\n| Type | Description |\n|------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------|\n| [AdsApp.BiddingStrategyArgsBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_biddingstrategyargsbuilder) | A BiddingStrategyArgsBuilder with the specified target roas. |"]]
