{ "schema": "aiblocks-page/1", "id": "google-ads-report-code-builder-prompt", "type": "prompt", "name": "Google Ads report code planner", "summary": "Get a coding brief to build a Google Ads monthly report generator, with correct dates, spend math, tests and clear gaps. Needs your code.", "headline": "Google Ads report code planner", "subhead": "Give your AI your code folder and your Google Ads details. You get a coding brief for a monthly Google Ads report. It covers the report parts, the math, the tests and what is still missing.", "job": { "id": "build-software", "name": "Build and ship software" }, "level": "intermediate", "thinking": "medium", "tested": true, "updated": "2026-10-28", "first_published": "2026-10-25", "inputs": [ { "type": "question", "required": true, "label": "Question", "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like" }, { "type": "codebase", "required": false, "label": "Codebase", "what": "a project's code, in a folder or repo the AI can open" }, { "type": "spreadsheet", "required": false, "label": "Spreadsheet", "what": "a spreadsheet with its data, formulas and charts" } ], "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 Google Ads customer ID", "The report dates and a comparison period", "Your account timezone and currency", "A Google Ads export (a CSV from the reports page), or read-only API access. API access needs a developer token, OAuth credentials and read permission on the account.", "Your code folder and what the report should show", "Your conversion actions and attribution rules (optional)" ], "you_get": [ "A coding brief for a Google Ads monthly report", "The report parts in plain order, with those that do not apply marked", "Metric rules for spend, conversions, CTR, CPC, CPA and ROAS", "Test cases for dates, currency and missing data", "A list of missing inputs and setup gaps" ], "use_when": [ "You want a monthly Google Ads report built into your own tool.", "You need spend and conversion math written down before anyone codes it.", "Your current report mixes currencies, dates or accounts and you want it fixed.", "You want tests for the report before you build it." ], "skip_when": [ "You only run Meta ads: this brief reads Google Ads data, so ask your AI for a Meta report builder or use Meta Ads Manager reports.", "You want one report across a whole manager account as a single total: this brief keeps each customer separate, so run it once per customer.", "You want a finished report now and no code: export your Google Ads data to a spreadsheet and ask your AI to summarize it." ], "output_sample": { "input": [ "Your Google Ads customer ID", "The report dates and a comparison period", "Your account timezone and currency", "A Google Ads export or read-only API access", "Your code folder and the report feature you want" ], "prerequisites": [ "An AI that can read your code, or code pasted into the chat", "Read-only access to Google Ads data, or an export file" ], "output": [ { "name": "Report function spec", "contains": "How to build the monthly report function, with customer, dates, comparison period and options kept separate." }, { "name": "Data and money checks", "contains": "How to read the data, turn cost micros into currency once, and handle missing values." }, { "name": "Metric rules", "contains": "How to work out spend, conversions, CTR, CPC, CPA and ROAS, including zero and missing cases." }, { "name": "Report sections", "contains": "The report parts that apply, such as summary, metric table, campaigns, search terms and next steps." }, { "name": "JSON and Markdown output", "contains": "A structured file and a readable report with a source list and checks not run." }, { "name": "Test cases", "contains": "Tests for dates, currency, micros conversion, no conversions and missing data." }, { "name": "Gaps and next step", "contains": "Missing inputs, assumptions and the smallest useful next step." } ] }, "how_to_use": [ "Open Claude, ChatGPT or Gemini and paste the prompt from the download.", "Paste your code or schema, or share the folder if your AI can read files.", "Add your customer ID, dates, timezone, currency and an export of your data.", "Ask for the coding brief and check that the dates, currency and conversion actions match your account.", "Fix any gap it lists, then hand the brief to your developer or your coding AI.", "Run the tests it proposes in your own project. The prompt does not run code or call Google Ads.", "To get an export, open Reports in Google Ads, build a table with the columns you need, then download it as CSV. The API route needs more setup, so start with the export.", "No code yet? Paste the Google Ads export and a short description of the report, and ask for a brief that starts with the data checks." ], "checks": [], "next": [ { "name": "Code change reviewer", "url": "https://useaiblocks.com/skills/code-change-reviewer", "why": "Code change reviewer" }, { "name": "Pull request writer", "url": "https://useaiblocks.com/skills/pull-request-writer", "why": "Build it" } ], "source": null, "credits": [], "files": [ "references/worked-example.md" ], "links": { "page": "https://useaiblocks.com/prompts/google-ads-report-code-builder-prompt", "markdown": "https://useaiblocks.com/prompts/google-ads-report-code-builder-prompt.md", "json": "https://useaiblocks.com/prompts/google-ads-report-code-builder-prompt.json", "instructions": "https://useaiblocks.com/skills/google-ads-report-code-builder-prompt/SKILL.md", "download": "https://useaiblocks.com/skills/google-ads-report-code-builder-prompt.zip", "api_item": "https://useaiblocks.com/api/v1/items/google-ads-report-code-builder-prompt", "api_document": "https://useaiblocks.com/api/v1/documents/prompt/google-ads-report-code-builder-prompt", "mcp": "https://useaiblocks.com/mcp" } }