Skip to content
Get MCP Ads, home

google_ads_set_budget_network_priorities

Set which networks a campaign budget pays for first, as Google Ads' budget network priorities do (API v26.1).

View as Markdown

Set which networks a campaign budget pays for first, as Google Ads' budget network priorities do (API v26.1). Google's own channels stay on the primary tier; networks listed in secondary (search partners, Display) are served only from what is left, and on Performance Max and Search each can be capped at a share of the budget, 0% to turn it off. Performance Max, Search and Demand Gen daily budgets only; not on custom-period budgets. Replaces this budget's priorities for the campaign's type; reset:true goes back to the account's defaults. Preview reads the campaign, its budget, the campaigns sharing it and the current priorities, and returns planHash; validateOnly asks Google; confirm requires the matching expectedPlanHash. Read them back with google_ads_run_gaql: SELECT campaign_budget.budget_network_settings.settings FROM campaign_budget.

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.
campaignIdstringRequiredCampaign whose budget gets the priorities (numeric ID of this customer). The setting lives on the budget: a shared budget carries it for every campaign of the same type on it.
secondaryarrayOptionalNetworks served only from what Google's own channels (Search, YouTube, Gmail, Discover, Maps) leave of the budget. An empty list puts every network on the same tier. Performance Max and Search accept SEARCH_PARTNER and GOOGLE_DISPLAY; Demand Gen accepts GOOGLE_DISPLAY.
capsobjectOptionalShare of the whole budget a lower-priority network may spend at most, in percent (10 = 10%, 0 = never). Only for networks listed in secondary; Performance Max and Search only, Google refuses caps on Demand Gen.
resetbooleanOptionaltrue removes this budget's priorities: the account's defaults apply again. Use instead of secondary and caps.
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.

Calling it

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