Contents

Version 2.6.1

FastStats User Manual

Privacy-Focused Web Analytics for Europe

Introduction

FastStats is a privacy-focused web analytics platform designed as a European alternative to Google Analytics. It provides comprehensive website analytics while ensuring full GDPR compliance and data sovereignty.

Key Features

Why FastStats?

Feature FastStats Google Analytics
Cookie consent required No Yes
GDPR compliant by default Yes Requires configuration
Data location EU only Global
Script size <1KB ~45KB
Real-time analytics Yes Limited
Open source Yes No

Getting Started

Creating Your Account

  1. Visit faststats.io and click Sign Up
  2. Enter your email address and create a password
  3. Verify your email address
  4. You'll be redirected to your dashboard

Adding Your First Site

  1. Click Add Site in the dashboard
  2. Enter your website URL (e.g., example.com)
  3. Copy the tracking code provided
  4. Paste it in your website's <head> section
  5. Wait a few minutes for data to start appearing

Tracking Code

Add this script to your website's <head> section:

<script defer data-site="YOUR_SITE_ID" src="https://eu1.faststats.io/t.js"></script>

Parameters:

Dashboard Overview

The FastStats dashboard provides a comprehensive view of your website's analytics at a glance.

Top Metrics

Time Period Selector

Quick filters:

Real-time Indicator

Live visitor count shown in the top right corner. Click for detailed real-time view.

Analytics Panels

Each panel provides specific insights into your traffic.

Pages

Most visited pages on your website:

Referrers

Traffic sources:

Countries

Geographic distribution of your visitors by country, region, and city.

Drill-down: Click a country to see regions, click a region to see cities.

Browsers

Browser usage statistics:

Operating Systems

Devices

Device type breakdown:

UTM Campaigns

Track marketing campaigns using UTM parameters:

Parameter Purpose Example
utm_source Traffic source google, facebook, newsletter
utm_medium Marketing medium cpc, email, social
utm_campaign Campaign name spring_sale, product_launch
utm_content Ad variation banner_a, text_link
utm_term Paid keywords running+shoes

Example URL:

https://yoursite.com/?utm_source=facebook&utm_medium=social&utm_campaign=spring_sale

Filtering & Segmentation

Click any item in the dashboard panels to filter all data by that dimension.

Available Filters

Combining Filters

Filters are cumulative. For example:

  1. Click "Germany" in Countries
  2. Click "Mobile" in Devices
  3. Result: See data for German mobile visitors only

Clear Filters

Click the Clear Filters button or press Esc to remove all filters.

Time Periods

View your data across different time ranges.

Predefined Periods

Custom Date Range

  1. Click the date selector
  2. Select start date
  3. Select end date
  4. Click Apply

Comparison Mode

Compare current period with previous period:

Real-time Analytics

Monitor live visitor activity on your website.

Live Visitors

Recent Pageviews

Last 50 pageviews with timestamps.

Real-time Buffer

Data is buffered for 5 minutes before being aggregated for performance.

Site Settings

Configure your site's analytics behavior.

General Settings

Privacy Settings

Exclusions

Exclude by IP: Add IP addresses to exclude (e.g., your office)

Example: 192.168.1.1, 10.0.0.0/8

Exclude in code: Add data-exclude="true" to tracking script:

<script defer data-site="YOUR_SITE_ID" data-exclude="true" src="https://eu1.faststats.io/t.js"></script>

Tracking Setup

Basic Installation

Add the tracking script to your site's <head> section:

<script defer data-site="YOUR_SITE_ID" src="https://eu1.faststats.io/t.js"></script>

Platform-Specific Guides

WordPress

  1. Install "Insert Headers and Footers" plugin
  2. Go to Settings → Insert Headers and Footers
  3. Paste tracking code in "Scripts in Header"
  4. Save changes

Shopify

  1. Go to Online Store → Themes
  2. Click Actions → Edit Code
  3. Open theme.liquid
  4. Paste code before </head>
  5. Save

Next.js

Add to pages/_document.js:

import { Html, Head, Main, NextScript } from 'next/document'

export default function Document() {
  return (
    <Html>
      <Head>
        <script defer data-site="YOUR_SITE_ID" src="https://eu1.faststats.io/t.js"></script>
      </Head>
      <body>
        <Main />
        <NextScript />
      </body>
    </Html>
  )
}

Custom Events

Track custom events with JavaScript:

// Basic event
faststats('event', 'Signup')

// Event with custom data
faststats('event', 'Purchase', { value: 99.99 })

Goals & Conversions

Creating a Goal

  1. Go to Site Settings → Goals
  2. Click Add Goal
  3. Configure the goal type

Goal Types

Pageview Goal

Triggered when visiting a specific page.

Example: Page path contains /thank-you

Event Goal

Triggered by custom events.

Example: Event name equals Purchase

Goal Value

Assign monetary value to goals for revenue tracking:

Conversion Funnel

Track multi-step conversion paths:

  1. Define funnel steps
  2. View drop-off rates at each step
  3. Identify bottlenecks

Email Reports

Setting Up Reports

  1. Go to Site Settings → Email Reports
  2. Click Create Report
  3. Configure frequency and recipients

Report Frequency

Report Contents

API Reference

Authentication

API requires authentication via API key:

Authorization: Bearer YOUR_API_KEY

Endpoints

Get Stats

GET /api/v1/stats
Parameters:
  - site_id: Your site ID
  - period: today|7d|30d
  - metrics: visitors,pageviews,bounce_rate

Get Breakdown

GET /api/v1/breakdown
Parameters:
  - site_id: Your site ID
  - property: page|country|referrer
  - period: Date range

Rate Limits

Self-Hosting Guide

Requirements

Installation

# Download latest release
wget https://faststats.io/releases/latest/faststats.tar.gz

# Extract
tar -xzf faststats.tar.gz
cd faststats

# Install dependencies
npm install

# Configure
cp config.example.yaml config.yaml
nano config.yaml

# Run migrations
npm run migrate

# Start server
npm run start

Configuration

Edit config.yaml:

server:
  port: 8000
  host: 0.0.0.0

database:
  host: localhost
  port: 5432
  database: faststats
  user: faststats
  password: YOUR_PASSWORD

redis:
  host: localhost
  port: 6379

Performance Tuning

Caching

Database Optimization

Scaling

Troubleshooting

No Data Appearing

  1. Verify tracking code is in <head>
  2. Check browser console for errors
  3. Confirm site_id matches dashboard
  4. Wait 5-10 minutes for data processing

Incorrect Visitor Counts

Contact Support

Appendix

Keyboard Shortcuts

Shortcut Action
T Toggle Today
Y Toggle Yesterday
W Toggle Last 7 Days
M Toggle Last 30 Days
L Toggle Live Mode
Esc Clear filters

Glossary

Term Definition
Visitor Unique person visiting your site (identified by fingerprint, not cookies)
Pageview Single page load
Session Series of pageviews with <30 min gaps
Bounce Single-page visit with no further interaction
Referrer Website that linked to your site
UTM Urchin Tracking Module - URL parameters for campaign tracking

GDPR Compliance

FastStats is GDPR compliant by design:

Data Retention

Default retention periods:

Data Type Retention
Raw events 2 years
Aggregated stats Indefinite
Real-time buffer 5 minutes

Configure in config.yaml:

retention:
  events_days: 730  # 2 years

FastStats - Privacy-focused analytics for the modern web.

© 2026 INUX Cloud s.r.o. | faststats.io