# google_ads_create_seasonality_adjustment

> Tell Smart Bidding to expect a short change in conversion rate (a sale, Black Friday, a launch), as Google Ads' Tools > Advanced bid adjustments >…

[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 expect a short change in conversion rate (a sale, Black Friday, a launch), as Google Ads' Tools > Advanced bid adjustments > Seasonality adjustments does. Forward looking: start and end in the future, at most 14 days, ideally 1 to 7. Applies to listed campaigns (any type Google accepts, Performance Max included) or to every campaign of a channel (SEARCH, SHOPPING, DISPLAY, DEMAND_GEN in beta). Google applies it to Target CPA and Target ROAS on Search, Shopping, Display and Demand Gen, and to every bid strategy on Performance Max. 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_seasonality_adjustment.

> **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, DEMAND_GEN (DEMAND_GEN in beta). 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. |
| `conversionRateModifier` | number | Required | Expected change of the conversion rate, as a multiplier: 1.3 for +30%, 0.7 for -30%. Between 0.1 and 10. |

## Calling it

Through run_write_tool, since it is not announced

```json
{
  "name": "run_write_tool",
  "arguments": {
    "name": "google_ads_create_seasonality_adjustment",
    "args": {
      "customerId": "<string>",
      "currency": "<string>",
      "name": "<string>",
      "start": "<string>",
      "end": "<string>",
      "conversionRateModifier": "<number>"
    }
  }
}
```

- [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_seasonality_adjustment
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.
