# google_ads_create_data_exclusion

> Tell Smart Bidding to ignore the conversion data of a period that was wrong (a tracking outage, a broken checkout, a test), as Google Ads' Tools > Advanced…

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

Tell Smart Bidding to ignore the conversion data of a period that was wrong (a tracking outage, a broken checkout, a test), as Google Ads' Tools > Advanced bid adjustments > Data exclusions does. Backward looking: it may start in the past; at most 14 days. Applies to listed campaigns or to every campaign of a channel (SEARCH, SHOPPING, DISPLAY). At most 500 active per account; not in a manager account. Preview returns planHash; validateOnly asks Google; confirm requires the matching expectedPlanHash. List existing ones with google_ads_run_gaql FROM bidding_data_exclusion.

> **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. |
| `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. |
| `name` | string | Required | Unique name, as it will show in Google Ads' Advanced bid adjustments. |
| `description` | string | Optional | description. |
| `start` | string | Required | First moment covered, "YYYY-MM-DD" or "YYYY-MM-DD HH:mm:ss", in the account's time zone. |
| `end` | string | Required | End, exclusive: the day after the last day, "YYYY-MM-DD" or "YYYY-MM-DD HH:mm:ss". At most 14 days after start. |
| `campaignIds` | array | Optional | Campaigns it applies to (numeric IDs of this customer). Use this or channels, not both. |
| `channels` | array | Optional | Every campaign of these types in the account. Google accepts SEARCH, SHOPPING, DISPLAY. For Performance Max, list its campaigns in campaignIds. Use this or campaignIds, not both. |
| `devices` | array | Optional | Devices it applies to; all devices when omitted. |

## Calling it

Through run_write_tool, since it is not announced

```json
{
  "name": "run_write_tool",
  "arguments": {
    "name": "google_ads_create_data_exclusion",
    "args": {
      "customerId": "<string>",
      "currency": "<string>",
      "name": "<string>",
      "start": "<string>",
      "end": "<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_create_data_exclusion
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.
