DataLaunch Documentation

Everything you need to know about using DataLaunch analytics platform

🚀Getting Started

Quick Setup

1. Create an account or sign in to DataLaunch 2. Add your first site from the Sites page 3. Copy the tracking code provided 4. Add the code to your website's <head> section 5. Visit your site and check back - analytics will start flowing!

Adding the Tracking Script

Add this code before the closing </head> tag of your website: <script defer src="https://your-datalaunch-domain.com/track.js" data-site-id="your-site-id"></script> Replace "your-datalaunch-domain.com" with your DataLaunch instance URL and "your-site-id" with the ID provided when you create a site.

Verifying Installation

After adding the tracking code: 1. Visit your website 2. Open browser DevTools (F12) 3. Check the Network tab for requests to /api/collect 4. If you see successful requests, tracking is working! 5. Check your DataLaunch dashboard - you should see your visit within seconds.

✨Features

Real-Time Analytics

See live visitors on a 3D globe, track pageviews in real-time, and monitor session activity as it happens. All data updates automatically every few seconds.

Privacy-First Tracking

DataLaunch uses zero cookies and no fingerprinting. We only track: - Anonymous session IDs (stored in localStorage) - Country-level geolocation (no exact GPS) - Browser, OS, and device information - Page paths and referrers - Custom events you define We never track: - IP addresses (displayed) - Personal information - Cross-site behavior - Exact location

Custom Events

Track custom events like signups, purchases, or any user action: // Track a signup datalaunch.track('signup') // Track a purchase datalaunch.track('purchase') // Track with context datalaunch.track('button_click') Events appear in your dashboard under "Custom Events" and can be analyzed over time.

Multi-Site Support

Track unlimited websites from a single dashboard. Perfect for: - Agencies managing multiple clients - Developers with multiple projects - Businesses with multiple domains Each site has its own tracking code and analytics. Switch between sites using the site selector in the navigation.

🔌API & Integration

Tracking API

The tracking script automatically sends data to: - POST /api/collect - Pageviews and sessions - POST /api/heartbeat - Session duration updates - POST /api/event - Custom events All endpoints accept JSON and handle CORS for cross-origin requests.

Custom Event Tracking

Track custom events from your JavaScript: // Simple event window.datalaunch.track('signup') // Event on button click document.getElementById('signup-btn').addEventListener('click', () => { window.datalaunch.track('signup') }) // Event in React const handleSignup = () => { window.datalaunch?.track('signup') }

SPA Support

DataLaunch automatically tracks pageviews in Single Page Applications (SPAs) by monitoring the History API. No additional configuration needed! The script detects: - pushState() calls - replaceState() calls - popstate events (browser back/forward) Each route change is tracked as a new pageview.

❓FAQ

Is DataLaunch GDPR compliant?

Yes! DataLaunch is designed with privacy in mind: - Zero cookies (uses localStorage only) - No personal data collection - No fingerprinting - Country-level geo only (no exact location) - Anonymous session IDs - No cross-site tracking However, you should still have a privacy policy that explains what data you collect.

How accurate is the analytics?

DataLaunch provides accurate analytics for: - Pageviews (tracked on every page load/navigation) - Unique visitors (based on session IDs) - Session duration (updated every 15 seconds) - Bounce rate (calculated from single-page sessions < 10 seconds) Note: Some visitors may block JavaScript or use privacy tools that prevent tracking. This is normal for all analytics platforms.

Can I export my data?

Currently, data export is available through the dashboard interface. We're working on CSV/JSON export functionality. Your data is stored in your Supabase database, so you have full access to it.

How long is data stored?

Data is stored indefinitely in your Supabase database. You can manually delete old data or set up retention policies. We recommend keeping at least 1 year of data for trend analysis.

Does it work with ad blockers?

Like all analytics tools, DataLaunch may be blocked by some ad blockers. However, since we use a custom domain and don't use common analytics domains, we're less likely to be blocked than Google Analytics.

Can I self-host DataLaunch?

Yes! DataLaunch is designed to be self-hosted. You can: 1. Deploy to Vercel, Railway, or any Node.js hosting 2. Use your own Supabase instance 3. Customize the code as needed 4. Keep all data on your infrastructure

How do I track multiple domains?

Each domain needs its own site entry in DataLaunch. Create a new site for each domain and add the corresponding tracking code. All sites will appear in your dashboard, and you can switch between them using the site selector.

What browsers are supported?

DataLaunch works in all modern browsers: - Chrome/Edge (latest) - Firefox (latest) - Safari (latest) - Opera (latest) The tracking script uses standard web APIs and has fallbacks for older browsers.

🔧Troubleshooting

No data appearing in dashboard

If you're not seeing data: 1. Verify the tracking code is in your website's <head> 2. Check browser console for errors 3. Verify the site-id matches your site 4. Check Network tab for API requests 5. Ensure CORS is properly configured 6. Wait a few minutes - data may take time to appear

CORS errors in console

If you see CORS errors: 1. Ensure your DataLaunch instance has CORS headers enabled 2. Check that the API_BASE URL in track.js points to your DataLaunch domain 3. Verify the tracking script is loading from the correct domain 4. Check browser console for specific error messages

Session not tracking correctly

If sessions seem incorrect: 1. Clear browser localStorage (datalaunch_session key) 2. Check that localStorage is enabled in browser 3. Verify session timeout is 30 minutes 4. Check that heartbeat is sending (every 15 seconds) 5. Ensure JavaScript is enabled

Custom events not appearing

If custom events aren't showing: 1. Verify window.datalaunch exists (check console) 2. Ensure you're calling datalaunch.track() after page load 3. Check Network tab for /api/event requests 4. Verify the event name is a string 5. Check dashboard after a few minutes

Need more help? Check the dashboard or contact support.

Back to Dashboard →