Repository navigation
update_campaign: read and set the campaign-level broad match setting #106
Description
Situation. Our Search campaigns are exact and phrase match only, under Maximize clicks, on purpose. draft_ai_max_settings keeps AI Max and its automations off, which is great. The other setting that would let Google widen matching is the campaign-level broad match setting, and AdLoop can't read or write it. So our weekly audit can't prove a campaign stayed exact/phrase. It needs a person to open the UI.
What I tried. run_gaql with campaign.keyword_match_type reads it: our API-created campaigns return UNSPECIFIED, which I take to mean "not broad". There's no write path, and nothing in the tool docs or rules mentions the field, so an agent wouldn't know to check it.
What the API offers. Campaign.keyword_match_type (CampaignKeywordMatchType: BROAD, or unset). Setting BROAD makes every keyword in the campaign match as broad.
Proposed change.
- Read: surface
keyword_match_typeinget_campaign_performance, or in a small settings read tool (see get_campaign_settings: one read for every setting that widens reach #109). - Write: an optional
keyword_match_typeonupdate_campaign. Turning broad on would go through the same checkdraft_campaignalready applies to BROAD keywords (refused without Smart Bidding) and get a double confirmation, since it changes how every keyword in the campaign matches. Turning it off is the safe direction.
Happy to PR after we agree on the safety behaviour for switching it on; that's the part I'd want your view on first.
Activity
kLOsk commentedon Oct 27, 2026
Agreed on the safety behaviour, so go ahead:
get_campaign_settings(0.36.0) returnskeyword_match_typeand names campaign-level broad match inwidening_settings.keyword_match_typeonupdate_campaignonly. New campaigns keep Google's default, sodraft_campaigndoesn't need it yet.xgp commentedon Oct 27, 2026
Thanks. PR is up: #117.
keyword_match_typeonupdate_campaignonly.BROADis refused unless the campaign (or thebidding_strategyin the same call) is in_SMART_BIDDING_STRATEGIES, the same set the BROAD-keyword checks use, and it needs a double confirmation.UNSPECIFIEDturns it off with a single confirmation. One follow-up question is in the PR: moving a campaign that already has broad on off Smart Bidding.update_campaign: campaign-level broad match
update_campaign: campaign-level broad match