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
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.