Skip to content
Get MCP Ads, home

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…

View as Markdown

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.

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.
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.
namestringRequiredUnique name, as it will show in Google Ads' Advanced bid adjustments.
descriptionstringOptionaldescription.
startstringRequiredFirst moment covered, "YYYY-MM-DD" or "YYYY-MM-DD HH:mm:ss", in the account's time zone.
endstringRequiredEnd, exclusive: the day after the last day, "YYYY-MM-DD" or "YYYY-MM-DD HH:mm:ss". At most 14 days after start.
campaignIdsarrayOptionalCampaigns it applies to (numeric IDs of this customer). Use this or channels, not both.
channelsarrayOptionalEvery 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.
devicesarrayOptionalDevices it applies to; all devices when omitted.

Calling it

json · Through run_write_tool, since it is not announced
{
  "name": "run_write_tool",
  "arguments": {
    "name": "google_ads_create_data_exclusion",
    "args": {
      "customerId": "<string>",
      "currency": "<string>",
      "name": "<string>",
      "start": "<string>",
      "end": "<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