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 MarkdownChange 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.
- Source
- Google Ads
- Kind
- Write
- Discovery
- Reachable through
search_toolsandrun_write_tool - Account parameter
customerId- Endpoint
- https:/
/ mcp. getmcpads. com/ google-ads/ mcp
Parameters
| Name | Type | Required | Notes |
|---|---|---|---|
customerId | string | Required | Selected Google Ads customer ID, not the manager account. |
currency | string | Required | Actual account currency as a three-letter ISO code; verified natively before writes. |
campaignId | string | Optional | Campaign whose own target changes. Use exactly one of campaignId, adGroupId, biddingStrategyId. |
adGroupId | string | Optional | Ad group whose target override changes (Search, Display, Demand Gen; Performance Max has no ad groups). |
biddingStrategyId | string | Optional | Portfolio bid strategy of this customer: the target changes for every campaign using it, listed in the preview. |
targetCpa | number | Optional | New target CPA in the account currency, e.g. 25.5. For Target CPA and Maximize conversions. |
targetRoasPercent | number | Optional | New 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. |
clearTarget | boolean | Optional | true removes the optional target of Maximize conversions or Maximize conversion value, or an ad group's override. Use instead of a value. |
loginCustomerId | string | Optional | Optional MCC ID; defaults to the selected account's inferred manager. |
testAccountOnly | boolean | Optional | Require customer.test_account=true before writing. Use true when testing on a Google Ads test account. |
validateOnly | boolean | Optional | Ask Google to validate without applying. Takes priority over confirm. |
confirm | boolean | Optional | Apply only when true and expectedPlanHash matches the exact preview. |
expectedPlanHash | string | Optional | SHA-256 planHash from the preview of this exact payload, required for application. |
Calling it
{
"name": "run_write_tool",
"arguments": {
"name": "google_ads_update_bidding_target",
"args": {
"customerId": "<string>",
"currency": "<string>"
}
}
}Manage your ads from your AI assistant
Free with 1 ad account, no card. Pro is free for 7 days.