Getting Started

Create your account and track your first website in under 2 minutes

1

Create your account

Click Get Started on the homepage or go to /register. Enter your name, email address, and a password (minimum 8 characters). You'll be logged in immediately after registration.

2

Add your first website

From the Dashboard click Add Website, or go to Websites → New Website. Enter a friendly name and your website's domain (e.g. example.com).

3

Install the tracking script

Copy the one-line <script> tag shown after adding the site and paste it before the </body> tag on every page of your website. That's it — no cookies, no GDPR banners needed.

4

Verify data is flowing

Visit your website in a browser. Within seconds your visit will appear in the Real-Time analytics tab. The dashboard will show data as soon as the first page view is recorded.

Your free trial includes all features. No credit card required to start.

Adding & Managing Websites

Each website gets its own tracking code and analytics dashboard

Add a new website

1

Go to Websites → New Website

Click the Websites link in the sidebar, then the + New Website button at the top right.

2

Enter site details

Fill in a Display Name (e.g. "My Blog") and the Domain without the protocol (e.g. myblog.com). The timezone and currency fields are optional.

3

Copy the snippet

After saving, your unique tracking snippet is shown. Copy it and add it to your site — see the Installing Tracking Script section below.

Website settings

From the Websites list, click the site name to open its settings page. Here you can rename the site, update the domain, enable or disable the public share dashboard, regenerate the tracking code, or permanently delete the site and all its data.

Regenerating the tracking code creates a new unique ID. You must replace the old snippet on your website or tracking will stop.

Plan limit	Starter	Pro	Business
Websites	3	10	Unlimited
Page views / month	50,000	500,000	Unlimited

Installing the Tracking Script

One snippet — no cookies, no personal data collected

Copy the exact snippet from your website's Install Script page in the dashboard — it contains your unique site code. Paste it just before the closing </body> tag on every page you want to track.

<script defer src="https://your-stats-domain.com/s.php?site=YOUR_SITE_CODE"></script>

WordPress Paste in Appearance → Theme Editor → footer.php or use a "Header & Footer Scripts" plugin.

Shopify Go to Online Store → Themes → Edit Code → theme.liquid and paste before </body>.

Webflow Project Settings → Custom Code → Footer Code section.

HTML / Any CMS Paste directly into every HTML template, just before </body>.

The script is deferred — it never blocks your page load. It is lightweight (<2 KB), cookie-free, and tracks SPA route changes automatically (React Router, Next.js, Vue Router).

React, Next.js & Vite — important: add to the HTML shell, not a component

JavaScript frameworks replace the DOM after the HTML loads. If you add the script inside a React component or useEffect, it will be injected dynamically and may not track correctly. Always add it to the static HTML file.

Create React App / Vite React

Open public/index.html and paste before </body>:

<script defer src="https://your-stats-domain.com/s.php?site=YOUR_SITE_CODE"></script>

Next.js (App Router or Pages Router)

Add to app/layout.tsx (App Router) or pages/_app.tsx (Pages Router):

// app/layout.tsx (App Router) import Script from 'next/script' export default function RootLayout({ children }) { return ( <html> <body> {children} <Script src="https://your-stats-domain.com/s.php?site=YOUR_SITE_CODE" strategy="afterInteractive" /> </body> </html> ) }

The tracker automatically follows React Router / Next.js / Vue Router navigation and records each route change as a separate page view — no extra configuration needed.

Dashboard

Your high-level overview across all tracked websites

The Dashboard is the first page you see after login. It shows combined stats across all your websites for a selected time period, plus a traffic trend chart and individual site cards.

Stat cards

Card	What it shows
Websites	Total number of websites you are tracking.
Page Views	Total page loads recorded across all sites in the selected period.
Unique Visitors	Distinct visitors (by fingerprint hash) in the selected period.
Online Now	Visitors who have been active in the last 5 minutes across all sites.

Period filter

Use the pill buttons in the top-right of the Dashboard header to change the reporting period. All stat cards, the traffic chart, and every website card update together.

24h 7 days 30 days 90 days 1 year

Analytics

Deep-dive into traffic data for each individual website

Open a website's analytics by clicking Analytics on its card in the Dashboard or the Websites list. A tab bar at the top lets you switch between sections. A period filter (24h / 7d / 30d / 90d / 1y) applies to all tabs simultaneously.

Overview tab

The overview provides a snapshot of your site's key metrics for the selected period:

Metric	Description
Page Views	Total number of pages loaded.
Unique Visitors	Number of distinct visitors (fingerprint-based, not cookies).
Unique Pages	Number of distinct URLs visited — now a live `COUNT(DISTINCT url)` query, not capped at 10.
Online Now	Visitors active in the last 5 minutes.
Daily Traffic chart	Line chart of page views and unique visitors per day.
Top Pages (mini)	Your 10 most-visited pages. Links through to the full Pages tab.
Top Referrers (mini)	Top traffic sources. Links through to Referrers tab.
Browsers / Devices / OS	Breakdown of visitor technology. Links through to Devices tab.
Top Countries (mini)	Where visitors are coming from. Links through to Locations tab.

Pages tab

The Pages tab has two sections:

Top Pages Ranked by total hits. Shows URL, title, views, a visual bar, unique visitors, and last seen time. Collapses automatically when you paginate Recent Views.

Recent Page Views Chronological log of individual page loads with browser, OS, device, hashed IP, country, city, and exact time. Paginated — use the ▶ Next button to go deeper.

Click the Hide / Show toggle on Top Pages to collapse it and focus on the recent log when paginating.

Referrers & Sources tabs

Tab	What it shows
Referrers	Full referrer URLs that sent traffic to your site, ranked by hits.
Search Engines	Traffic from Google, Bing, DuckDuckGo, Baidu, and other search engines.
Social Media	Traffic from Facebook, Twitter/X, LinkedIn, Instagram, Reddit, etc.
Sources	Grouped by medium: organic, direct, referral, email, paid, social.

Devices tab

Shows how visitors access your site, broken into three panels:

Device Type Desktop, Mobile, Tablet — with percentage rings and counts.

Browsers Chrome, Firefox, Safari, Edge and others with visitor counts and bars.

Operating Systems Windows, macOS, iOS, Android, Linux with detailed version information.

Screen Resolutions Most common screen sizes your visitors use (e.g. 1920×1080).

Locations tab

The Locations tab combines a World Map with a full country table and bar chart.

Interactive World Map Light atlas-style map. Countries with traffic are shaded blue — more visitors = darker indigo. Hover for a tooltip, click for a detail panel.

Zoom controls Use the + / − buttons (bottom-right of map) to zoom in and out. Click the compress icon to reset the view.

Top-5 overlay A floating panel (desktop only) shows your top 5 countries with flags and visitor counts directly on the map.

Country table Full ranked list with visitors, page views, and percentage share for each country.

Location data requires a GeoIP database (GeoLite2-City.mmdb). Enable it in config/app.php → geoip.enabled = true and upload the database to storage/GeoIP/.

Campaigns (UTM) tab

Automatically tracks UTM parameters in your URLs. Any page view with utm_source, utm_medium, or utm_campaign parameters in the URL is grouped here. Use the UTM Builder tool to generate tagged links.

Parameter	Example	Purpose
`utm_source`	`newsletter`	Where the traffic comes from
`utm_medium`	`email`	The marketing medium
`utm_campaign`	`summer-sale-2025`	The specific campaign name

Real-Time tab

Shows visitors currently active on your site (last 5 minutes). The page auto-refreshes every 10 seconds. You can see their active page, country, browser, device, and referrer source — all without storing any personal information.

Open Real-Time on a second screen while you launch a campaign or publish a new post to watch traffic arrive live.

Conversion Goals

Track specific actions that matter to your business

Goals let you measure when visitors reach an important page (e.g. a thank-you page after purchase) or fire a custom event (e.g. button click). Go to Websites → [Your Site] → Goals.

Creating a goal

1

Choose goal type

Page Visit — triggers when a visitor lands on a specific URL path (e.g. /thank-you). Custom Event — triggers when your JavaScript fires a named event.

2

Set the target value

For Page Visit goals enter the URL path. For Custom Event goals enter the event name you will fire from your code.

3

Track results

Go to Analytics → Goals to see completions, conversion rate, and a daily trend chart for each goal.

To fire a Custom Event from your site, call: window.wsai && wsai.track('EventName', { key: 'value' })

Custom Events

Track any user interaction beyond page views

Once the tracking script is installed you can fire named events from your JavaScript code. Events appear in Analytics → Events grouped by name, with total count and unique visitors.

// Fire a custom event if (window.wsai) { wsai.track('Signup Button Clicked', { plan: 'pro', location: 'homepage-hero' }); }

Use clear, descriptive event names like "Add to Cart" or "Video Played". Metadata key/value pairs are optional but useful for segmentation.

Traffic Alerts

Get notified when traffic spikes or drops beyond a threshold

Traffic Alert Rules send you an email and in-app notification when a metric crosses a threshold you define. Go to Websites → [Your Site] → Alerts.

Field	Options / Notes
Metric	Page Views or Unique Visitors
Condition	Above or Below a threshold
Threshold	The number to compare against (e.g. 1000 page views)
Period (hours)	Rolling window: 1h, 6h, 12h, or 24h

Alert rules are checked by the cron job (cron.php). Make sure your server runs php cron.php at least every hour via crontab.

Public Share Dashboard

Share a read-only view of your analytics with clients or your team

1

Enable sharing

Go to Websites → [Your Site] and toggle Enable Public Dashboard. A unique shareable link is generated.

2

Optional: password-protect

Tick Password Protect and enter a password. Visitors must enter it before seeing any data.

3

Share the link

Copy the link from the settings page. Anyone with the link (and password if set) can view your analytics — no account needed.

The public dashboard shows the same charts as your private analytics but has no edit controls. Perfect for sending monthly reports to clients.

Settings

Manage your account preferences and security

Profile & Password

Go to Settings → Profile. You can update your display name, email address, and timezone. To change your password, enter your current password first, then the new password (min 8, max 72 characters).

Changing your email logs you out of all other sessions. Your new email must not already be in use.

Two-Factor Authentication (2FA)

Adds a second layer of security to your login. Go to Settings → Two-Factor Auth.

1

Install an authenticator app

Google Authenticator, Authy, or any TOTP-compatible app on your phone.

2

Scan the QR code

Click Enable Two-Factor Auth. Scan the QR code shown with your authenticator app.

3

Confirm with a code

Enter the 6-digit code from your app to confirm setup. Save your backup codes in a safe place — they let you regain access if you lose your phone.

After 5 incorrect 2FA attempts, your session is cleared and you must log in again. This prevents brute-force attacks.

Email Reports

Go to Settings → Email Reports. Enable the toggle and choose a frequency — Daily Weekly Monthly. The cron job sends a summary email with your top metrics and trends.

API Keys

Go to Settings → API Keys. Generate a key to access the REST API programmatically. Include it as a Bearer token in the Authorization header of every request.

Authorization: Bearer wsai_your_api_key_here

Endpoint	Description
`GET /api/v1/account`	Your account details and plan info
`GET /api/v1/websites`	List all your websites
`GET /api/v1/websites/{id}/stats`	Stats for a specific website (supports `?period=`)
`GET /api/v1/websites/{id}/realtime`	Live visitor data for a website

Keep your API key secret. Never expose it in client-side JavaScript or public repositories. Revoke it immediately if compromised.

UTM Builder

Generate trackable campaign links in seconds

Go to Tools → UTM Builder. Paste your destination URL, fill in the campaign parameters, and copy the generated link. Use it in emails, social posts, or paid ads to see exactly where your traffic comes from.

Field	Required	Example
`utm_source`	Required	`mailchimp`, `google`, `twitter`
`utm_medium`	Recommended	`email`, `cpc`, `social`
`utm_campaign`	Recommended	`black-friday-2025`
`utm_content`	Optional	`hero-button`, `sidebar-link`
`utm_term`	Optional	`analytics+software`

Billing & Plans

Manage your subscription and payment details

Go to Billing in the sidebar to see your current plan, usage, and renewal date. Click Upgrade to move to a higher-tier plan.

Upgrading Click Upgrade, choose a plan, and complete checkout. Your new limits apply immediately.

Invoices Managed through the payment provider portal. Click Manage Billing to download invoices or update your card.

Cancelling Cancel anytime through the billing portal. You keep access until the end of the current billing period.

Free Trial New accounts get a free trial with full feature access. No credit card required. Upgrade before it ends to keep your data.

Export & Privacy

Download or permanently delete your analytics data

Exporting data

Go to Settings → Export / Delete. Choose a date range and click Export Data to download a CSV of your page views and visitor sessions. The CSV includes URL, referrer, country, city, browser, OS, device, and timestamp for each visit.

Deleting data

Use the Delete Data section to permanently remove all analytics records for a specific date range across all your websites. This action is irreversible.

Deleted data cannot be recovered. Export first if you need a backup.

Database Optimisation

Go to Settings → Optimisation to run OPTIMIZE TABLE on the database. This reclaims space after large data deletions and can speed up queries. Run it occasionally — it briefly locks the table while running.

Privacy

Go to Settings → Privacy to review what data is collected and how your IP address is hashed. This page also lets you permanently delete your entire account.

Cookie-free No cookies are set on your visitors' browsers. No GDPR consent banner needed.

Hashed IPs IP addresses are one-way hashed with a server-side salt. The original IP is never stored.

No fingerprinting No canvas, font, or device fingerprinting. Visitors are identified by a short-lived session token only.

Self-hosted All data stays on your own server. Nothing is sent to third-party analytics providers.

User Guide