Documentation

Comprehensive guide to using the Skopeak AI Brand Visibility Analysis System

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:

  1. Navigate to the Analysis Page: Click on "New Analysis" in the navigation menu.
  2. 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.
  3. Start the Analysis: Click the "Start Analysis" button to begin the process.
  4. Monitor Progress: The system will display a progress page while the analysis runs.
  5. View Results: Once complete, the system will display a comprehensive visibility report.
Note: Analysis typically takes 2-5 minutes depending on the number of queries.

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:

  1. Navigate to Compare: Click on "Compare" in the navigation menu.
  2. Select Reports: Choose two reports to compare from the dropdown menus.
  3. 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.

Note: Future API endpoints for starting analyses and retrieving results are under development.

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:

Support@Skopeak.com