Documentation
Connect your marketing data to Claude, ChatGPT and other LLMs.
Google Ads Insights
Built-in gadspilot page to visualize a Google Ads account's performance without an LLM. URL: /accounts/{id}/insights or click "Insights" on the account card in /dashboard.
Top filters
- Campaign: selector with 4 sort modes (Spend ↓, ROAS ↓, ROAS ↑, Name) + name search + health indicators (green/yellow/red)
- Ad group: secondary filter (activates when a campaign is selected)
- Date range: Last 7 / 30 / 90 days · Custom (with date pickers)
5 KPI cards
| KPI | Formula | Delta direction |
|---|---|---|
| Spend | Σ cost_micros / 1M | vs prior period, decrease = green |
| Revenue | Σ conversions_value | vs prior period, increase = green |
| Conversions | Σ conversions | increase = green |
| Cost / conversion | Spend / Conversions | decrease = green (CPA ↓) |
| ROAS | Revenue / Spend (in x) | increase = green |
Charts (3 tabs)
- ROAS × Events: Spend bars + ROAS line, colored event dots (notes, MCP writes, external changes)
- CPA × Budget: Conversions bars + CPA line + Daily budget line (dashed), events overlay
- CTR × CVR funnel: Clicks bars + CTR % line + CVR % line (% axis)
Events are populated from:
- Notes you write via the MCP
add_notetool (rationale, hypotheses, re-check dates) - Writes executed in non-dry-run mode via MCP tools (pause campaign, update budget, etc.)
- External changes detected via
get_change_history(changes made in the Google Ads UI by other users)
Event timeline
Below the chart, a complete list of events on the period with icon + date + scope + body. Click to expand long content.
"Personalized AI analysis ✨" button
Top right. See AI Analysis.
ℹ
Performance: first load takes 2-5s (multiple Google Ads API calls: daily perf + campaigns + countries + devices + change history). Cached 1h. "Refresh" button to bypass.