{ "schema": "aiblocks-page/1", "id": "build-the-quality-score-triage-module-builder-prompt", "type": "prompt", "name": "Google Ads Quality Score tool planner", "summary": "Build a read-only Google Ads Quality Score review in your code. Get a prompt that groups keywords by cause and ranks fixes by spend.", "headline": "Google Ads Quality Score tool planner", "subhead": "Paste one prompt into a coding AI such as Claude Code. It builds a read-only module that sorts your Google Ads keywords by what is dragging Quality Score down. You get groups by ad group and cause, one fix per group, ranked by spend, and keywords with no data listed apart.", "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": [ "A code project and a coding AI, such as Claude Code, that can edit it", "Keyword rows with cost, Quality Score and its three part ratings, from the Google Ads API or sample rows", "The date range and account currency", "Your spend floor and cost bands for severity (optional, the prompt gives starting values)" ], "you_get": [ "A prompt that builds one read-only review function with typed input and output", "An eight-row table that diagnoses every mix of weak and fine parts", "One finding per ad group and cause, ranked by spend, with a fix for each", "A summary with the share of spend on low Quality Score, and keywords listed as not evaluated", "Tests on sample rows, with no real account used" ], "use_when": [ "You are building your own Google Ads review tool and want a clear Quality Score step in it.", "Your keywords are costing more than they should and you want to know whether the ads or the landing pages are the problem.", "A developer needs a complete brief for a Quality Score module, including the full diagnosis table.", "You want one fix per ad group, not a long list of single keywords." ], "skip_when": [ "You only want a review of your own numbers, not software: use the Google Ads store account auditor or the Google Ads report auditor.", "You have no way to read Google Ads data yet: set up access first with the Google Ads developer access checker.", "Your account has a handful of keywords and no coding project: the numbers will not give a clear picture, so check them by hand in Google Ads.", "You want a full audit engine with many checks: use the Google Ads audit engine builder." ], "output_sample": { "input": [ "Your code project, open in a coding AI", "Keyword rows with cost, Quality Score and its three part ratings", "The date range and account currency", "Your spend floor and cost bands (optional)" ], "prerequisites": [ "Google Ads API read access, or typed sample rows to start with", "A coding AI that can read and edit your project" ], "output": [ { "name": "reviewQualityScore function", "contains": "One read-only function with typed input and output, in your project's language and style." }, { "name": "Diagnosis table", "contains": "Eight rows covering every mix of weak and fine parts, with a cause name for each." }, { "name": "Findings", "contains": "One per ad group and cause, with affected keywords, cost, severity and a starting fix." }, { "name": "Summary block", "contains": "The count per diagnosis, the share of spend on low Quality Score with its sums, and the top groups." }, { "name": "Not evaluated list", "contains": "Keywords with no part ratings, with the spend they hold, so none count as healthy." }, { "name": "Tests and assumptions", "contains": "Tests for every table row and the thresholds you need to review." } ] }, "output_shape": "Function: reviewQualityScore(input) -> DiagnosticOutput\nFindings (one per ad group and cause):\n checkId: qs- | severity | ad group | keywords | cost | fix\nSummary:\n distribution: \n spendShareLowQs: of \n topGroups: \nThresholds and assumptions to review: \nTests: ", "how_to_use": [ "Decide where keyword data comes from. If you have code that fetches it, tell the AI where it is. If not, the prompt builds the function to take typed rows.", "Copy the prompt from the skill and fill in the angle brackets, including your spend floor and cost bands. Paste it into your coding AI with your project open.", "Read what the AI says about your project first. If it lists missing pieces, decide whether to add them or build without them.", "Check the thresholds it lists. The spend floor and cost bands are starting guesses, so set your own before you trust the severity labels. Then run the tests on sample rows.", "Run it on a live account only when you decide to, read-only. Review monthly, not weekly.", "Use the fixes as a to-do list for your ads and landing pages. Nothing is changed for you." ], "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-quality-score-triage-module-builder-prompt", "markdown": "https://useaiblocks.com/prompts/build-the-quality-score-triage-module-builder-prompt.md", "json": "https://useaiblocks.com/prompts/build-the-quality-score-triage-module-builder-prompt.json", "instructions": "https://useaiblocks.com/skills/build-the-quality-score-triage-module-builder-prompt/SKILL.md", "download": "https://useaiblocks.com/skills/build-the-quality-score-triage-module-builder-prompt.zip", "api_item": "https://useaiblocks.com/api/v1/items/build-the-quality-score-triage-module-builder-prompt", "api_document": "https://useaiblocks.com/api/v1/documents/prompt/build-the-quality-score-triage-module-builder-prompt", "mcp": "https://useaiblocks.com/mcp" } }