Documentation
Connect your marketing data to Claude, ChatGPT and other LLMs.
AI Analysis ✨ — how it works
Each Insights page (Ads, GSC, Meta) shows a black "Personalized AI analysis" button at the top right. Clicking it opens a 2-step modal that calls Claude (via OpenRouter) with the page's full context.
Step 1 — Consent (per account)
GDPR requires it: each account/property has its own consent. The first time you click the button for a given account, you see a modal that details:
- What will be sent (KPIs, top items, breakdowns — no personal info)
- The model used (default
anthropic/claude-haiku-4-5, configurable in admin) - The provider (OpenRouter — privacy policy, no training, no storage)
- The rate limit (30 / day / user)
Once accepted, consent is stored in DB (ai_consent_given_at on the account/property) + a row in ai_consent_logs (GDPR audit trail).
Step 2 — Chat thread
Once consented, you enter a mini-conversation:
- Ask your question (min 5, max 2000 chars)
- The LLM sees the page's full context (KPIs current+prior, top items, events) + your last 6 turns for continuity
- Response in English/French (model auto-adapts), structured Markdown, < 500 words
Actions on the response
| Button | Effect |
|---|---|
| Copy last reply | Markdown source to clipboard |
| .md | Download the full thread (all Q+A) as .md file |
| Send the analysis to your user email (rate limit 10/day) |
Data sent to the LLM
| Page | Context sent (summary) |
|---|---|
| Ads Insights | Current+prior KPIs, top campaigns, top countries, device breakdown, top keywords, top search terms, last 30 events (notes/writes/external) |
| GSC Insights | Current+prior KPIs, top 25 queries, top 20 pages, top 8 countries, top 5 devices |
| Meta Insights | Current+prior KPIs, top campaigns, ad sets, age/gender/placement breakdown |
Product-specific system prompt
Each product has its calibrated system prompt:
- Ads: "senior Google Ads consultant", focus on ROAS/CPA, actionable recommendations
- GSC: "senior SEO consultant", focus on position 8-15 quick wins, CTR optim, cannibalization
- Meta: "senior media buyer", focus on creative fatigue, audience scaling, placement optim
📨 Email reports + 🗂 History (the agency-friendly bits)
Every analysis you generate (chat thread, Full SEO Audit, Landing Page audit) can be shipped to a client by email in 1 click and is automatically archived for later retrieval. Designed so you stop juggling Notion / Slack / inbox to share results.
Send by email
| From where | What gets sent | Quota |
|---|---|---|
| AI Insights chat (Ads / GSC / Meta) | Full Q&A thread as Markdown body, your name as Reply-To | 10 / day / user |
| Full SEO Audit modal | Subject + intro message + optional .md / .docx / .pdf attachments (branded) | 20 / day / user |
| Landing Page Analyzer | Generated technical brief tailored to recipient (designer / dev / client) | 10 / day / user |
/admin/general) so it looks like your tool, not gadspilot's.History tabs
| Tool | Retention | What you can do with past runs |
|---|---|---|
| Full SEO Audit | 10 most recent per property (auto-pruned beyond) | Click any past run → reload full report in Current tab → re-export / re-email with current branding |
| Landing Page Analyzer | Unlimited (kept indefinitely) | Compare scores after a redesign or A/B test, re-send the brief with updated screenshot suggestions |
| AI Insights chat threads | Per-session (page reload clears the modal but the email/download is the persistent archive) | Use the Email or .md export at the end of every productive thread to keep a paper trail |
Revoke consent
To revoke an account's AI consent, write to contact@gadspilot.com or delete + recreate the account. (Dedicated UI planned for a future version.)
Strict rate limits
| Analyses (ask) | 30 / day / user |
| Email reports | 10 / day / user |
Cost for you
Zero — gadspilot covers OpenRouter API costs in v1.
