> ## Documentation Index
> Fetch the complete documentation index at: https://docs.komerza.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Analytics SDK
> Bring back visitor analytics to your Komerza Dashboard with our lightweight analytics script
## Overview
The Komerza Analytics SDK allows you to track visitor behavior on your custom website and view the analytics directly in your Komerza Dashboard. With just a single script tag, you'll get comprehensive visitor insights including page views, user sessions, conversion tracking, and more.
Access your visitor analytics in the Komerza Dashboard
## Features
Automatic cookie consent management with essential/optional cookies
Just include the script with your store ID - no complex setup required
View visitor data instantly in your Komerza Dashboard
Respects user privacy with transparent cookie consent and Shadow DOM isolation
## Quick Start
### Single Script Integration
Add the analytics script to your HTML pages with your store ID:
```html theme={null}
My Store
Welcome to My Store
```
Replace `your-store-id` with your actual Komerza store ID from your dashboard.
The analytics script automatically handles GDPR compliance by showing a cookie
consent notice to visitors.
## Cookie Consent Flow
When a visitor first arrives on your site:
1. **Immediate Pageview**: An IP-only pageview is recorded immediately (GDPR compliant)
2. **Cookie Notice Display**: A GDPR-compliant notice appears in the bottom-right
3. **20-Second Timer**: If no response, "Required Only" tracking activates automatically
4. **User Choice**: Visitor can choose "Required Only" or "Accept All" at any time
5. **Preference Storage**: Choice is remembered for future visits (1-hour cookie expiry)
* Random visitor ID (not fingerprinted)
* Device type and browser name
* Referrer information
* Session tracking (1-hour expiry)
* No cross-session tracking
* Browser fingerprint for stable visitor ID
* Full analytics tracking
* Enhanced user behavior insights
* Conversion and goal tracking
* Detailed performance metrics
* Cross-session tracking
## Implementation Examples
### Basic Website
```html theme={null}
My Online Store
My Store
Welcome to My Store
Discover amazing products...
```
### E-commerce Site
```html theme={null}
Product Page - My Store
Amazing Product
$29.99
```
### React/SPA Integration
For single-page applications, add the script once in your main HTML file:
```html theme={null}
My React Store
```
## Manual Consent Control
If you want to programmatically control consent (e.g., custom cookie banner):
```html theme={null}
```
## Privacy Features
* **Random visitor IDs**: Required-only tracking uses crypto-random IDs (not fingerprinted)
* **Short expiry**: All cookies expire after 1 hour
* **No cross-domain tracking**: Cookies are site-specific
* **IP anonymization**: Essential pageviews are IP-only, no visitor ID
## Content Security Policy (CSP)
For sites with CSP headers, add the following to your CSP configuration:
```http theme={null}
Content-Security-Policy:
script-src 'self' https://cdn.komerza.com;
connect-src 'self' https://m-api.komerza.com;
```
The analytics script does not require CSP nonce integration as it loads from a
trusted CDN. However, ensure `https://cdn.komerza.com` is in your `script-src`
directive, and `https://m-api.komerza.com` is in your `connect-src` directive
to allow data transmission.
## Viewing Your Analytics
Once the script is installed and visitors start coming to your site:
1. **Login to Dashboard**: Visit [dashboard.komerza.com](https://dashboard.komerza.com)
2. **Navigate to Visitor Analytics**: Click on the "Visitors" section
3. **View Insights**: See real-time and historical visitor data
4. **Track Performance**: Monitor conversion rates and user behavior
View live visitor activity and current site performance
Access detailed reports and trends over time
## Ad Blocker Compatibility
The analytics script uses the filename `ka.min.js` which is less likely to be blocked by ad blockers compared to filenames containing "analytics" or "tracking". However, some aggressive blockers may still block analytics requests.
## Support
Access your visitor analytics and reports
Get help with analytics integration
