Analytics & Báo cáo
Thống kê bài viết, traffic, conversions, SEO và AI usage.
Analytics & Báo cáo
Analytics tổng hợp metrics từ drafts, jobs, SEO, GSC và AI usage. UI dùng Recharts + date-fns, hỗ trợ 6 trang con.
Tổng quan
/dashboard/analytics — 30 ngày mặc định
Content & Automation
/analytics/content + /automation — chi tiết posts/jobs
Traffic & Conversions
/analytics/traffic + /conversions — behavior
Bạn tìm thấy gì ở đâu
| Trang | Đường dẫn | Mô tả |
|---|---|---|
| Tổng quan | /dashboard/analytics | Overview, postsOverTime, seoDistribution, topPosts |
| Content | /dashboard/analytics/content | Summary, trend, distribution, list, refreshOpportunities |
| Automation | /dashboard/analytics/automation | Summary, trend, statusDistribution, jobPerformance, bottlenecks, recentRuns |
| AI Usage | /dashboard/analytics/ai-usage | Summary, trend, byFeature, byModel, transactions |
| Traffic | /dashboard/analytics/traffic | Traffic view (client-only) |
| Conversions | /dashboard/analytics/conversions | Conversations view (client-only) |
6 trang con này khớp 100% với sidebar Analytics nhóm. Trang gốc /dashboard/analytics prefetch overview, overviewInRange, postsOverTime, seoDistribution, topPosts(limit10) với range mặc định 30 ngày.
Metrics chính
| Metric | Nguồn | Ý nghĩa |
|---|---|---|
overview / overviewInRange | analytics router | Total posts, published rate, avg SEO |
posts / postsOverTime | analytics | Posts per day/week |
topPosts | analytics | Top theo views/SEO score |
seoDistribution | analytics | Buckets 0-50/50-70/70-85/85-100 |
refreshOpportunities | analytics/content | Posts cũ, SEO thấp cần refresh |
automation summary | analytics/automation | Success rate, avg gen time, bottlenecks |
ai-usage | analytics/ai-usage | Tokens, cost USD, breakdown Claude vs GPT-4o |
Sub-routers chi tiết
| Trang | Prefetch gì |
|---|---|
/analytics/content | content.summary/trend/distribution/list/refreshOpportunities |
/analytics/automation | automation.summary/trend/statusDistribution/jobPerformance/bottlenecks/recentRuns (granularity day) |
/analytics/ai-usage | aiUsage.summary/trend/byFeature/byModel/transactions |
/analytics/traffic | Client-only — không prefetch server |
/analytics/conversions | Client-only |
Time Ranges & Refresh
| Time range | Param | Dùng khi nào |
|---|---|---|
| 7 days | 7d | Overview nhanh |
| 30 days | 30d | Mặc định, trend analysis |
| 90 days | 90d | Quarterly report |
| Tiêu chí refresh | Ngưỡng |
|---|---|
| Age | > 90 ngày từ published_at |
| SEO score | < 70 |
| Traffic | Giảm > 20% (nếu có GSC) |
Trạng thái UI
Loading: Skeleton shimmer, không block dashboard.
Empty: CTA "Tạo job đầu tiên" khi chưa có posts.
Error: Inline message + Retry, có error boundary riêng cho
ai-usage/automation/content.Populated: Charts với tooltip chính xác, label rõ ràng, accessible cho color-blind.
Không tự bịa dateRange: '7d'|'30d'|'90d' cho mọi query — overviewInRange nhận {from, to} ISO, ai-usage nhận startDate/endDate hoặc range object tùy router. Hãy theo pagination và limit của từng page.