Back to .md Directory
Twitter
Instagram
ANALYTICS CENTER
Defines metrics, dashboards, post analytics, platform comparisons, growth tracking, AI insights, and report generation for a multi-platform marketing analytics module.
ai
View sourceWhat this file does
Defines metrics, dashboards, post analytics, platform comparisons, growth tracking, AI insights, and report generation for a multi-platform marketing analytics module.
When to use it
- Building a marketing analytics dashboard for social media
- Standardizing engagement and growth metrics across platforms
- Implementing automated report generation and scheduling
- Adding AI-powered content performance insights
Assumes this stack
TypeScriptYAMLREST API
ANALYTICS CENTER
Детализация модуля аналитики
Версия: 1.0
Модуль: 05-ANALYTICS
1. ОБЗОР МОДУЛЯ
Назначение
Analytics Center предоставляет insights об эффективности контента, росте аудитории и ROI маркетинговых усилий.
Компоненты
┌─────────────────────────────────────────────────┐
│ ANALYTICS CENTER │
├─────────────────────────────────────────────────┤
│ │
│ ┌────────────┐ ┌────────────┐ ┌───────────┐ │
│ │ DASHBOARD │ │ REPORTS │ │ INSIGHTS │ │
│ │ Overview │ │ Export │ │ AI-based │ │
│ └────────────┘ └────────────┘ └───────────┘ │
│ │
│ ┌────────────┐ ┌────────────┐ ┌───────────┐ │
│ │ POST │ │ PLATFORM │ │ GROWTH │ │
│ │ ANALYTICS │ │ COMPARE │ │ TRACKING │ │
│ └────────────┘ └────────────┘ └───────────┘ │
│ │
└─────────────────────────────────────────────────┘
2. МЕТРИКИ
2.1 Engagement Metrics
| Метрика | Формула | Описание |
|---|---|---|
| Engagement Rate | (interactions / impressions) × 100 | Общая вовлечённость |
| Amplification Rate | (shares / followers) × 100 | Виральность |
| Conversation Rate | (comments / impressions) × 100 | Диалоговость |
| CTR | (clicks / impressions) × 100 | Кликабельность |
2.2 Growth Metrics
| Метрика | Период | Описание |
|---|---|---|
| Follower Growth | Daily/Weekly/Monthly | Прирост подписчиков |
| Reach Growth | Weekly/Monthly | Прирост охвата |
| Velocity | Week-over-week | Скорость роста |
2.3 Content Metrics
| Метрика | Применение |
|---|---|
| Top Performers | Какой контент работает лучше |
| Optimal Length | Лучшая длина постов |
| Best Time | Лучшее время публикации |
| Best Type | Лучший тип контента |
2.4 Platform-Specific
- Impressions, Likes, Retweets, Replies
- Quote Tweets, Link Clicks
- Profile Visits, Follows
Discord
- Message Reactions, Replies
- Member Joins (after post)
- Link Clicks
Telegram
- Views, Forwards, Reactions
- Link Clicks
VK
- Views, Likes, Reposts, Comments
- Link Clicks
- Reach, Impressions
- Likes, Comments, Saves, Shares
- Profile Visits, Website Clicks
3. DASHBOARD
3.1 Layout
┌─────────────────────────────────────────────────────┐
│ ANALYTICS DASHBOARD │
│ │
│ Period: [Last 30 days ▼] Compare: [Previous ▼] │
├─────────────────────────────────────────────────────┤
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐│
│ │ 1.2M │ │ 52.3K │ │ 4.2% │ │ +15% ││
│ │ Reach │ │ Engage │ │ Eng.Rate │ │ Growth ││
│ │ ▲ 23% │ │ ▲ 18% │ │ ▲ 0.3% │ │ ▲ 2.1% ││
│ └──────────┘ └──────────┘ └──────────┘ └─────────┘│
│ │
│ ┌─────────────────────────┐ ┌─────────────────────┐│
│ │ PERFORMANCE TREND │ │ PLATFORM BREAKDOWN ││
│ │ │ │ ││
│ │ 📈 Chart │ │ Twitter ███░ 42% ││
│ │ │ │ Discord ██░░ 28% ││
│ │ [Reach] [Engagement] │ │ Telegram █░░░ 18% ││
│ │ │ │ VK █░░░ 12% ││
│ └─────────────────────────┘ └─────────────────────┘│
│ │
│ ┌─────────────────────────┐ ┌─────────────────────┐│
│ │ TOP PERFORMING │ │ BEST TIMES ││
│ │ │ │ ││
│ │ 1. Soul #4521 6.8% │ │ 🐦 14:00-16:00 ││
│ │ 2. Breeding 5.2% │ │ 💬 20:00-22:00 ││
│ │ 3. Weekly 4.9% │ │ 📱 12:00-14:00 ││
│ │ │ │ ││
│ │ [View All →] │ │ ││
│ └─────────────────────────┘ └─────────────────────┘│
│ │
└─────────────────────────────────────────────────────┘
3.2 KPI Cards
kpi_cards:
total_reach:
value: sum(impressions)
comparison: vs_previous_period
trend: up/down/stable
breakdown_by: platform
total_engagements:
value: sum(likes + comments + shares)
comparison: vs_previous_period
trend: up/down/stable
engagement_rate:
value: avg(engagement_rate)
comparison: vs_previous_period
benchmark: industry_average
audience_growth:
value: followers_end - followers_start
comparison: growth_rate_vs_previous
trend: accelerating/stable/slowing
4. POST ANALYTICS
4.1 Per-Post View
┌─────────────────────────────────────────────────────┐
│ POST ANALYTICS │
├─────────────────────────────────────────────────────┤
│ │
│ "🧬 BREEDING IS LIVE! Your Souls can now..." │
│ │
│ Published: Jan 25, 2025 14:00 • 🐦 Twitter │
│ │
│ ┌─────────────────────────────────────────────────┐│
│ │ PERFORMANCE ││
│ │ ││
│ │ Impressions Engagements Eng. Rate ││
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ││
│ │ │ 45,231 │ │ 1,902 │ │ 4.2% │ ││
│ │ │ ▲ 34% │ │ ▲ 45% │ │ ▲ 0.8% │ ││
│ │ └─────────┘ └─────────┘ └─────────┘ ││
│ │ vs. average vs. average vs. average ││
│ │ ││
│ └─────────────────────────────────────────────────┘│
│ │
│ ┌─────────────────────────────────────────────────┐│
│ │ BREAKDOWN ││
│ │ ││
│ │ Likes Retweets Replies Clicks ││
│ │ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ││
│ │ │ 1,245│ │ 312 │ │ 156 │ │ 189 │ ││
│ │ └──────┘ └──────┘ └──────┘ └──────┘ ││
│ │ ││
│ └─────────────────────────────────────────────────┘│
│ │
│ ┌─────────────────────────────────────────────────┐│
│ │ ENGAGEMENT OVER TIME ││
│ │ ││
│ │ 📈 First 24 hours chart ││
│ │ ││
│ │ Peak: 14:30 (first 30 min) ││
│ │ Long tail: Continued for 12 hours ││
│ │ ││
│ └─────────────────────────────────────────────────┘│
│ │
│ [View on Twitter] [Create Similar] [Add to Report] │
│ │
└─────────────────────────────────────────────────────┘
4.2 Content List with Metrics
┌─────────────────────────────────────────────────────┐
│ CONTENT PERFORMANCE │
├─────────────────────────────────────────────────────┤
│ │
│ Sort: [Engagement Rate ▼] Filter: [All ▼] [7d ▼] │
│ │
│ ┌─────────────────────────────────────────────────┐│
│ │ # Content Platform Reach Eng% ││
│ ├─────────────────────────────────────────────────┤│
│ │ 1 🧬 BREEDING IS... 🐦 45.2K 6.8% ││
│ │ 2 Soul #4521 awak... 🐦💬 38.1K 5.2% ││
│ │ 3 Weekly Recap: 12... 🐦💬📱 52.4K 4.9% ││
│ │ 4 Did you know? L... 🐦 28.7K 4.5% ││
│ │ 5 Community updat... 💬 12.3K 4.2% ││
│ │ 6 Behind the scen... 📷 18.9K 3.8% ││
│ │ 7 New mutation sp... 🐦 22.1K 3.5% ││
│ │ 8 Roadmap update... 🐦💬📱 41.2K 3.2% ││
│ └─────────────────────────────────────────────────┘│
│ │
│ Showing 8 of 147 posts [1][2][3]│
│ │
│ [Export CSV] [Export PDF] │
│ │
└─────────────────────────────────────────────────────┘
5. PLATFORM COMPARISON
5.1 Comparative View
┌─────────────────────────────────────────────────────┐
│ PLATFORM COMPARISON [Last 30d ▼]│
├─────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────┐│
│ │ Twitter Discord Telegram VK ││
│ ├─────────────────────────────────────────────────┤│
│ │ Reach 520K 180K 145K 95K ││
│ │ Posts 62 45 38 32 ││
│ │ Engagements 21.8K 8.2K 5.1K 3.8K ││
│ │ Eng. Rate 4.2% 4.6% 3.5% 4.0% ││
│ │ Followers +1.2K +450 +320 +180 ││
│ │ Best Time 14-16h 20-22h 12-14h 18-20h ││
│ │ Best Type Threads Updates Tips Images ││
│ └─────────────────────────────────────────────────┘│
│ │
│ ┌─────────────────────────────────────────────────┐│
│ │ REACH DISTRIBUTION ││
│ │ ││
│ │ Twitter ████████████████░░░░ 55% ││
│ │ Discord ██████░░░░░░░░░░░░░░ 19% ││
│ │ Telegram █████░░░░░░░░░░░░░░░ 15% ││
│ │ VK ███░░░░░░░░░░░░░░░░░ 11% ││
│ │ ││
│ └─────────────────────────────────────────────────┘│
│ │
│ 💡 Insight: Discord has highest engagement rate. │
│ Consider increasing content there. │
│ │
└─────────────────────────────────────────────────────┘
5.2 Cross-Post Analysis
cross_post_analysis:
same_content_comparison:
description: "Как один контент работает на разных платформах"
metrics:
- engagement_rate_by_platform
- best_adapted_version
- optimal_timing_difference
recommendations:
- platform_priority: "Where to focus"
- content_adaptation: "What to change per platform"
- posting_strategy: "When to post where"
6. GROWTH TRACKING
6.1 Audience Growth
┌─────────────────────────────────────────────────────┐
│ AUDIENCE GROWTH │
├─────────────────────────────────────────────────────┤
│ │
│ Total Followers: 24,521 (+1,847 this month) │
│ │
│ ┌─────────────────────────────────────────────────┐│
│ │ GROWTH CHART (6 months) ││
│ │ ││
│ │ 25K ─ ╭─── ││
│ │ 20K ─ ╭─────╯ ││
│ │ 15K ─ ╭─────╯ ││
│ │ 10K ─ ╭──────╯ ││
│ │ 5K ─ ──────────╯ ││
│ │ ───────────────────────────────── ││
│ │ Jul Aug Sep Oct Nov Dec ││
│ │ ││
│ └─────────────────────────────────────────────────┘│
│ │
│ ┌─────────────────────────────────────────────────┐│
│ │ BY PLATFORM ││
│ │ ││
│ │ Twitter 15,234 (+1,102) ▲ 7.8% ││
│ │ Discord 5,891 (+423) ▲ 7.7% ││
│ │ Telegram 2,456 (+198) ▲ 8.8% ││
│ │ VK 940 (+124) ▲ 15.2% ││
│ │ ││
│ └─────────────────────────────────────────────────┘│
│ │
│ Growth velocity: Accelerating (+12% vs last month) │
│ │
└─────────────────────────────────────────────────────┘
7. INSIGHTS (AI-POWERED)
7.1 Automated Insights
insight_types:
performance_anomaly:
trigger: "engagement > 2x average"
example: "Your breeding announcement got 3x normal engagement"
optimal_timing:
trigger: "weekly analysis"
example: "Posts at 14:00 get 45% more engagement than average"
content_recommendation:
trigger: "pattern detection"
example: "Threads perform 2x better than single tweets"
growth_alert:
trigger: "significant change"
example: "Follower growth accelerated 50% this week"
underperforming:
trigger: "engagement < 0.5x average"
example: "Educational content underperforming. Try adding visuals."
7.2 Insights Panel
┌─────────────────────────────────────────────────────┐
│ 💡 INSIGHTS │
├─────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────┐│
│ │ 🔥 HIGH IMPACT ││
│ │ ││
│ │ Your breeding announcement performed 3x better ││
│ │ than average. Consider similar hype-driven ││
│ │ content for major announcements. ││
│ │ ││
│ │ [View Post] [Create Similar] ││
│ └─────────────────────────────────────────────────┘│
│ │
│ ┌─────────────────────────────────────────────────┐│
│ │ ⏰ TIMING OPTIMIZATION ││
│ │ ││
│ │ Your Twitter audience is most active 14:00-16:00││
│ │ but you've been posting mostly at 10:00. ││
│ │ Shift timing for +25% potential reach. ││
│ │ ││
│ │ [Adjust Schedule] ││
│ └─────────────────────────────────────────────────┘│
│ │
│ ┌─────────────────────────────────────────────────┐│
│ │ 📊 CONTENT MIX ││
│ │ ││
│ │ Threads get 2x engagement vs single tweets. ││
│ │ Currently: 15% threads. Recommended: 30-40%. ││
│ │ ││
│ │ [Create Thread] ││
│ └─────────────────────────────────────────────────┘│
│ │
└─────────────────────────────────────────────────────┘
8. REPORTS
8.1 Report Types
| Тип | Частота | Формат | Содержание |
|---|---|---|---|
| Daily Digest | Daily | Email/TG | KPIs, top post, anomalies |
| Weekly Report | Weekly | Full analysis, trends | |
| Monthly Executive | Monthly | PDF/PPTX | Strategic overview, ROI |
| Custom | On-demand | CSV/PDF | User-selected metrics |
8.2 Report Builder
┌─────────────────────────────────────────────────────┐
│ CREATE REPORT │
├─────────────────────────────────────────────────────┤
│ │
│ Report Type: [Weekly Report ▼] │
│ │
│ Period: [Jan 19 - Jan 25, 2025] │
│ │
│ Include: │
│ ☑ Executive Summary │
│ ☑ Performance Overview │
│ ☑ Platform Breakdown │
│ ☑ Top Performing Content │
│ ☑ Audience Growth │
│ ☐ Competitor Comparison (not available) │
│ ☑ Recommendations │
│ │
│ Platforms: ☑ All ☐ Twitter ☐ Discord ☐ Other │
│ │
│ Format: (●) PDF ( ) PPTX ( ) CSV (raw data) │
│ │
│ Branding: ☑ Include workspace logo │
│ │
│ [Preview] [Generate Report] │
│ │
└─────────────────────────────────────────────────────┘
8.3 Scheduled Reports
scheduled_reports:
daily_digest:
time: "09:00 user_timezone"
delivery: [email]
content:
- yesterday_summary
- top_post
- today_scheduled
- alerts
weekly_report:
day: "Monday"
time: "10:00"
delivery: [email, slack]
content:
- full_weekly_analysis
- trends
- recommendations
monthly_executive:
day: "1st of month"
delivery: [email]
format: pdf
content:
- month_overview
- goal_progress
- strategic_insights
9. DATA COLLECTION
9.1 Metrics Sync
metrics_sync:
frequency:
real_time: [publication_status]
hourly: [basic_engagement] # first 24h
daily: [full_metrics]
platforms:
twitter:
endpoint: "tweets/:id/metrics"
metrics: [impressions, engagements, likes, retweets, replies]
discord:
method: "reaction_tracking + link_clicks"
metrics: [reactions, replies, member_joins]
telegram:
endpoint: "getMessageStatistics"
metrics: [views, forwards, reactions]
vk:
endpoint: "stats.getPostReach"
metrics: [views, likes, reposts, comments]
instagram:
endpoint: "media/:id/insights"
metrics: [reach, impressions, engagement, saves]
9.2 Data Retention
retention:
raw_metrics: 90 days
aggregated_daily: 2 years
aggregated_monthly: unlimited
exports:
available: last 12 months
format: csv, json
10. API ENDPOINTS
endpoints:
# Dashboard
GET /api/analytics/dashboard # Dashboard data
GET /api/analytics/kpis # KPI values
# Posts
GET /api/analytics/posts # Posts with metrics
GET /api/analytics/posts/:id # Single post metrics
GET /api/analytics/posts/top # Top performers
# Platforms
GET /api/analytics/platforms # Platform comparison
GET /api/analytics/platforms/:id # Single platform
# Growth
GET /api/analytics/growth # Audience growth
GET /api/analytics/growth/timeline # Growth over time
# Insights
GET /api/analytics/insights # AI insights
# Reports
GET /api/reports # List reports
POST /api/reports # Generate report
GET /api/reports/:id # Download report
GET /api/reports/scheduled # Scheduled reports
POST /api/reports/scheduled # Create scheduled
# Export
GET /api/analytics/export # Export data
11. DATA MODEL
interface PostMetrics {
publicationId: string;
platform: string;
// Core metrics
impressions: number;
reach: number;
engagements: number;
engagementRate: number;
// Breakdown
likes: number;
comments: number;
shares: number; // retweets, reposts, forwards
clicks: number;
saves?: number; // Instagram
// Calculated
amplificationRate: number;
conversationRate: number;
// Timing
collectedAt: Date;
publishedAt: Date;
}
interface DailyAggregates {
workspaceId: string;
date: Date;
platform: string;
totalReach: number;
totalEngagements: number;
avgEngagementRate: number;
postsPublished: number;
followersGained: number;
followersLost: number;
netFollowerChange: number;
}
interface Insight {
id: string;
workspaceId: string;
type: InsightType;
severity: 'info' | 'recommendation' | 'alert';
title: string;
description: string;
data: object; // Supporting data
actionable: boolean;
actionType?: string;
actionParams?: object;
createdAt: Date;
dismissedAt?: Date;
}
Следующий файл: 06-CAMPAIGNS.md
What's inside
11 sections covering metrics, dashboard layout, post analytics, platform comparison, growth tracking, insights, reports, data collection, API endpoints, and data model.
Change this for your project
- Replace
workspaceIdreferences with your own workspace identifier - Replace platform-specific endpoints like
tweets/:id/metricswith your actual API endpoints - Replace example content titles like
Soul #4521andBreedingwith your own content categories
Where it goes
Keep alongside your test suite. Used to define and score model evaluations.
Worth borrowing
- KPI cards with trend indicators and platform breakdowns
- Cross-platform comparison table with best times and content types
- AI-powered insight triggers based on performance anomalies
Related Documents
EVALS.md
AI Tools for Developers
Curates a personal reference of AI coding tools, models, and setup instructions for VS Code, Xcode, and Cursor.
aillmeval
0
27
MichaelLedgerEVALS.md
IATA BCBP Standard Compliance
Documents which IATA BCBP fields and barcode formats a Swift library implements, including Version 8 gender code support.
ai
1
19
anomaddevEVALS.md
Voice AI Leaderboards, Benchmarks, and Evaluation Gaps (Jan 2025 -- Feb 2026)
Surveys 20+ voice AI benchmarks from Jan 2025, Feb 2026, identifies evaluation gaps, and provides leaderboard data for STT, TTS, and end-to-end voice agents.
aiagentllm
0
18
petteriTeikariEVALS.md
Evaluating AI Agent Systems: Metrics, Benchmarks, and Quality Assurance (2024-2026)
Surveys 2024-2026 metrics, benchmarks, and monitoring tools for evaluating AI agent systems, with recommendations for a self-improving coding agent.
aiagentllm
0
18
oddurs