# 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…

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [Google Ads](https://www.getmcpads.com/docs/sources/google-ads)

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.

> **Warning** This tool changes the account. It is absent from the tool list on the Free plan, and it previews by default: without `confirm: true` it describes the change and applies nothing.

|  |  |
| --- | --- |
| Source | [Google Ads](https://www.getmcpads.com/docs/sources/google-ads) |
| Kind | Write |
| Discovery | Reachable through `search_tools` and `run_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

Through run_write_tool, since it is not announced

```json
{
  "name": "run_write_tool",
  "arguments": {
    "name": "google_ads_update_bidding_target",
    "args": {
      "customerId": "<string>",
      "currency": "<string>"
    }
  }
}
```

- [Google Ads metrics](https://www.getmcpads.com/docs/sources/google-ads/metrics): What you can ask for.
- [Google Ads dimensions](https://www.getmcpads.com/docs/sources/google-ads/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_update_bidding_target
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.
