agentleFS
narayan-metaflownarayan-metaflow/metaflow-marketing-skills/skills/google-ads-keyword-engine/SKILL.md

google-ads-keyword-engine

Skill14 starsChanged 7 months agoMITView on GitHub

Research, evaluate, mine, and manage keywords for Google Ads — from initial discovery through ongoing search term optimization and negative keyword management.

The file

We split this skill into the rules it gives an agent

9 rules. About 0 are common, 9 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈9

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Run n-gram analysis (1-gram, 2-gram, 3-gram)

    line 19
  2. Distinctive:

    Update negative keyword lists

    line 23
  3. Distinctive:

    Start with real customer language, not internal jargon.

    line 27
  4. Distinctive:

    Critical requirement for broad match: Must be paired with Smart Bidding (tCPA or tROAS) and have 50+ conversions/month.

    line 72
  5. Distinctive:

    ECPC is deprecated (March 2025): If someone asks about broad match + ECPC, redirect to Manual CPC or Maximize Conversions as the bidding …

    line 74
  6. Distinctive:

    Add exact-match negatives to prevent campaigns from competing against each other

    line 127
  7. Distinctive:

    Don't build negative lists once and forget them: Search term review is ongoing: weekly for new campaigns, bi-weekly for stable ones.

    line 254
  8. Distinctive:

    ECPC is gone (March 2025): Don't reference it as a bidding option.

    line 257
  9. Distinctive:

    PMax search term visibility is here (2025): Use PMax search term insights and campaign-level negatives to manage cannibalization between …

    line 258

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Process

For new keyword research:

  1. Define the business, products/services, and target customer
  2. Mine customer language from VOC sources
  3. Build seed keyword list by intent category
  4. Expand using tools and techniques
  5. Evaluate and prioritize using the scoring framework
  6. Assign match types and organize into ad groups
  7. Build negative keyword lists

For search term analysis (existing campaigns):

  1. Pull search term report (minimum 90 days, or 30 days for new campaigns)
  2. Run n-gram analysis (1-gram, 2-gram, 3-gram)
  3. Identify waste (high spend, zero conversions)
  4. Identify winners (strong CPA/ROAS)
  5. Take action: negate, promote, or investigate
  6. Update negative keyword lists

Customer Language Mining

Start with real customer language, not internal jargon. These sources give you the words actual buyers use:

SourceWhat to ExtractHow to Use
Sales call recordingsExact phrases prospects use to describe problemsMap to high-intent keywords
Support ticketsCommon questions, complaint languageMap to informational and comparison keywords
Product reviews (yours)Feature language, benefit descriptionsFeed into RSA headlines and keyword themes
Competitor reviewsComplaints and unmet needsTarget competitor weakness terms
Reddit / QuoraThread titles, question phrasingLong-tail keyword discovery
Industry forumsTechnical terminology, emerging trendsNiche keyword expansion
Autocomplete / "related searches"Google's own language suggestionsValidate demand and discover variants

Keyword Evaluation Framework

Score every keyword candidate on four dimensions:

DimensionWeightHow to AssessScoring
Intent35%Commercial > Comparison > Informational > NavigationalCommercial intent = 10, Informational = 3
Volume25%Monthly search volume from Keyword PlannerRelative to niche: top 20% = 10, bottom 20% = 2
Competition20%Keyword Planner competition level + top-of-page bidLow competition + high intent = ideal
CPC20%Estimated cost vs target CPA marginCPC < 20% of target CPA = 10, CPC > 50% of target CPA = 3

Priority Score = (Intent × 0.35) + (Volume × 0.25) + (Competition × 0.20) + (CPC × 0.20)

Intent classification guide:

Intent TypeSignal WordsConversion LikelihoodExample
Commercialbuy, hire, pricing, cost, quote, near me, best, topHighest"hire plumber near me"
Comparisonvs, compare, review, alternative, whichHigh"hubspot vs salesforce"
Informationalhow to, what is, guide, tutorial, tipsLow (but useful for TOFU)"how to fix leaky faucet"
Navigational[brand name], login, websiteVaries"hubspot login"

Match Type Strategy (2025)

ScenarioRecommended Match TypeWhy
Mature account (50+ conversions/month) + Smart BiddingBroad match as defaultAlgorithm + Smart Bidding handles relevance. This is Google's 2025 recommendation
Brand termsExact matchProtect brand queries from broad expansion. Control messaging
High-intent, high-CPC termsExact matchPrecise control on expensive clicks
Controlled expansionPhrase matchCaptures variations while maintaining intent direction
New account (<30 conversions/month)Phrase + ExactNot enough data for broad match + Smart Bidding to work
Testing new keyword themesPhrase match firstGather data before committing to broad

Critical requirement for broad match: Must be paired with Smart Bidding (tCPA or tROAS) and have 50+ conversions/month. Broad match with manual bidding or low conversion volume will waste budget on irrelevant queries.

ECPC is deprecated (March 2025). If someone asks about broad match + ECPC, redirect to Manual CPC or Maximize Conversions as the bidding pair.

N-Gram Analysis Process

N-gram analysis breaks search queries into word-level components to find patterns invisible at the query level.

What it is:

  • 1-gram: single words ("shoes", "running", "waterproof")
  • 2-gram: word pairs ("running shoes", "waterproof shoes")
  • 3-gram: word triplets ("best running shoes", "waterproof trail shoes")

How to run it:

  1. Export search term report (90 days minimum, queries with 3+ impressions)
  2. Break every query into its n-grams
  3. Aggregate metrics by n-gram: total impressions, clicks, spend, conversions, CPA, ROAS
  4. Sort by spend descending to find biggest waste, or by CPA to find best performers

Action framework:

N-gram PatternCriteriaAction
High spend, 0 conversions$50+ spend AND 0 conversionsAdd as negative keyword
High spend, poor CPASpend > $100 AND CPA > 2x targetInvestigate — may need negative or ad group restructure
Strong CPA/ROASCPA < target AND 3+ conversionsPromote to exact-match keyword in dedicated ad group
High impressions, low CTR500+ impressions AND CTR < 1%Intent mismatch — investigate query relevance
Emerging themeMultiple related n-grams performing wellCreate new ad group around this theme

Fractional conversion warning: Data-driven attribution creates fractional conversions (e.g., 0.4 conversions). A keyword showing 0.3 conversions contributed to a conversion elsewhere. Filter to conversions > 1 before evaluating CPA to avoid false negatives.

Tools for n-gram analysis:

  • Brainlabs Search Query Mining Script (updated for GAQL by Nils Rooijmans, March 2025) — automated, runs in Google Ads
  • Adalysis — auto-generated n-gram reports
  • PEMAVOR Search Term Miner — free, no-code
  • BigQuery SQL — enterprise-scale analysis
  • For script implementation, use the google-ads-scripts skill

Negative Keyword Strategy

Themed Negative Lists

Build shared negative keyword lists by category and apply across relevant campaigns:

List ThemeExample NegativesApply To
Competitors[competitor brand names]All non-competitor campaigns
Jobs / Careersjobs, salary, careers, hiring, internship, glassdoorAll campaigns
Free / DIYfree, DIY, template, open source, how to, tutorialBottom-funnel campaigns
Education / Infowhat is, definition, wiki, course, certificationBottom-funnel campaigns
Geographic exclusions[irrelevant cities, states, countries]Geo-targeted campaigns
Irrelevant industries[industry terms not served]All campaigns
Negative modifierscheap, used, wholesale (if premium brand)Brand campaigns

Cross-Campaign Negatives

  • Add exact-match negatives to prevent campaigns from competing against each other
  • PMax cannibalization: if PMax search term insights show it's serving on queries your Search campaigns should own, add those as PMax negatives AND add them as exact-match keywords in Search

Maintenance Cadence

  • Week 1-4 of new campaigns: Review search terms weekly
  • Stable campaigns: Bi-weekly review
  • Always check: Negatives aren't blocking desired traffic (Brainlabs script has checkNegatives parameter)

Tool Recommendations

ToolBest ForCost
Google Keyword PlannerVolume, competition, bid estimates, forecastingFree (with Google Ads account)
SEMrushKeyword gap analysis, competitor keyword targeting$130+/mo
Keyword / SERP research suitesClick-through rate models, volume, content gapsVaries
PPC competitive intel toolsAuction and ad-copy researchVaries
AnswerThePublicQuestion-based queries, long-tail discoveryFree (limited) / $99+/mo
Google AutocompleteReal-time search suggestions, alphabet soup techniqueFree
Brainlabs ScriptAutomated n-gram analysis in Google AdsFree (open source)
AdalysisAuto-generated n-gram reports, keyword management$99+/mo
PEMAVORFree n-gram mining, no-codeFree

Output Format

For keyword research:

## Keyword Research: [Business/Product]

### Keyword List
| Keyword | Match Type | Intent | Volume | CPC | Competition | Priority Score | Ad Group |
|---------|-----------|--------|--------|-----|-------------|---------------|----------|
| [keyword] | Exact | Commercial | 1,200 | $4.50 | Medium | 8.2 | [group] |

### Ad Group Structure
- Ad Group: [Theme]
  - Keywords: [list with match types]
  - Negative keywords: [list]

### Negative Keyword Lists
- Competitors: [list]
- Jobs/Careers: [list]
- Free/DIY: [list]
- [Custom theme]: [list]

### Match Type Rationale
[Why these match types were chosen based on account maturity and conversion volume]

For search term analysis:

## Search Term Analysis: [Date Range]

### N-Gram Waste Report
| N-gram | Impressions | Clicks | Spend | Conversions | CPA | Action |
|--------|------------|--------|-------|-------------|-----|--------|
| [n-gram] | 2,400 | 89 | $312 | 0 | ∞ | Negate |

### Promotion Candidates
| Search Term | Clicks | Conversions | CPA | Current Match | Action |
|------------|--------|-------------|-----|---------------|--------|
| [term] | 45 | 12 | $18 | Broad trigger | Promote to exact in new ad group |

### Negative Keyword Additions
| Keyword | Match Type | List | Reason |
|---------|-----------|------|--------|
| [keyword] | Phrase | Jobs | Zero conversions, $89 spend |

### Summary
- Total waste identified: $[X]
- Promotion candidates: [N] terms
- New negatives added: [N] keywords across [N] lists

Example

Input: "I run a SaaS project management tool competing with two large incumbents. We're spending $20K/month on Google Ads with a $120 target CPA. We have 65 conversions/month. I need help with our keyword strategy and a search term cleanup."

Output:

Keyword Strategy & Search Term Analysis

Match Type Recommendation

With 65 conversions/month and active Smart Bidding, you qualify for broad match + tCPA as your primary strategy. Keep exact match for brand terms and highest-intent commercial keywords.

Keyword List (Top Priority Additions)

KeywordMatch TypeIntentEst. VolumeEst. CPCPriority ScoreAd Group
project management softwareBroadCommercial18,100$12.408.5PM Software - Core
team collaboration toolBroadCommercial6,600$9.807.8Collaboration Tools
asana alternativeExactComparison3,200$15.608.9Competitor Alternatives
monday.com alternativeExactComparison2,400$14.208.7Competitor Alternatives
best project management appPhraseComparison4,400$11.308.1PM Software - Best
project tracking softwareBroadCommercial2,900$10.507.4PM Software - Core
task management for teamsBroadCommercial1,800$8.907.2Task Management
project management tool for small businessPhraseCommercial1,200$7.607.6PM Software - SMB

N-Gram Waste Report (from search term analysis)

N-gramSpendConversionsCPAAction
"free"$8900∞Negate (phrase match)
"template"$4200∞Negate (phrase match)
"jobs"$3400∞Negate (exact to jobs list)
"certification"$2100∞Negate (phrase match)
"open source"$1800∞Negate (phrase match)
"what is"$1560∞Negate on BOFU campaigns only
Total waste$2,196/mo11% of budget recovered

Promotion Candidates

Search TermClicksConvCPAAction
project management for remote teams348$51Promote to exact in new "Remote Teams" ad group
simple project tracker225$53Promote to exact in "Task Management" group
replace asana186$45Promote to exact in "Competitor Alternatives" group

Negative Keyword Lists

  • Competitors (protect from brand overlap): asana, monday.com, clickup, notion, trello, basecamp, jira, wrike (applied as exact match to non-competitor campaigns)
  • Jobs/Careers: jobs, salary, careers, hiring, internship, glassdoor, project manager salary
  • Free/DIY: free, open source, template, free trial hack, cracked
  • Education: what is project management, certification, PMP, course, degree, tutorial

PMax Cannibalization Check

Review PMax search term insights for queries like "asana alternative" and "project management software" — these should be served by Search exact-match campaigns, not PMax. Add as PMax negatives if PMax is stealing them.

Guidelines

  • Don't recommend broad match without Smart Bidding + 50 conversions/month. This is a hard requirement. Broad match with manual bidding or low volume wastes budget on irrelevant queries.
  • Don't judge keywords on fractional conversions. Data-driven attribution creates fractions. A keyword with 0.4 conversions isn't failing — it contributed. Filter to > 1 conversion before evaluating CPA.
  • Don't build negative lists once and forget them. Search term review is ongoing: weekly for new campaigns, bi-weekly for stable ones.
  • Don't add negatives without checking for conflicts. A negative keyword can block a desired positive keyword. Always cross-reference.
  • Don't rely solely on Keyword Planner. It shows what people search, not how they think. VOC mining from sales calls, reviews, and forums reveals language Keyword Planner misses.
  • ECPC is gone (March 2025). Don't reference it as a bidding option. If someone's account still shows ECPC, flag it and recommend migration.
  • PMax search term visibility is here (2025). Use PMax search term insights and campaign-level negatives to manage cannibalization between PMax and Search.
  • Cross-references: For n-gram automation scripts, use the google-ads-scripts skill. For campaign building with these keywords, use the google-ads-campaign-builder skill. For ongoing keyword optimization, use the google-ads-optimizer skill. For full account audit including keyword health, use the google-ads-audit skill.
  • Confidence: Volume estimates from Keyword Planner are ranges, not exact numbers. CPC estimates can vary significantly from actuals. Present keyword data as directional, not precise.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.