Skip to content
Get MCP Ads, home

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 Markdown

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.

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, DEMAND_GEN (DEMAND_GEN in beta). For Performance Max, list its campaigns in campaignIds. Use this or campaignIds, not both.
devicesarrayOptionalDevices it applies to; all devices when omitted.
conversionRateModifiernumberRequiredExpected change of the conversion rate, as a multiplier: 1.3 for +30%, 0.7 for -30%. Between 0.1 and 10.

Calling it

json · Through run_write_tool, since it is not announced
{
  "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

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.

Esc

Type to search