Documentation

🚀Getting Started

⚡Features

💎Plans & Features

🔌Integrations

🔧Advanced

WebVisor Documentation

Welcome to WebVisor! This documentation will help you understand and implement our powerful analytics and tracking solutions for your website.

What is WebVisor?

WebVisor is a comprehensive analytics platform that helps you understand your website's performance, user behavior, and traffic patterns. With features like real-time analytics, event tracking, and detailed reporting, you can make data-driven decisions to improve your website's performance.

Quick Start Guide

1. Sign Up

Create your WebVisor account and select a plan that fits your needs.

2. Generate Tracking Code

Get your unique tracking code from the dashboard.

3. Install Tracking

Add the tracking code to your website following our installation guides.

4. Start Tracking

Begin collecting data and viewing insights in your dashboard.

Installation Guide

Platform Installation Guides

Analytics Dashboard

The analytics dashboard provides real-time insights into your website's performance:

  • Total Events: Track all user interactions
  • Unique Visitors: Monitor distinct user sessions
  • Average Time on Page: Understand user engagement
  • Bounce Rate: Measure single-page visit percentage

Access your analytics dashboard to view detailed metrics and visualizations of user behavior.

Event Tracking

WebVisor automatically tracks various user interactions:

  • Pageviews: Track when users load your pages
  • Clicks: Monitor element interactions
  • Form Submissions: Track form completions
  • Scroll Depth: Measure content engagement
  • Mouse Movements: Analyze user behavior patterns

Events are collected in real-time and can be viewed in the Events tab of your dashboard.

Performance Monitoring

Monitor your website's performance with key metrics:

  • First Contentful Paint (FCP): Time until first content appears
  • Largest Contentful Paint (LCP): Loading performance
  • Cumulative Layout Shift (CLS): Visual stability score
  • Time to First Byte (TTFB): Server response time

These metrics help you identify and resolve performance issues affecting user experience.

Reports

Generate comprehensive reports for deeper analysis:

  • Traffic source analysis
  • User behavior patterns
  • Performance metrics over time
  • Custom date range analytics

Reports can be generated and exported for sharing with stakeholders.

UTM Campaign Tracking

WebVisor automatically captures and analyzes UTM parameters from your URLs, helping you track and measure the effectiveness of your marketing campaigns across different channels.

UTM Parameters Explained

UTM parameters are tags you add to your URLs to track where your traffic comes from. WebVisor automatically captures these parameters:

utm_source

Identifies which site sent the traffic

Example: facebook, google, newsletter

utm_medium

Identifies the marketing medium

Example: cpc, social, email

utm_campaign

Identifies a specific product promotion or strategic campaign

Example: spring_sale, black_friday, product_launch

utm_term

Identifies paid search keywords

Example: marketing+analytics, web+tracking

utm_content

Differentiates similar content or links within the same ad

Example: blue_button, header_link, text_ad

URL Builder

Create properly formatted URLs for your campaigns:

Base URL Example:

https://yourdomain.com/page

With UTM Parameters:

https://yourdomain.com/page?utm_source=facebook&utm_medium=social&utm_campaign=spring_sale&utm_content=video_ad

Campaign Tracking Features

Real-time Campaign Monitoring

  • Track campaign performance as it happens
  • Monitor visitor behavior from different sources
  • Compare campaign effectiveness
  • Identify top-performing channels

Campaign Analytics

  • Visitor count by campaign
  • Conversion tracking
  • Time on site by source
  • Campaign comparison tools

Best Practices

Naming Conventions

  • Use lowercase letters consistently
  • Use underscores instead of spaces
  • Be specific but concise
  • Maintain consistent naming across campaigns

Campaign Organization

  • Group related campaigns together
  • Use consistent source/medium combinations
  • Document your UTM strategy
  • Regular audit of active campaigns

💡 Pro Tips:

  • Create a spreadsheet to track all your UTM parameters
  • Test your UTM links before launching campaigns
  • Use consistent capitalization in your parameters
  • Avoid using special characters in parameter values
  • Keep URLs as short as possible while maintaining clarity

⚠️ Common Mistakes to Avoid:

  • Using spaces in parameter values (use underscores instead)
  • Inconsistent naming conventions across campaigns
  • Using special characters that need URL encoding
  • Not documenting your UTM parameter strategy
  • Using UTM parameters on internal links

Viewing Campaign Data

Dashboard Analytics

  • View campaign performance metrics
  • Compare different campaigns
  • Track conversion rates by source
  • Monitor campaign ROI

Campaign Reports

  • Generate campaign performance reports
  • Export campaign data
  • Share results with stakeholders
  • Track historical campaign data

Plans and Features

WebVisor offers different plans to suit your needs:

Free Plan

  • 1 Website
  • Pageviews tracking
  • 2 PDF reports/month
  • 30 days data retention
  • Google Search Console integration

Pro Plan

  • 5 Websites
  • Pageviews + Clicks tracking
  • 4 PDF reports/site/month
  • 90 days data retention
  • Google Search Console integration

Agency Plan

  • 15 Websites
  • All events tracking
  • Unlimited PDF reports
  • 180 days data retention
  • Google Search Console integration
  • Email automation (Coming soon)
  • API access (Coming soon)

Google Search Console Integration

Connect your Google Search Console account to get additional insights about your website's search performance:

⚠️ Important Disclaimer:

The accuracy and availability of data from Google services (Search Console, Analytics, etc.) is dependent on Google's systems and APIs. WebVisor has no control over the data that Google provides, its accuracy, or any potential delays in data updates. The data shown in WebVisor is a direct reflection of what Google supplies through their official APIs.

Connecting Your Account

  1. Navigate to Settings → Integrations in your WebVisor dashboard
  2. Click "Connect Google Search Console"
  3. Sign in with your Google account and grant necessary permissions
  4. Select the properties you want to track
  5. Verify ownership of your websites if not already done

Available Metrics

  • Search Performance: Track click-through rates, impressions, and average position for your pages in search results
  • Top Queries: Discover the most common search terms leading to your site, including their performance metrics
  • Top Pages: Identify your best performing pages in search results and monitor their ranking changes
  • Search Appearance: Understand how your site appears in search results, including rich results and featured snippets
  • Geographic Data: See which countries your search traffic comes from
  • Device Breakdown: Analyze performance across desktop, mobile, and tablet devices

Data Updates & Freshness

  • Data Delay: Search Console data typically has a 2-3 day delay from Google
  • Update Frequency: WebVisor syncs with Search Console multiple times per day
  • Historical Data: Access up to 16 months of historical search performance data
  • Data Aggregation: Data is aggregated by Google and may not match exact real-time numbers

Keyword Performance Tracking

  • Ranking Tracking: Monitor positions for specific keywords over time
  • New Keywords: Discover new search terms your site ranks for
  • Performance Analysis: Track clicks, impressions, and CTR by keyword
  • Page-Level Data: See which pages rank for specific keywords

💡 Pro Tips:

  • Regularly check your Search Console connection status in Settings
  • Group keywords by topic or intent for better organization
  • Compare performance across different time periods
  • Use filters to focus on high-priority keywords or pages
  • Monitor mobile vs desktop performance separately

Troubleshooting

No Data Showing

  • Verify your Google Search Console connection is active
  • Check if you have the correct property selected
  • Ensure your site verification is still valid
  • Remember there is a 2-3 day data delay from Google

Data Discrepancies

  • Compare date ranges in both WebVisor and Search Console
  • Check if filters are applied that might affect the data
  • Note that data aggregation might cause slight differences
  • Consider the normal 2-3 day data delay

⚠️ Important Notes:

  • Keep your Google account credentials secure
  • Regularly review connected applications in your Google Account settings
  • Update permissions when changing team members or access requirements
  • Be aware of Google API quotas and usage limits

PDF Reports

Generate comprehensive PDF reports to analyze and share your website's performance data. Reports are automatically formatted for professional presentation and easy readability.

Report Types

Performance Report

  • Overall website performance metrics
  • Core Web Vitals measurements
  • Page load time analysis
  • Performance trends over time
  • Device-specific performance data

Traffic Analysis Report

  • Visitor count and trends
  • Traffic source breakdown
  • Geographic distribution
  • Device and browser statistics
  • Peak traffic periods

Event Report

  • User interaction patterns
  • Click tracking analysis
  • Form submission data
  • Custom event tracking
  • Event conversion rates

Search Performance Report

  • Google Search Console metrics
  • Keyword rankings and trends
  • Click-through rate analysis
  • Top performing pages
  • Search appearance data

Report Customization

Date Range Options

  • Last 7 days
  • Last 30 days
  • Last month
  • Last quarter
  • Custom date range selection
  • Compare with previous period

Data Filtering

  • Filter by traffic source
  • Filter by device type
  • Filter by geographic location
  • Filter by event type
  • Custom metric filtering

Generating Reports

Step-by-Step Process

  1. Navigate to the Reports section in your dashboard
  2. Select the type of report you want to generate
  3. Choose your date range and comparison period (if desired)
  4. Apply any filters or customizations
  5. Preview the report content
  6. Click "Generate PDF" to create your report

Automated Reports (Beta Soon)

  • Schedule regular report generation
  • Set up email delivery
  • Choose frequency (daily, weekly, monthly)
  • Customize recipient list

📊 Report Generation Limits:

  • Free Plan: 2 reports per month
  • Pro Plan: 4 reports per site per month (maximum 20)
  • Agency Plan: Unlimited reports

Report Management

Accessing Reports (Offline in this version)

  • Download reports as PDF files
  • Access report history
  • Share reports via direct link
  • Organize reports by type and date

Report Storage (Offline in this version)

  • Reports stored for 30 days
  • Download and save locally for permanent storage
  • Automatic cleanup of old reports

⚠️ Important Notes:

  • Reports are generated based on data within your plan's retention period
  • Large date ranges may take longer to generate
  • Report generation counts towards your monthly limit when the PDF is created
  • Failed generation attempts do not count towards your limit

💡 Pro Tips:

  • Use comparison periods to track progress over time
  • Save commonly used filter combinations for quick access
  • Schedule automated reports for regular stakeholder updates
  • Download important reports before the 30-day storage period expires

Data Management

Understanding how WebVisor handles your analytics data:

Data Retention

  • Free Plan: 30 days of data retention
  • Pro Plan: 90 days of data retention
  • Agency Plan: 180 days of data retention

Data older than your plan's retention period is automatically deleted to maintain system performance and privacy.

Privacy and Security

  • All data is stored securely in compliance with GDPR
  • Personal information is anonymized by default
  • IP addresses are truncated for privacy
  • Data is encrypted at rest and in transit

Managing Your Data

  • View real-time data in your dashboard
  • Export data via PDF reports
  • Filter and segment data by date ranges
  • Track specific events and metrics

API Documentation

🚧 Coming Soon

API access will be available exclusively for Agency plan users. Documentation will include:

  • Authentication methods
  • Available endpoints
  • Request/response examples
  • Rate limits and usage guidelines