Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.keupera.com/llms.txt

Use this file to discover all available pages before exploring further.

The Keupera tracker is a lightweight (under 2 KB), cookieless JavaScript snippet that streams pageviews into the Analytics module. It populates the Website summary, daily traffic, top pages, referrers, devices, browsers, and geo breakdowns.

​
How it works

  • No cookies. A keupera_session_id is generated in sessionStorage and reset when the tab closes.
  • Uses navigator.sendBeacon so the request never blocks navigation; falls back to fetch on older browsers.
  • Captures URL, path, hostname, referrer, and UTM parameters automatically.
  • Skips common sensitive paths (/wp-admin, /wp-login, /admin, /.env, /.git).

​
Get your Tracking API key

1

Open API Keys

Go to Account → API Keys in your dashboard.
2

Generate a 'Tracking' key

Click Create API key and choose the Tracking scope. Tracking keys are restricted — they can only send analytics events, never read or mutate other data, so it’s safe to expose them in client-side HTML.
Never embed a Full Access (sk_live_...) key in your website’s HTML. Always use a Tracking scoped key for the pixel.

​
Install on any website

Paste this snippet just before </head> on every page you want to track: 
<!-- Keupera Analytics -->
<script>
  window.KEUPERA_API_KEY = "YOUR_TRACKING_API_KEY";
</script>
<script src="https://zone-2.cdn.keupera.com/public/scripts/analytics/tracker.js" async defer></script>
<!-- End Keupera Analytics -->
That’s the whole install. The script self-initialises on DOMContentLoaded and fires a pageview event automatically.

​
Platform-specific install

Install the Keupera Connector plugin. It injects the snippet into wp_head automatically when Enable Website Analytics is on (default). The plugin uses your Tracking key if provided, otherwise it falls back to the connected Full Access key.
Install the Keupera plugin from the Framer marketplace and paste your Tracking key. The plugin handles the snippet injection.
Add the following to your root layout (app/layout.tsx). Set NEXT_PUBLIC_KEUPERA_TRACKING_KEY in your .env.local.
<!-- Place in your root <head> -->
<script>
  window.KEUPERA_API_KEY = process.env.NEXT_PUBLIC_KEUPERA_TRACKING_KEY;
</script>
<script
  src="https://zone-2.cdn.keupera.com/public/scripts/analytics/tracker.js"
  async
  defer
></script>
Or use next/script — set window.KEUPERA_API_KEY in a beforeInteractive Script and load the tracker with strategy="afterInteractive".
Add the snippet in Site Settings → Custom Code → Header. The exact path varies per builder but every modern site builder supports a global <head> injection field.

​
Custom events (optional)

After the tracker loads, window.keupera.track(eventName, properties) is available for custom events: 
window.keupera?.track("signup_clicked", { plan: "pro" });
Custom events show up in the Analytics → Events view alongside pageviews.

​
Verify the install

  1. Open your live site in a new browser tab.
  2. Open DevTools → Network and filter by track. You should see a POST to https://sqnxgokfnvdglftrgekd.supabase.co/functions/v1/track returning 204.
  3. In Keupera, open Analytics → Website Summary. New sessions appear within ~30 seconds.
If you see Keupera Analytics: API Key not found in the console, the window.KEUPERA_API_KEY assignment ran after the tracker — make sure the key <script> block sits before the tracker <script> tag.