🔧 Integration Guide

Step-by-step instructions to integrate our tracking script into your website

🚀 Quick Start (30 seconds)

1. Copy the tracking code

<!-- Traffic Tracker Configuration -->
<script>
  // Set your tracking code (REQUIRED - get this from your dashboard)
  window.TRACKING_CODE = 'YOUR_TRACKING_CODE_HERE'
</script>

<!-- Use the tracker script -->
<script src="https://webtraffictracker.vercel.app/tracker.js" defer></script>

2. Add it to your website's <head> section

Paste the code just before the closing </head> tag in your HTML.

<!DOCTYPE html>
<html>
<head>
  <title>Your Website</title>
  <!-- Traffic Tracker Configuration -->
  <script>
    // Set your tracking code (REQUIRED - get this from your dashboard)
    window.TRACKING_CODE = 'YOUR_TRACKING_CODE_HERE'
  </script>
  
  <!-- Use the tracker script -->
  <script src="https://webtraffictracker.vercel.app/tracker.js" defer></script>
</head>
<body>
  <!-- Your website content -->
</body>
</html>

🔴 Real-time Analytics Verification

After adding the tracking script, you can verify that real-time analytics are working:

✅ How to Verify Real-time Analytics

Open your dashboard and navigate to the Analytics page
Visit your tracked website in a new browser tab
Watch the dashboard - you should see live updates within seconds
Check browser console - look for "SSE connection opened" messages
Test multiple pages - navigate between pages on your site

🚨 Troubleshooting

If you see "ERR_BLOCKED_BY_CLIENT" errors, the new SSE implementation should resolve this
Make sure your site is using the latest tracking script from your dashboard
Check that the tracking code is placed in the <head> section before other scripts
Verify your site is added to the dashboard and is active

🛠 Platform-Specific Integration

📄 HTML Websites

For static HTML websites, add the script tag to your head section.

<script src="https://webtraffictracker.vercel.app/tracker.js" defer></script>

🔌 WordPress

Add to your theme's header.php file or use a plugin.

<!-- Add before </head> in header.php -->

⚛️ React/Next.js

Add to your _document.js or _app.js file.

<Script src="https://webtraffictracker.vercel.app/tracker.js" strategy="afterInteractive" />

🛒 Shopify

Add to your theme.liquid file in the head section.

<!-- Add to theme.liquid -->

✅ Verification & Testing

🔍 Check Console

Open browser DevTools and look for tracking messages.

📊 Tracking page view: https://yoursite.com

📊 Check Dashboard

Visit your website and check if data appears in the dashboard. Sign in to view your analytics.

🧪 Test Page

Use our test page to verify the integration is working.

Test Integration

🔧 Troubleshooting

❌ No data in dashboard

Check if script is in the <head> section
Verify the script URL is correct
Check browser console for errors
Ensure JavaScript is enabled

⚠️ CORS errors

Check if your domain is allowed
Verify HTTPS is enabled
Clear browser cache
Try incognito mode

💡 Still having issues?

Contact our support team for personalized help.

🆘 Need More Help?

Our team is here to help you get started quickly and easily.

← Back to Home