What You Can Do
- Monthly Performance Reports - Traffic, rankings, content production, recommendations
- Quarterly ROI Reports - Investment analysis, traffic value, content asset value, ROI calculations
- Competitor Analysis Reports - Market position, content gaps, authority comparison, AI visibility
- Gap Analysis Reports - Competitive intelligence with actionable recommendations (Phase 36)
- Schedule Automatic Delivery - Weekly, monthly, or quarterly reports emailed to stakeholders
- White-Label Branding - Custom logo, colors, company name, footer text
Report Types
1. Monthly Performance Report
What it includes:
- Executive summary with key metrics (clicks, impressions, CTR, content count)
- Traffic analysis with top-performing pages
- Ranking performance and average position
- Content production statistics (articles, word count, quality scores)
- Recommendations (high-value keywords, content needing refresh)
Best for: Monthly stakeholder updates, marketing team reviews.
URL: /reports/ → Choose "Monthly Performance"
2. Quarterly ROI Report
What it includes:
- ROI executive summary (investment vs. value generated)
- Traffic value analysis (equivalent PPC cost savings)
- Ranking ROI and page 1 visibility
- Content asset value estimation
- Prediction accuracy tracking (if available after 30 days)
- Next quarter projections (+15% growth modeling)
Best for: Executive leadership, board meetings, quarterly business reviews.
Calculations:
- Traffic value = Clicks × $2.50 (industry average CPC)
- ROI = ((Traffic Value - Subscription Cost) / Subscription Cost) × 100
- Content value = Total words × $0.15/word (industry standard)
URL: /reports/ → Choose "Quarterly ROI"
3. Competitor Analysis Report
What it includes:
- Market position summary
- Content gap analysis (topics competitors cover that you don't)
- Authority comparison (backlinks, domain authority)
- AI visibility comparison (mentions in ChatGPT, Claude, Perplexity)
Best for: Strategic planning, competitive positioning, content strategy sessions.
URL: /reports/ → Choose "Competitor Analysis"
4. Gap Analysis Report (Phase 36)
What it includes:
- Executive summary of competitive position
- Competitor profiles (up to 5 competitors)
- Content gaps (topics ranking for competitors but not you)
- Keyword opportunities (high-value keywords to target)
- Backlink analysis (link building opportunities)
- Actionable recommendations
Best for: Content strategy planning, identifying quick wins, competitive intelligence.
How to create:
- Go to
/reports/gap-analysis/create/ - Enter competitor domains (1-5, one per line or comma-separated)
- Optional: Add focus keywords (up to 20)
- Click "Generate Report"
- Wait 2-5 minutes for analysis
Shareable links:
- Generate a public link (expires in 30 days)
- Share with stakeholders who don't have platform access
- URL format:
/reports/gap-analysis/share/{token}/
Pre-filled data:
- Competitor domains from Tenant Settings
- Brand keywords from Tenant Settings
URL: /reports/gap-analysis/create/
Generate a Report
Manual Generation
- Go to Reports Dashboard →
/reports/ - Click "Generate New Report"
- Select report type (monthly, quarterly, competitor, gap analysis)
- Choose date range:
- Monthly: First to last day of month
- Quarterly: Q1 (Jan-Mar), Q2 (Apr-Jun), Q3 (Jul-Sep), Q4 (Oct-Dec)
- Competitor: Last 90 days
- Optional: Customize branding (logo, colors, company name, footer text)
- Optional: Enter email recipients (comma-separated)
- Click "Generate"
Generation time:
- Monthly/Quarterly: 10-30 seconds
- Competitor: 30-60 seconds
- Gap Analysis: 2-5 minutes (API-intensive)
Status: Poll report status via /reports/status/{report_id}/ or refresh dashboard.
Scheduled Reports
Automate report delivery to stakeholders.
- Go to Reports Dashboard →
/reports/ - Click "Schedule Report"
- Select template (monthly, quarterly, competitor)
- Choose frequency:
- Weekly: Every Monday at 7 AM
- Monthly: First of month at 7 AM
- Quarterly: First of quarter at 7 AM
- Enter email recipients (comma-separated)
- Enable "Auto Email" to send automatically
- Click "Create Schedule"
Manage schedules:
- View scheduled reports in dashboard
- Pause/resume by toggling "Active" status
- Edit recipients or frequency
- Delete schedule if no longer needed
URL: /reports/schedule/create/
White-Label Branding
Customize reports with your company's branding.
Customizable elements:
- Company Name - Appears on cover page
- Logo - Cover page logo (2" × 1" recommended)
- Primary Color - Headers, metrics, accents (hex format:
#1a73e8) - Secondary Color - Supporting elements
- Footer Text - Confidentiality notice (default: "Confidential - For Internal Use Only")
How to customize:
- When generating a report, expand "Branding Options"
- Upload logo (optional)
- Enter company name
- Set primary/secondary colors (hex codes)
- Add custom footer text (optional)
- Generate report
Default branding:
- Primary color:
#1a73e8 (Google Blue) - Secondary color:
#34a853 (Google Green) - Footer: "Confidential - For Internal Use Only"
White-label toggle:
- Enable "Hide ILLIXIS branding" to remove "Powered by ILLIXIS" footer
- Available on Enterprise tier only
Download & Share Reports
Download PDF
- Go to Reports Dashboard →
/reports/ - Find report in "Recent Reports"
- Click "Download"
- PDF saves to your device
File naming: Reports download with descriptive filenames including the report type, date range, and your account name.
Download count: Tracked automatically for internal analytics.
Email Reports
Send reports directly from the platform.
Manual email:
- Generate report
- Enter email recipients (comma-separated) during generation
- Report emails automatically upon completion
Scheduled email:
- Configure scheduled report with email recipients
- Emails send automatically on schedule
Email includes:
- PDF attachment
- Report title and date range
- Brief summary
- From:
noreply@illixis.io (or custom sender for white-label)
Share Gap Analysis Reports
Generate public links for stakeholders.
- Go to report detail page →
/reports/gap-analysis/{id}/ - Click "Generate Share Link"
- Copy link (format:
/reports/gap-analysis/share/{token}/) - Share with stakeholders
Link details:
- Expires in 30 days
- No login required
- Read-only access
- Shows full report data (executive summary, gaps, recommendations)
Check expiration:
- Expiration date shown on report detail page
- Regenerate link if expired
Understanding Report Sections
Traffic Analysis
What it shows:
- Total clicks and impressions
- Click-through rate (CTR)
- Average position in search results
- Top 10 performing pages
Key metrics:
- Clicks: Users who clicked your search result
- Impressions: Times your page appeared in search results
- CTR: (Clicks / Impressions) × 100
- Position: Average ranking (1 = top of page 1)
Interpretation:
- Position 1-10 = Page 1 (captures 90% of clicks)
- Position 11-20 = Page 2 (good progress, room to improve)
- Position 20+ = Beyond page 2 (focus on quality and relevance)
Data source: Google Search Console (last 16 months).
Content Production
What it shows:
- Articles published during period
- Total word count
- Average quality score (0-100)
- Average words per article
Quality score:
- Includes readability, structure, SEO, keyword usage
- Target: 80+ for high-quality content
Benchmarks:
- Industry average: 1,500-2,000 words per article
- High-quality content: 2,500+ words
ROI Calculations (Quarterly Reports)
Investment:
- Subscription cost × 3 months
- Example: Professional tier ($2,497/mo) = $7,491/quarter
Traffic Value:
- Total organic clicks × $2.50 (industry average CPC)
- Example: 10,000 clicks = $25,000 equivalent PPC cost
ROI Formula:
- ROI = ((Traffic Value - Investment) / Investment) × 100
- Example: (($25,000 - $7,491) / $7,491) × 100 = +234% ROI
Content Asset Value:
- Total word count × $0.15/word
- Example: 50,000 words = $7,500 content library value
Interpretation:
- ROI > 100% = Excellent return
- ROI > 0% = Positive (profitable)
- ROI < 0% = Building long-term assets (ROI visible after 6-12 months)
Recommendations
What it includes:
High-Value Keyword Opportunities:
- Keywords with high arbitrage scores (60+)
- Quick-win topics with low competition
Content Needing Refresh:
- Pages with traffic decay (critical/high priority)
- Ranking drop alerts
Action steps:
- Create briefs for high-value keywords
- Refresh decaying content with new data
- Track performance over time
Prediction Accuracy (Quarterly Reports)
Available after: 30 days of content publication.
What it tracks:
- Overall accuracy (all predictions)
- Traffic predictions (clicks, impressions)
- Position predictions (ranking)
- Validated prediction count
How it works:
- System forecasts traffic and rankings when brief is created
- After 30 days, actual data is compared to forecast
- Accuracy improves over time via machine learning
Benchmarks:
- 70-80% accuracy = Good
- 80-90% accuracy = Excellent
- 90%+ accuracy = Industry-leading
Automation Schedule
| Task | Schedule | What It Does |
|------|----------|--------------|
| Scheduled Report Check | Daily 7:00 AM UTC | Generates and emails reports due that day |
| Weekly Gap Analysis | Tuesday 4:00 AM UTC | Creates gap analysis for all tenants with competitor domains |
Report Generation Triggers:
- Weekly reports: Generated every Monday at 7 AM
- Monthly reports: Generated 1st of each month at 7 AM
- Quarterly reports: Generated 1st of each quarter at 7 AM
Troubleshooting
"No traffic data available"
Cause: Google Search Console not connected or no data for period.
Fix:
- Connect GSC:
/settings/integrations/gsc/ - Wait 48 hours for initial data sync
- Regenerate report
"Prediction accuracy unavailable"
Cause: Less than 30 days since content publication.
Fix: Wait 30 days after publishing first content. System needs time to validate forecasts.
"Competitor data unavailable"
Cause: Required integrations not configured.
Fix: Contact support@illixis.io if competitor data is not appearing in your reports.
Gap Analysis Report Stuck in "Generating"
Cause: Processing timeout or temporary service delay.
Fix:
- Check report status on the Gap Analysis page
- If still stuck after 10 minutes, retry generation
- Reduce competitor count (5 max) or keyword count (20 max)
Report Email Not Received
Check:
- Email address entered correctly (no spaces, valid format)
- Check spam folder
- Verify report status = "completed" (not "pending" or "failed")
"Share link expired"
Fix: Regenerate share link from report detail page. Links expire after 30 days for security.
Best Practices
Report Timing
- Monthly reports: Generate first week of following month (allows GSC data to finalize)
- Quarterly reports: Generate within 7 days of quarter end
- Gap analysis: Run weekly for fresh competitive intelligence
Email Recipients
- Monthly: Marketing team, content creators
- Quarterly: Executive leadership, board members
- Gap analysis: Strategy team, content strategists
Branding
- Use high-resolution logo (PNG with transparent background)
- Test colors before scheduling (preview in manual report first)
- Keep footer text concise (1-2 sentences max)
Scheduled Reports
- Schedule during off-hours (early morning) to avoid interfering with platform usage
- Review first report manually before trusting automated delivery
- Update email recipients quarterly (remove departing stakeholders)
Gap Analysis
- Focus on 3-5 direct competitors (not 5 tangential ones)
- Use brand keywords from Tenant Settings for consistent analysis
- Run weekly to track competitive movement over time
- Share reports with content team for brief creation input
Related Features
- Content Intelligence → Feeds recommendations into reports
- GSC Integration → Traffic data source
- Tenant Settings → White-label branding, competitor domains
- Subscription Management → Determines report access (Professional+ for scheduled reports)
- Decision Logging → Prediction accuracy tracking
URLs
| Feature | URL |
|---------|-----|
| Reports Dashboard | /reports/ |
| Generate Report | /reports/generate/ |
| Download Report | /reports/download/{report_id}/ |
| Report Status | /reports/status/{report_id}/ |
| Schedule Report | /reports/schedule/create/ |
| Gap Analysis List | /reports/gap-analysis/ |
| Create Gap Analysis | /reports/gap-analysis/create/ |
| Gap Analysis Detail | /reports/gap-analysis/{report_id}/ |
| Gap Analysis Download | /reports/gap-analysis/download/{report_id}/ |
| Gap Analysis Status | /reports/gap-analysis/status/{report_id}/ |
| Share Gap Analysis | /reports/gap-analysis/share/{token}/ |
Need help? Contact support@illixis.io or use the in-app help widget.