BudgetOptimizerSettings (AdWords API Developer's Guide)

Note: JavaScript must be enabled for you to properly view versions. It seems JavaScript is either disabled or is not supported by your browser, which causes all versions of text to be simultaneously displayed. Enable JavaScript in your browser options, then try again.

Skip to main content Skip to main menu

Introduction
Release Notes
Web Services
Sandbox
API Reference

Close all submenus

Open all submenus
- AccountService
  - AccountInfo
    - Address
    - EmailPromotions
      Preferences
- AdGroupService
  - AdGroup
- AdService
  - Business
  - CommerceAd sandbox
  - ImageAd
    - Image
  - LocalBusinessAd
  - MobileAd
  - TextAd
  - VideoAd
    - Video
- CampaignService
  - Campaign
    - AdSchedule
      - SchedulingInterval
    - BudgetOptimizerSettings
    - ConversionOptimizer Settings +V12
    - GeoTarget
      - CityTargets +V10
      - CountryTargets +V10
      - MetroTargets +V10
      - RegionTargets +V10
      - ProximityTargets +V10
        
        Circle +v10
    - LanguageTarget
    - NetworkTarget
  - ConversionOptimizer Eligibility +V12
- CriterionService
  - Keyword
  - Website
- InfoService
  - ClientUsageRecord
- KeywordToolService
- ReportService
  - DefinedReportJob +V11
  - AccountReportJob −V11
  - AdImageReportJob −V11
  - AdGroupReportJob −V11
  - AdTextReportJob −V11
  - CampaignReportJob −V11
  - CustomReportJob −V11
  - KeywordReportJob −V11
  - UrlReportJob −V11
- SiteSuggestionService +V10
  - DemographicsTarget +V10
  - Language GeoTargeting +V10
  - SiteSuggestion +V10
- TrafficEstimatorService
  - CampaignEstimate
    - AdGroupEstimate
      - KeywordEstimate
  - CampaignRequest
    - AdGroupRequest
      - KeywordRequest
- General Data Types
  - StatsRecord
- Exception Types
  - ApiError
  - ApiException
International Codes
Report Rules +V11
- Account +V11
- Account Structure +V11
- Ad +V11
- Ad Group +V11
- Campaign +V11
- Placement +V11
- Placement / Keyword +V11
- Reach and Frequency +V11
- Url +V11
Error Codes
API Rate Sheet
Index

AdWords API Resources

Developer Forum

AdWords API Blog

BudgetOptimizerSettings

The settings for budget optimizer.

When budget optimizer is enabled, ad groups and keywords associated with this campaign will have their proxyKeywordMaxCpc and proxyMaxCpc fields set, respectively.

Note:AdWords API older than V12 support only a daily budget. You can effectively use a monthly budget by setting Campaign.dailyBudget to (desired budget / 30).

Fields

bidCeiling
enabled
takeOnOptimizedBids

Field name	Field type	Field description
`bidCeiling`	`long`	The ceiling on bids placed by the budget optimizer. On read, will be included if the budget optimizer is enabled. On write, is only relevant if the budget optimizer is enabled, or being enabled.
`enabled`	`boolean`	True if budget optimizer is enabled.
`takeOnOptimizedBids`	`boolean`	If you are disabling budget optimizer, set this field to true to replace the original user bids with the optimized proxy bids. If set to false or omitted, the original manual bids are kept. This field is write only.