{ "schema": "aiblocks-page/1", "id": "build-the-keyword-tier-classifier-builder-prompt", "type": "prompt", "name": "Keyword grouping coding brief writer", "summary": "Get a coding brief that sorts Google Ads keywords into five tiers by results, flags the ones to pause, and shows week-to-week moves. Read-only.", "headline": "Keyword grouping coding brief writer", "subhead": "Give your coding assistant your project, your target return and your brand terms. It plans a read-only module that sorts each Google Ads keyword into five tiers, from hero to zombie. It also shows which keywords moved since the last run. It never changes your account.", "job": { "id": "build-software", "name": "Build and ship software" }, "level": "intermediate", "thinking": "medium", "tested": true, "updated": "2026-11-03", "first_published": "2026-10-25", "inputs": [ { "type": "codebase", "required": true, "label": "Codebase", "what": "a project's code, in a folder or repo the AI can open" } ], "outputs": [ { "type": "code_change", "required": true, "label": "Code change", "what": "a change to the code, with what it fixes and how it was checked" } ], "you_give": [ "Your code project, or its main folders and database schema, with where past audit runs are saved", "The customer ID and the names of the credentials your project uses (never the secrets)", "Your target ROAS or CPA (needed for the hero and volume driver tiers)", "Your brand terms, so brand keywords are not called zombies", "The date range to review, and the last run to compare with (optional)", "Google Ads API read access. It is free, but it needs a developer token that Google approves. The Google Ads token and access check planner shows how to set it up. Without it the module is written but cannot run." ], "you_get": [ "A list of setup gaps before any code is written", "A read-only module that sorts keywords into five tiers", "Findings with a proposed action for each tier", "Week-to-week moves, once a first run is saved", "Test cases and a sample result built from made-up rows" ], "use_when": [ "You manage a Search account and can't tell which keywords earn their spend.", "You want a weekly list of keywords to pause and keywords to back.", "You want to see which keywords moved up or down since last week.", "You already have Google Ads code in a project and want the tiers saved with your other audit results." ], "skip_when": [ "You want to group search terms people typed, or find negative keywords. Use the Google search term code planner.", "Your account has no conversion tracking. Tiers by results would mean nothing. Fix tracking first. The Google Ads report auditor can help check.", "You want a one-time review and no code. Paste your export into the Google Ads report auditor.", "You want it to pause keywords or change bids for you. It only proposes them. You apply them in Google Ads." ], "output_sample": { "input": [ "Your code project, or its main folders and database schema", "The customer ID and the names of your Google Ads credentials", "Your target ROAS or CPA, and your brand terms", "The last saved run to compare with (optional)" ], "prerequisites": [ "A coding assistant that can open your project, such as Claude Code or Codex", "Google Ads API access with read permission, set up before you run the module", "Conversion tracking that works in the account" ], "output": [ { "name": "Setup gaps", "contains": "Missing schemas, permissions, targets and brand terms, each with what it stops." }, { "name": "Function signature", "contains": "The inputs and result type of the tier function in your project." }, { "name": "Sample DiagnosticOutput", "contains": "Findings from made-up rows, one tier at a time, each with evidence and a proposed action." }, { "name": "Distribution and spend share", "contains": "How many keywords sit in each tier and what share of cost each tier takes." }, { "name": "Test results", "contains": "Tests for each tier, the test order, brand protection and movement, or a note that none were run." } ] }, "output_shape": "SETUP GAPS\n\n\nFUNCTION SIGNATURE\nclassifyKeywordTiers() -> DiagnosticOutput\n\nSAMPLE DiagnosticOutput (made-up rows)\n\n\nDISTRIBUTION AND SPEND SHARE\n | | \n\nTEST RESULTS\n\n\nNEXT STEP\n", "how_to_use": [ "Open your coding assistant, such as Claude Code or Codex, in your project folder. A plain chat AI can only write a plan.", "Paste the skill, then add your target return, brand terms and project details. Never paste a secret key.", "Read the setup gaps first. Fix each one, or tell the assistant to go on with placeholders.", "Say yes to each starting limit or change it. A wrong limit puts keywords in the wrong tier.", "Read every change before you accept it. Run the tests in your own project.", "Treat each finding as a proposal. Check a few keywords in Google Ads before you pause or change anything." ], "checks": [], "next": [ { "name": "Simple code coach", "url": "https://useaiblocks.com/skills/simple-code-coach", "why": "Build it" } ], "source": null, "credits": [], "files": [ "references/worked-example.md" ], "links": { "page": "https://useaiblocks.com/prompts/build-the-keyword-tier-classifier-builder-prompt", "markdown": "https://useaiblocks.com/prompts/build-the-keyword-tier-classifier-builder-prompt.md", "json": "https://useaiblocks.com/prompts/build-the-keyword-tier-classifier-builder-prompt.json", "instructions": "https://useaiblocks.com/skills/build-the-keyword-tier-classifier-builder-prompt/SKILL.md", "download": "https://useaiblocks.com/skills/build-the-keyword-tier-classifier-builder-prompt.zip", "api_item": "https://useaiblocks.com/api/v1/items/build-the-keyword-tier-classifier-builder-prompt", "api_document": "https://useaiblocks.com/api/v1/documents/prompt/build-the-keyword-tier-classifier-builder-prompt", "mcp": "https://useaiblocks.com/mcp" } }