Skip to main content
Adding the tracking script to your site is all it takes to start collecting data. Page views, traffic sources, and session recordings are captured automatically — no event setup needed. What you need:
  • Your Bigdelta tracking key, found in Settings → Access Keys

​
Add the script tag

For most sites, paste this into the <head> of every page (use a shared layout or template if you have one):

​
Or install via npm

For projects with a package manager:
Create one shared module that initializes the client and exports it, then import it from your app’s root so it runs on every page:
Initialize the client exactly once per page load. In server-side rendered frameworks (Next.js, Nuxt, SvelteKit, Astro), only create the client in the browser — for example in a 'use client' component or inside useEffect. Route changes in single-page apps are tracked automatically by singlePageAppTracking, so don’t add manual page-view calls.
Building with an AI tool like Lovable, Replit, Cursor, or Claude Code? The in-app setup at Settings → Access Keys generates a ready-made prompt you can paste into your tool, and it will install tracking for you.

​
What gets collected

  • Page views — every page a visitor sees, including client-side route changes in single-page apps
  • Session recordings — replays of what visitors did on each page (input values are masked by default)
  • Visitor context — referrer, device type, browser, and operating system, attached to every event
Once the script is live, data appears on your Overview within minutes. Every visitor gets a user record automatically — anonymous until you identify them.