Skip to content
John Williams edited this page Jul 20, 2026 · 4 revisions

Google Ads Cleanup Scripts — Negative Keywords, Blocked Search Terms & Placement Exclusions

Free open-source Google Ads Scripts that recover blocked converting search terms, remove negative keyword conflicts, and automatically exclude brand-misaligned placements — across account, campaign (including Performance Max), ad group, and shared list levels.

Built by John Williams, founder of AHMEEGO™ / It All Started With A Idea LLC — 15+ years of enterprise paid media, $350M+ in managed ad spend, creator of Buddy the Google Ads AI Agent.

Blocked Search Term Recovery

Start Here

Page What You'll Learn
Installation Guide Step-by-step setup in the Google Ads Scripts editor (2 minutes)
Blocked Search Term Recovery Script The flagship script — audits negatives against real conversion history
Negative Keyword Conflict Cleaner Classic keyword-vs-negative conflict detection and removal
MCC Version Run the conflict cleaner across up to 50 accounts in a manager account
Negative Placement Guardian Weekly automated placement exclusions for Display, YouTube & PMax
Customizing for Your Vertical Retune the placement blocklist for any industry — with Claude or manually
Troubleshooting Real errors and fixes: AdsApp.negativeKeywords is not a function, QueryError.UNRECOGNIZED_FIELD, and more
FAQ How negative keyword matching actually works, close variants, PMax exclusions

The Toolkit

Negative keyword recovery — Google Ads keywords match queries loosely (close variants) while negative keywords match literally. That asymmetry lets negatives silently block converting search terms without ever conflicting with a keyword. The Recovery script audits negatives against real search term performance and unblocks the converters; the Conflict Cleaner handles literal keyword conflicts at every level, single account or across an MCC.

Placement hygiene — Display and Performance Max campaigns bleed budget into kids' apps, mobile games, and junk inventory by default. The Placement Guardian runs weekly, excluding misaligned placements by pattern and by performance — routing exclusions to campaign level for Display/Video and account level for PMax (the only level PMax respects). Ships tuned for a beauty brand; retune it for any vertical in minutes.

Community & More Tools

  • Reddit: r/ppc_ — share results, ask questions, request features
  • AHMEEGO™ ecosystem: ahmeego.com — Buddy (Google Ads AI agent for web, iOS & Android), free Google Ads auditor, google-ads-mcp server, 77-skill open-source agent repo
  • Follow the build: LinkedIn · Substack

About It All Started With A Idea LLC

It All Started With A Idea LLC (AHMEEGO™) Performance marketing studio & AI advertising tools Queen Creek, Arizona, United States Web: itallstartedwithaidea.com · ahmeego.com · googleadsagent.ai


Tags: google ads scripts, negative keyword conflicts, unblock converted keywords, blocked search terms, negative placement exclusions, placement exclusion script, brand safety google ads, performance max placement exclusions, display network cleanup, google ads automation, PPC scripts, GAQL, AHMEEGO, Buddy Google Ads AI agent, It All Started With A Idea, Queen Creek Arizona, r/ppc_

Clone this wiki locally