"}]},{"@type":"HowToStep","position":3,"name":"Pick a variant (optional)","text":"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."},{"@type":"HowToStep","position":4,"name":"Verify the install","text":"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)."}]}

Install guide · generic · ~2 min

Install Admaxxer on HTML Script Tag

Paste one script 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.

Steps

  1. 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. 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://cdn.admaxxer.com/js/script.js"></script>
  3. 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. 4 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).

Verify installation

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.