PureStats documentation
Quick start
Install PureStats and receive your first pageview in a few minutes.
This guide gets a new site from zero to a verified PureStats dashboard.
Try the interactive demo without an account. Its data is fictional and its period, source, campaign and funnel views can be explored safely.
1. Create or sign in to your account
Use email, Google SSO or GitHub SSO. Email accounts must confirm their email address before they can sign in. After the first login, open the Analytics area and add your first website.
2. Add your site
Enter the canonical domain, for example example.com. Do not include https://, paths, query strings or fragments. PureStats automatically adds the matching www. or non-www. hostname when available. Add app, docs, checkout or other product hostnames later as site aliases.
PureStats rejects invalid hostnames and stores only domains that can belong to a real website. This keeps exploit payloads and spam hostnames out of the sites list.
The timezone initially follows your browser. Confirm it before saving. The Getting started tab guides you through platform selection, installation, a received visit and your first goal.
3. Install the tracker
Add the script to every page you want to track:
<script defer src="https://purestats.io/pf.min.js" data-domain="example.com"></script>
Use the canonical domain from your PureStats site settings. When aliases are configured, the tracker may run on any allowed domain, but data-domain should still identify the canonical site.
4. Verify the installation
Open your website in a browser, then go to the site setup or Site Health view in PureStats. Verification checks three separate states:
- The script tag is present on the page.
- The script file loads successfully.
- PureStats receives the first pageview hit.
5. Create a conversion goal
After a real tracking hit is received, create a goal in Getting started. Choose a page such as /thank-you, or an event your application already sends. Goals count future matching actions. More goal types and funnels are available in Site Settings.
6. Confirm a real conversion
Getting started offers templates for a completed signup, a successful contact form or a thank-you page. Send event goals only after the underlying action succeeds. Use Tracking test mode to diagnose matching without changing statistics. The final setup step completes only after a real human conversion is received and shows the elapsed time since website creation.
7. Read the dashboard
After the first hit, open the analytics dashboard and choose a period such as Today, This Week or This Month. The cards show current visitors, visitors, pageviews and views per visit with period-to-date comparison where applicable.
Switching reports retains the selected period, comparison, filters and segment. Automatic weekly insights summarize the last completed local calendar week independently of the currently selected dashboard filters.