No events are showing up. What now?

Open DevTools Console and Network. Filter for script.js and /api/event. If they are blocked:csp, your Content Security Policy is blocking admaxxer.com — see /documentation/troubleshoot/csp. Also double-check that data-website-id matches the ID shown in your dashboard.

Events show up in staging but not production.

Confirm data-domain matches the production hostname exactly (no protocol, no trailing slash). Also confirm the website's Allowed Domains list in settings includes the prod domain.

My site is a single-page app — am I missing pageviews?

Use script.hash.js if you rely on location.hash routing. Otherwise the default script.js already hooks history.pushState/replaceState and tracks SPA navigations.

Install Admaxxer on HTML Script Tag | Admaxxer AI Analytics Docs

Install Admaxxer on HTML Script Tag

Paste one tag into your .

The script tag is the universal way to install Admaxxer. If your platform lets you edit the site head (or inject custom HTML), you can install in under a minute. No build step, no dependencies. Building a custom-website SaaS with signups, free trials, and recurring revenue? See the SaaS install guide for the end-to-end funnel wiring.

Steps

1 Copy your website ID

In the Admaxxer dashboard, open Sites and copy the website ID for the site you want to track. Note your canonical domain too (e.g. example.com, no protocol).
2 Paste the snippet into your <head>

Add the tag below to the <head> of every page. Replace YOUR_WEBSITE_ID and yourdomain.com with your real values.

html
```
<script defer
  data-website-id="YOUR_WEBSITE_ID"
  data-domain="yourdomain.com"
  src="https://admaxxer.com/js/script.js"></script>
```
3 Pick a variant (optional)

Four script variants are available on the same CDN path: script.js (default, cookie-based), script.hash.js (SPA hash routing), script.cookieless.js (no cookies, GDPR-safe, honors DNT), script.plus.js (auto-captures outbound clicks, downloads, 404s, form submits, rage clicks). Self-host via script.local.js with data-proxy-origin.
4 (SaaS sites) Wire up signups, identifies, and trials

For custom-website SaaS like signup → trial → paid conversion: (1) Fire a goal when the signup form posts: <button data-admx-goal="Signup"> on the submit button (zero JS), or call window.admaxxer('Signup', { plan, source }) in your form-submit handler. (2) Identify the user post-signup: window.admaxxer.identify(userId, { email, plan }) — this stitches the anonymous visitor to the now-identified account so all downstream revenue events are attributed correctly. (3) Fire trial events from your server when you create the Stripe subscription: window.admaxxer('Trial Started', { plan, trial_end }). See the full SaaS install guide for the end-to-end flow.
5 Verify the install

Load any public page on your site in a fresh browser tab. Within a few seconds, the Admaxxer dashboard realtime view should show the event. If nothing lands after 2 minutes, re-check the snippet is actually in the rendered HTML <head> (View Source, not just DevTools).

Troubleshooting

No events are showing up. What now?: Open DevTools Console and Network. Filter for script.js and /api/event. If they are blocked:csp, your Content Security Policy is blocking admaxxer.com — see /documentation/troubleshoot/csp. Also double-check that data-website-id matches the ID shown in your dashboard.
Events show up in staging but not production.: Confirm data-domain matches the production hostname exactly (no protocol, no trailing slash). Also confirm the website's Allowed Domains list in settings includes the prod domain.
My site is a single-page app — am I missing pageviews?: Use script.hash.js if you rely on location.hash routing. Otherwise the default script.js already hooks history.pushState/replaceState and tracks SPA navigations.

Steps

1 Copy your website ID

2 Paste the snippet into your <head>

3 Pick a variant (optional)

4 (SaaS sites) Wire up signups, identifies, and trials

5 Verify the install

Verify installation

Troubleshooting

Related install guides