User Guide

Everything you need to know about using AI Infos Web Statistics

No sections matched your search.
Try a different keyword.
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 limitStarterProBusiness
Websites310Unlimited
Page views / month50,000500,000Unlimited
Installing the Tracking Script
One snippet — no cookies, no personal data collected

Add the snippet just before the closing </body> tag on every page you want to track. Most CMS platforms have a "Header / Footer Scripts" setting.

<!-- AI Infos Web Statistics --> <script async src="https://yourdomain.com/script.js" data-site-id="YOUR_SITE_ID"></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 async — it never blocks your page load. It is lightweight (~2 KB) and cookie-free.
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
CardWhat it shows
WebsitesTotal number of websites you are tracking.
Page ViewsTotal page loads recorded across all sites in the selected period.
Unique VisitorsDistinct visitors (by fingerprint hash) in the selected period.
Online NowVisitors 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:

MetricDescription
Page ViewsTotal number of pages loaded.
Unique VisitorsNumber of distinct visitors (fingerprint-based, not cookies).
Unique PagesNumber of distinct URLs visited — now a live COUNT(DISTINCT url) query, not capped at 10.
Online NowVisitors active in the last 5 minutes.
Daily Traffic chartLine 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 / OSBreakdown 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
TabWhat it shows
ReferrersFull referrer URLs that sent traffic to your site, ranked by hits.
Search EnginesTraffic from Google, Bing, DuckDuckGo, Baidu, and other search engines.
Social MediaTraffic from Facebook, Twitter/X, LinkedIn, Instagram, Reddit, etc.
SourcesGrouped 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.

ParameterExamplePurpose
utm_sourcenewsletterWhere the traffic comes from
utm_mediumemailThe marketing medium
utm_campaignsummer-sale-2025The 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.

FieldOptions / Notes
MetricPage Views or Unique Visitors
ConditionAbove or Below a threshold
ThresholdThe 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
EndpointDescription
GET /api/v1/accountYour account details and plan info
GET /api/v1/websitesList all your websites
GET /api/v1/websites/{id}/statsStats for a specific website (supports ?period=)
GET /api/v1/websites/{id}/realtimeLive 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.

FieldRequiredExample
utm_sourceRequiredmailchimp, google, twitter
utm_mediumRecommendedemail, cpc, social
utm_campaignRecommendedblack-friday-2025
utm_contentOptionalhero-button, sidebar-link
utm_termOptionalanalytics+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.