Skip to content
Get MCP Ads, home

google_ads_update_bidding_target

Change the target CPA or target ROAS Smart Bidding aims for, on a campaign, an ad group override or a portfolio bid strategy, as editing the target…

View as Markdown

Change the target CPA or target ROAS Smart Bidding aims for, on a campaign, an ad group override or a portfolio bid strategy, as editing the target in Google Ads does. The target goes in the field of the strategy already in place (Target CPA, Maximize conversions, Target ROAS, Maximize conversion value); the tool never switches the bid strategy and refuses a target that does not fit it. targetCpa is in the account currency, targetRoasPercent in percent (350 = 350%); clearTarget removes an optional target or an ad group override. A campaign on a portfolio strategy is changed through biddingStrategyId. Preview reads the current target, the strategy and the campaigns concerned, shows the change in percent and flags changes above 20%, which Smart Bidding needs time to absorb; it returns planHash. validateOnly asks Google; confirm requires the matching expectedPlanHash, then reads the target back.

Kind
Write
Discovery
Reachable through search_tools and run_write_tool
Account parameter
customerId
Endpoint
https://mcp.getmcpads.com/google-ads/mcp

Parameters

Parameters
NameTypeRequiredNotes
customerIdstringRequiredSelected Google Ads customer ID, not the manager account.
currencystringRequiredActual account currency as a three-letter ISO code; verified natively before writes.
campaignIdstringOptionalCampaign whose own target changes. Use exactly one of campaignId, adGroupId, biddingStrategyId.
adGroupIdstringOptionalAd group whose target override changes (Search, Display, Demand Gen; Performance Max has no ad groups).
biddingStrategyIdstringOptionalPortfolio bid strategy of this customer: the target changes for every campaign using it, listed in the preview.
targetCpanumberOptionalNew target CPA in the account currency, e.g. 25.5. For Target CPA and Maximize conversions.
targetRoasPercentnumberOptionalNew target ROAS in percent, as Google Ads shows it: 350 means 3.50 of conversion value per unit spent. For Target ROAS and Maximize conversion value.
clearTargetbooleanOptionaltrue removes the optional target of Maximize conversions or Maximize conversion value, or an ad group's override. Use instead of a value.
loginCustomerIdstringOptionalOptional MCC ID; defaults to the selected account's inferred manager.
testAccountOnlybooleanOptionalRequire customer.test_account=true before writing. Use true when testing on a Google Ads test account.
validateOnlybooleanOptionalAsk Google to validate without applying. Takes priority over confirm.
confirmbooleanOptionalApply only when true and expectedPlanHash matches the exact preview.
expectedPlanHashstringOptionalSHA-256 planHash from the preview of this exact payload, required for application.

Calling it

json · Through run_write_tool, since it is not announced
{
  "name": "run_write_tool",
  "arguments": {
    "name": "google_ads_update_bidding_target",
    "args": {
      "customerId": "<string>",
      "currency": "<string>"
    }
  }
}

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.

Esc

Type to search