statpx User Guide: Complete Walkthrough of Every Feature
This guide walks you through every page and feature in statpx — from creating your account to reading advanced analytics. Bookmark it for reference, or jump to any section using the table of contents below.
- Getting Started: Create Your Account
- Adding Your First Website
- Installing the Tracking Snippet
- Dashboard — Your Sites at a Glance
- Stats Page — Detailed Analytics
- Visitor Log — Individual Hit Records
- Real-time — Live Visitor Feed
- Bot Traffic — Crawler Monitoring
- Campaigns — UTM Tracking
- Events — Custom Actions
- Goals — Conversion Tracking
- Site Settings
- Public Dashboard Share Links
- Profile & Account Settings
- Tips & Best Practices
1. Getting Started: Create Your Account
Go to statpx.com/register and enter a username, email address, and password. Your password must contain uppercase, lowercase, a digit, and a special character (8+ chars).
After registering, check your inbox for a verification email from statpx. Click the link, confirm on the page, and your account is active. Check your spam/junk folder if the email doesn't arrive within a minute.
2. Adding Your First Website
On the Dashboard, fill in the Add a new site form at the top:
- Site name — a friendly label (e.g. "My Portfolio")
- Domain — the bare domain, no protocol (e.g.
example.com)
Click Add site. The site card appears below with status Setup pending. You can add unlimited sites — one account manages all of them.
3. Installing the Tracking Snippet
Click 📋 Install snippet on the site card (or navigate to Snippet from the sidebar). You'll see two lines of code:
- Copy the entire snippet block — it sets
window._stidand loadstrack.js. - Paste it just before the closing
</body>tag on every page of your site (or in a shared layout/template file). - Deploy your site, then return to statpx and click Verify Installation on the Snippet page.
If verification succeeds, the site status changes to 🟢 Active. Alternatively, statpx auto-verifies your site the moment it receives the first real (non-bot) hit — whichever comes first.
Why snippet not found?
- Snippet is in
<head>instead of before</body> - A page cache is serving old HTML — clear cache and re-verify
- SPA (React / Vue / Next.js) — add the snippet to your root
index.html, not a component - Server-side rendering strips unknown scripts — whitelist the statpx domain
track.js automatically detects pushState navigation in React, Vue, Next.js, and similar frameworks. No extra configuration needed — each route change logs a separate pageview.4. Dashboard — Your Sites at a Glance
The Dashboard (dashboard.php) shows all your tracked sites as cards. Each card displays:
| Field | What it means |
|---|---|
| 🟢 Active | Snippet verified and collecting data |
| 🟡 Setup pending | Site added but snippet not yet verified |
| 🔴 Snippet removed? | Daily recheck failed 3+ days in a row |
| Pageviews (30d) | Human pageviews (bots excluded) in the last 30 days |
From each card you can go to View stats, Get snippet, or delete the site. Deleting permanently removes all associated data.
5. Stats Page — Detailed Analytics
The Stats page is your main analytics view. At the top, toggle between 7 days / 30 days / 90 days. The page is split into sections:
Summary cards
- Pageviews — total page loads (bots excluded)
- Sessions — distinct browsing visits
- Unique visitors — estimated unique people (via fingerprint-free hashing)
- Bounce rate — % of sessions with only 1 pageview
- Avg session duration — mean time spent per visit
- New vs returning — first-time vs repeat visitors
Charts & tables
The daily trend chart shows pageviews and sessions over the selected range. Below it you'll find tables for:
| Table | Description |
|---|---|
| Top Pages | Most-visited URLs with pageview count |
| Top Referrers | Sites and search engines sending you traffic |
| Countries | Visitor origin by country with flag |
| Cities | City-level breakdown (requires GeoIP data) |
| Browsers | Chrome, Safari, Firefox, etc. |
| Operating Systems | Windows, macOS, iOS, Android, etc. |
| Devices | Desktop / Mobile / Tablet split |
| Screen Resolutions | Common viewport sizes your visitors use |
| Languages | Browser language preference |
| Search Keywords | Organic search terms (from referrer URL when available) |
| 404 Pages | Broken URLs your visitors hit — red-tinted card |
Filters & Compare
Use the filter bar to narrow data by country, browser, device, or traffic source. The compare toggle shows current period vs the same prior period side by side.
6. Visitor Log — Individual Hit Records
The Visitor Log (Visitors in sidebar) shows a paginated table of raw hit records — one row per page load. Each row contains:
- Time — when the hit occurred (in your selected timezone)
- URL — the exact page path, with 404 badge if the page returned a not-found response
- IP address — the visitor's IP (green for humans, 🤖 badge for bots)
- Country & flag — geographic origin
- ASN / ISP — autonomous system number and organisation (e.g. "AS15169 Google LLC")
- Device / Browser / OS — hardware and software fingerprint
- Scroll % — how far down the page the visitor scrolled (color-coded: green ≥75%, blue ≥40%)
- User-Agent — raw browser or bot identifier string
Use the 🤖 Show bots pill button to toggle bot rows. Bot rows appear with an amber left border. You can also paginate (25 rows per page) and navigate between pages with the ← → controls.
7. Real-time — Live Visitor Feed
The Real-time page auto-refreshes every 30 seconds and shows activity from the last 30 minutes. It has four sections:
- Mini stat cards — Active Visitors, Pageviews, Bot Hits, Avg Scroll depth
- Active Pages — which URLs are being viewed right now, hit count, last seen
- Countries — where current visitors are from
- Referrers — traffic sources for the active window
- Recent Activity table — last 40 hits with full detail: Time, IP, Page, Country, Device/Browser, ASN/Company, Referrer, Scroll %, User-Agent
The LIVE badge pulses to confirm the page is auto-refreshing. Use Real-time when launching a product, running an ad, or monitoring a traffic spike.
8. Bot Traffic — Crawler Monitoring
The Bots page (🤖 in sidebar) is dedicated to crawler analysis. It shows:
- Bot Requests counter — total bot hits for Today / 7d / 30d
- Bot Breakdown by Name — bar chart categorising bots: Googlebot, Bingbot, Yandex, GPTBot (OpenAI), ClaudeBot, ByteSpider (TikTok), SEMrush, Ahrefs, and more
- Top Bot IPs — IP addresses with ASN/company info
- Top Bot User-Agents — raw UA strings grouped by frequency
Filtering bot traffic
Use the filter bar at the top to narrow results by IP address, User-Agent keyword, Country code, or ASN. When any filter is active, a detail table appears showing individual matching hits with timestamps.
9. Campaigns — UTM Tracking
Campaigns (📣 in sidebar) shows traffic from URLs tagged with UTM parameters. statpx automatically parses these standard parameters from every hit:
utm_source— where the traffic originated (e.g.newsletter)utm_medium— the marketing channel (e.g.email)utm_campaign— the campaign name (e.g.spring-sale)utm_term— keyword for paid searchutm_content— differentiates ads (e.g.banner-avsbanner-b)
The Campaigns page also includes a URL builder — fill in the fields and copy the tagged link ready to use in your newsletter or ad platform.
10. Events — Custom Actions
Events (🎯 in sidebar) tracks custom user interactions beyond pageviews. Three event types are collected automatically:
- Outbound links — clicks on links to external domains
- File downloads — clicks on PDF, ZIP, MP4, and similar file extensions
- Custom events — anything you fire via the JavaScript API
Firing a custom event
After the snippet is installed, call _st('event', 'event_name', 'category', value) from any JavaScript on your page. For example:
- Button click:
_st('event', 'signup', 'cta') - Video play:
_st('event', 'video_play', 'media', 1) - Form submit:
_st('event', 'contact_form', 'engagement')
The Events page groups events by name and category, showing total count, unique sessions, and a daily trend chart.
11. Goals — Conversion Tracking
Goals (📍 in sidebar) lets you define a conversion and track how often it happens per session. Two goal types are available:
| Type | Triggers when… | Match modes |
|---|---|---|
| URL goal | A visitor loads a specific page | Exact, Contains, Starts with, Regex |
| Event goal | A custom event fires with a given name | Exact, Contains |
Each goal shows a conversion rate (% of sessions that hit the goal), total conversions, and a daily chart. A session only counts once per goal, even if the goal page is loaded multiple times.
12. Site Settings
Navigate to ⚙️ Settings in the sidebar for any site. Options include:
- Excluded IPs — add your own IP or office CIDR to prevent your visits from appearing in stats
- Data retention — how many days of raw hits to keep (default 365, min 30, max 3650). Daily rollup data is kept forever regardless of this setting.
- Public share link — enable a read-only public dashboard URL to share with clients or teammates, with no login required
13. Public Dashboard Share Links
When you enable the share link in Site Settings, anyone with the URL can view an aggregate-only read-only version of your dashboard. What they can see: pageviews, sessions, bounce rate, daily chart, top pages, referrers, countries, browsers, and devices.
What they cannot see: individual visitor IPs, Visitor Log, UTM details, search keywords, admin links, or your account details. Bot traffic is always excluded from the public view.
You can regenerate the token at any time (old links immediately stop working) or disable sharing entirely.
14. Profile & Account Settings
Click 👤 Profile in the sidebar to manage your account.
Email & Display preferences
- Weekly digest — on/off toggle for the Monday morning email summarising each site's traffic
- Timezone — choose your IANA timezone (e.g. America/New_York). All timestamps in the Visitor Log and Real-time page display in this timezone. Use the Auto-detect button to set it from your browser automatically. Storage always stays UTC.
Change password
Enter your current password and a new one (must meet the strength policy). The change takes effect immediately.
Two-factor authentication (2FA)
Enable TOTP-based 2FA using any authenticator app (Google Authenticator, Authy, 1Password, etc.):
- Go to Profile → Two-factor authentication → Set up 2FA
- Scan the QR code with your authenticator app
- Enter the 6-digit code to confirm setup
- Save your 8 backup codes — these are shown once and cannot be recovered. Store them somewhere safe.
Once enabled, you'll enter your password then a 6-digit code on each login. If you lose your device, use a backup code. If you lose both, contact an admin to reset 2FA directly in the database.
Delete account
The delete option (in the Danger Zone at the bottom of Profile) permanently removes your account and all associated sites, hits, sessions, events, goals, and rollup data. This cannot be undone.
15. Tips & Best Practices
- Exclude your own IP first. Visit Site Settings → Excluded IPs before you start getting traffic, so your own page tests don't inflate your numbers.
- Check the 404 card weekly. The Stats page shows a dedicated "Top 404 pages" card. Broken internal links hurt SEO — fix them or set up redirects.
- Use scroll depth to evaluate content quality. Pages with high scroll % are engaging. Pages below 30% may need a stronger hook at the top.
- Tag all your external campaigns. Any link in a newsletter, ad, or social post should include UTM parameters so you can separate campaign traffic from organic.
- Monitor bot traffic during launches. AI crawlers (GPTBot, ClaudeBot, ByteSpider) may spike after you publish popular content. The Bots page shows exactly which crawlers visit and how often.
- Set goals for every key action. Even a simple "thank you page" URL goal for a contact form gives you a measurable conversion rate to optimise toward.
- Enable the weekly digest. The Monday email gives you a 7-day summary per site — useful even if you only check statpx once a week.
- Use the public share link for clients. If you manage sites for clients, share the read-only dashboard link — they get a clean view without access to your account.
Ready to start tracking?
Create your free statpx account — no credit card, no ads, unlimited websites.
Get started for free →The Bottom Line
Getting value from analytics depends less on the tool and more on knowing where to look. A few deliberate habits — excluding your own IP before traffic arrives, tagging every campaign link with UTM parameters, and glancing at the 404 card weekly — turn raw numbers into decisions you can act on. Set at least one goal for your most important conversion, even a simple thank-you page URL, so you always have a measurable rate to improve. All of this data is collected and organised automatically by statpx, which surfaces pageviews, scroll depth, bot activity, and campaign performance in a single dashboard without any configuration beyond the one-line snippet.