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 >…
View as MarkdownTell 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.
- 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. |
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
{
"name": "run_write_tool",
"arguments": {
"name": "google_ads_create_seasonality_adjustment",
"args": {
"customerId": "<string>",
"currency": "<string>",
"name": "<string>",
"start": "<string>",
"end": "<string>",
"conversionRateModifier": "<number>"
}
}
}Manage your ads from your AI assistant
Free with 1 ad account, no card. Pro is free for 7 days.