Documentation
Comprehensive guide to using the Skopeak AI Brand Visibility Analysis System
Contents
Getting Started
The Skopeak AI Brand Visibility Analysis System helps you measure and track your brand's visibility in search results. This guide will help you get started with the system.
System Requirements
The web application works best with modern browsers such as Chrome, Firefox, Safari, or Edge. No additional software is required to use the system.
Key Concepts
- Brand Visibility: A measure of how frequently and prominently your brand appears in search results.
- Visibility Score: A composite metric (0-100) that combines brand mentions, positions, and query coverage.
- Analysis: The process of generating queries, executing searches, and calculating visibility metrics.
- Report: The output of an analysis, containing visibility metrics and recommendations.
Running an Analysis
Follow these steps to run a brand visibility analysis:
- Navigate to the Analysis Page: Click on "New Analysis" in the navigation menu.
-
Fill in the Form:
- Brand Name (required): Enter the name of the brand you want to analyze.
- Industry (required): Specify the industry context for your brand.
- Search Intent (optional): Provide specific search intent to focus the analysis.
- Competitors (optional): Enter a comma-separated list of competitors to track.
- Maximum Queries: Select the maximum number of search queries to generate.
- Show Detailed Output: Toggle to include full search references in the results.
- Start the Analysis: Click the "Start Analysis" button to begin the process.
- Monitor Progress: The system will display a progress page while the analysis runs.
- View Results: Once complete, the system will display a comprehensive visibility report.
Understanding Metrics
The system calculates several key metrics to measure brand visibility:
Visibility Score (0-100)
A composite metric calculated using the formula:
Visibility Score = (0.35 × Brand Mention Ratio × 100) + (0.45 × Position Score) + (0.20 × Query Coverage × 100)
Higher scores indicate better brand visibility in search results.
Brand Mention Ratio
The percentage of search results that mention your brand:
Brand Mention Ratio = Total Brand Mentions / Total Results
Higher ratios indicate stronger brand presence across all search results.
Position Score
Measures the average position where the brand appears in search results. Lower positions (higher in search results) receive better scores.
Position Score = (1 - (average_position / 20)) × 100, minimum of 50
This ensures that positions higher in search results (positions 1-3) receive significantly higher scores than those appearing lower.
Query Coverage
The percentage of queries where your brand appears at least once:
Query Coverage = Queries with Brand Mentions / Total Queries
Higher coverage indicates broader brand visibility across different search queries.
Comparing Reports
The system allows you to compare two visibility reports side by side:
- Navigate to Compare: Click on "Compare" in the navigation menu.
- Select Reports: Choose two reports to compare from the dropdown menus.
- View Comparison: The system will display a side-by-side comparison of the selected reports.
You can use report comparisons to:
- Track visibility changes for the same brand over time
- Compare visibility between your brand and competitors
- Evaluate the impact of optimization efforts
API Reference
The system provides a simple API for programmatic access to visibility analysis:
GET /api/task/{task_id}/status
Check the status of a running analysis task.
Parameters
| Parameter | Type | Description |
|---|---|---|
task_id |
string | The ID of the task to check |
Response
{
"status": "running",
"brand": "Example Brand",
"industry": "Technology",
"started_at": "2025-04-01 14:30:45"
}
The status field can be running, completed, or error.
Authentication
Currently, the API does not require authentication for demo purposes. In a production environment, proper authentication would be implemented.
Troubleshooting
Common Issues
Analysis Takes Longer Than Expected
If an analysis takes longer than 5 minutes, it may be due to:
- A large number of queries selected
- Temporary server load or network issues
Solution: Refresh the status page. If the issue persists, try reducing the number of queries.
Error During Analysis
If an error occurs during analysis, it may be due to:
- Invalid input data
- Temporary server issues
Solution: Check your input parameters and try again. If the issue persists, contact support.
Reports Not Displaying Correctly
If reports don't display correctly, it may be due to:
- Browser compatibility issues
- Corrupted report data
Solution: Try using a different browser or clearing your browser cache.
Contact Support
If you continue to experience issues, please contact our support team: