Google Ads Builder Docs
AI-powered ad copy generation for Google Ads. Enter a landing page URL, choose your AI model, and get production-ready RSA headlines, descriptions, sitelinks, callouts, and structured snippets.
Quick Start
Three steps to your first batch of ad copy:
Choose Your AI Provider
Pick from Claude (Anthropic), GPT (OpenAI), or Gemini (Google). Each has strengths โ Claude tends toward precise character counts, GPT excels at creative variety, Gemini is fast and free-tier friendly.
Sign In + Enter Landing Page URL
Click Sign in with Google to use Buddy credits (25 free credits to start, works across all tools). Or expand "Advanced: Use your own API key" to bring your own. Paste any landing page URL โ the AI will analyze it to understand your offer.
Generate & Export
Hit "Generate" and the AI reads your page, extracts value propositions, and creates a full set of ad assets. Copy individual items, copy all, or export as CSV for direct import into Google Ads Editor.
AI Configuration
Recommended: Click "Sign in with Google" to use Buddy credits โ one sign-in works across all tools. 25 free credits to start. Or bring your own API key from any provider:
Claude (Anthropic)
choose oneGet your key at console.anthropic.com/settings/keys. Starts with sk-ant-api03-. New accounts get $5 in free credits. Recommended model: Claude Opus 4.6 for best quality.
GPT (OpenAI)
choose oneGet your key at platform.openai.com/api-keys. Starts with sk-proj-. Requires a paid account. Recommended model: GPT-5.2 for best quality.
Gemini (Google)
choose oneGet your key at aistudio.google.com/apikey. Starts with AIzaSy. Generous free tier โ great for testing. Recommended model: Gemini 2.0 Flash.
Generating Ad Copy
The builder sends your landing page URL to the AI with a carefully crafted prompt that instructs it to:
First, analyze your landing page to extract value propositions, CTAs, trust signals (reviews, ratings, awards), competitive positioning, and target audience signals. Then, generate ad copy that maps these insights to Google Ads asset types while strictly respecting character limits.
Optional Context
The "Additional Context" field lets you provide information the AI can't get from the landing page alone. Good things to include:
Asset Types
| Asset | Count | Char Limit | Notes |
|---|---|---|---|
| RSA Headlines | 15 | 30 chars | Includes keyword insertion tokens and pin suggestions |
| RSA Descriptions | 4 | 90 chars | Each designed to work with any headline combination |
| Sitelink Titles | 6 | 25 chars | Deep links to key pages |
| Sitelink Descriptions | 6 ร 2 | 35 chars | Two description lines per sitelink |
| Callout Extensions | 4 | 25 chars | Trust signals, benefits, differentiators |
| Structured Snippets | 4 | varies | Category header + values |
Campaign Types
The builder adapts its output based on your campaign type:
| Type | Focus | Example Headlines |
|---|---|---|
| Search (RSA) | Balanced mix of benefit, feature, CTA, and urgency headlines | "Free Shipping on All Orders" ยท "Shop Now โ Save 40%" |
| Brand | Includes brand name variants, official site messaging, brand authority | "Official Acme Store" ยท "Acme โ Trusted Since 2010" |
| Competitor | Positioning against alternatives, comparison-friendly language | "A Better Alternative to [X]" ยท "Switch & Save 60%" |
| Generic / Non-Brand | Category-level terms, problem-solution framing | "Best CRM Software 2026" ยท "{KeyWord:CRM Solutions}" |
Pro Tips
Character Limits
Google Ads enforces strict character limits. The builder validates every asset and flags any that exceed limits:
| Element | Max Characters | Max Count per Ad |
|---|---|---|
| RSA Headline | 30 | 15 (3 shown) |
| RSA Description | 90 | 4 (2 shown) |
| Sitelink Title | 25 | 20 (2-6 shown) |
| Sitelink Description (per line) | 35 | 2 per sitelink |
| Callout Text | 25 | 20 (2-6 shown) |
| Structured Snippet Value | 25 | 10 values per header |
| Display URL Path | 15 each | 2 paths |
Supported Models
| Provider | Model | Speed | Quality | Cost |
|---|---|---|---|---|
| Anthropic | Claude Sonnet 4.6 | Medium | Excellent | ~$0.003/run |
| Anthropic | Claude Opus 4.6 | Slower | Exceptional | ~$0.015/run |
| OpenAI | GPT-5.4 | Medium | Excellent | ~$0.005/run |
| OpenAI | GPT-5.3 Codex | Fast | Excellent (Code) | ~$0.003/run |
| Gemini 3 Flash | Very Fast | Good | Free tier | |
| Gemini 3 Pro | Medium | Very Good | Free tier |
Estimated costs are per generation (~2,000 input tokens + ~1,500 output tokens). Actual costs depend on landing page length and model pricing at time of use.
Security Model
The Google Ads Builder uses a defense-in-depth approach to protect your API keys:
Web Crypto API Encryption (AES-256-GCM)
When you enter an API key, the browser generates a random 256-bit encryption key using crypto.subtle.generateKey(). Your API key is encrypted with this key using AES-GCM mode with a random 12-byte IV. The encrypted ciphertext is stored in sessionStorage โ the plaintext API key is never stored anywhere.
Session-Only Storage
Both the encryption key and the encrypted API key are stored in sessionStorage, not localStorage. sessionStorage is scoped to the browser tab and is automatically cleared when the tab is closed. It doesn't persist across sessions, isn't shared between tabs, and can't be accessed by other sites.
Direct API Calls (No Proxy)
API calls go directly from your browser to the AI provider's endpoint. The request never passes through any intermediary server. The builder is a static HTML file โ there is no backend to intercept traffic.
Manual Clear
The "Clear Session" button in the app immediately calls sessionStorage.clear(), destroying both the encryption key and the encrypted API key. This is irreversible.
Export Options
Copy Individual
Click the "copy" button on any asset card to copy just that headline, description, or extension to your clipboard.
Copy All
Click "Copy All" to get every generated asset as a newline-separated list. Paste directly into a spreadsheet or document.
Export CSV
Click "Export CSV" to download a structured CSV file with columns:
Import directly into Google Ads Editor or use as a review sheet for your team.
Part of the Agent
The Google Ads Builder is one tool in the Google Ads Agent ecosystem โ an open-source AI agent with 28 custom Python actions and 6 specialized sub-agents that manages Google Ads accounts through the API.
While the full agent handles campaign management, optimization, and reporting through the Google Ads API, the Builder is a standalone client-side tool focused specifically on ad copy generation. It doesn't require Google Ads API credentials โ just an AI model API key.
View the full agent on GitHub โ
About
Built by John Williams, Senior Paid Media Specialist at Seer Interactive with 15+ years managing $48M+ in digital advertising spend. Former NortonLifeLock (192% YoY paid search growth), Gen Digital, and Farmers Insurance.
Speaker at Hero Conf 2025 on AI applications in advertising. Built through It All Started With A Idea.
GitHub ยท LinkedIn Launch Post ยท Free Keywords Article ยท Feedonomics Feature ยท X / Twitter ยท Instagram