keitaro-reportslisted

# Keitaro Reports & Analytics ## Process 1. Read `keitaro/references/keitaro-api.md` for report endpoint 2. Read `keitaro/references/verticals.md` for vertical-specific benchmarks 3. Parse what user wants to see (grouping, metrics, date range, filters) 4. Build report via `POST /report/build` 5. Format and display with color-coded health indicators ## Report Builder ### Default Report (when user just says "show stats") ```json { "range": {"from": "<7 days ago>", "to": "<today>", "timezone": "UTC"}, "metrics": ["clicks", "campaign_unique_clicks", "conversions", "revenue", "cost", "profit", "roi", "cr", "epc"], "grouping": ["campaign_id"], "sort": [{"name": "cost", "order": "desc"}], "summary": true, "limit": 50 } ``` ### Common Report Types **"What's performing?"** → Top campaigns by ROI (ROI > 0, sorted desc) **"What's losing money?"** → Campaigns with negative profit, sorted by loss **"Show me campaign 12 by GEO"** → Campaign filter + country grouping **"Landing performance for campaign 12"** → Campaign filter + landing_page_id grouping **"Hourly breakdown today"** → Today range + hour grouping **"Compare this week vs last week"** → Two report calls, side by side ## Output Format ### Campaign Overview ``` Campaign Performance (Mar 20-27, 2026) ────────────────────────────────────────────────────────────────── ID | Name | Clicks | Conv | Revenue | Cost | Profit | ROI | CR 12 | gambling_de | 5,432 | 89 | $4,450 | $2,716 | $1,734