Install the Script

Add one script tag to your site. Under 2KB. No cookies. Takes two minutes.

Sign Up and Create a Site

Create an account, then add your site in the dashboard. You'll get a unique site token.

Add the Script

Pick your platform below. Replace YOUR_SITE_TOKEN with the token from your dashboard.

On WordPress? Skip the picker — grab the plugin

v1.0.0 · GPL · Upload via Plugins → Add New, paste your token, done.

Pick your platform for tailored install instructions:

See Your Data

Pageviews show up in your dashboard in real-time. No setup delay, no waiting for “yesterday’s data.”

Script Configuration

Control behavior via data-* attributes on the script tag. All are optional except data-site.

Attribute	Purpose	Default
`data-site`	Your site token (required)	`—`
`data-endpoint`	Custom API endpoint (for proxying)	`Auto`
`data-domain`	Root domain for subdomain tracking	`Auto`
`data-allowed-domains`	Comma-separated domains for cross-domain tracking	`None`
`data-allow-localhost`	Track on localhost for dev testing	`false`
`data-hash`	Track URL hash changes as pageviews	`false`
`data-exclude-paths`	Comma-separated paths to ignore (supports * wildcard)	`None`
`data-no-spa`	Disable SPA route change detection	`false`

Example: Full configuration

<script defer
  data-site="YOUR_SITE_TOKEN"
  data-allow-localhost="true"
  data-hash="true"
  data-exclude-paths="/admin/*,/internal/*"
  src="https://pulsetower.ai/embed.js"
></script>

Excluding Traffic

Path exclusion

Add data-exclude-paths to skip specific paths. Supports * wildcards.

data-exclude-paths="/admin/*,/internal,/debug/*"

Self-exclusion (for your own visits)

Open your browser console on your site and run:

localStorage.pulse_ignore = "true"

This stops all tracking in that browser. Remove it with localStorage.removeItem("pulse_ignore").

IP blocking

Block IP ranges in your site's Settings tab using CIDR notation (e.g. 192.168.1.0/24).

Cross-Domain Tracking

Track visitors across separate domains (e.g. marketing.com and app.io) as a single session. The script passes a visitor ID through URL parameters automatically.

Setup

Install the same script with the same data-site token on both domains.
Add data-allowed-domains listing the other domain(s).

<!-- On marketing.com -->
<script defer
  data-site="YOUR_TOKEN"
  data-allowed-domains="app.io"
  src="https://pulsetower.ai/embed.js"
></script>

<!-- On app.io -->
<script defer
  data-site="YOUR_TOKEN"
  data-allowed-domains="marketing.com"
  src="https://pulsetower.ai/embed.js"
></script>

When a visitor clicks a link to the other domain, the script appends a visitor ID parameter. The receiving script reads it and cleans the URL. No cookies involved.

Scroll & Click Goals

Track when users see or click specific elements — no JavaScript needed. Just add data attributes to your HTML.

Scroll tracking

Fire an event when an element scrolls into view.

<!-- Fire "pricing_seen" when 50% visible -->
<section data-pulse-scroll="pricing_seen">
  ...
</section>

<!-- Fire "cta_visible" after 2s of 80% visibility -->
<div
  data-pulse-scroll="cta_visible"
  data-pulse-scroll-threshold="0.8"
  data-pulse-scroll-delay="2000"
>
  ...
</div>

Click goals

Track clicks on any element with optional properties.

<!-- Track "signup_click" -->
<button data-pulse-goal="signup_click">
  Sign Up
</button>

<!-- Track with properties -->
<a
  data-pulse-goal="plan_select"
  data-pulse-goal-plan="pro"
  data-pulse-goal-interval="annual"
  href="/checkout"
>
  Choose Pro
</a>

Common Questions

Does this add cookies to my site?

No. Pulse Tower uses zero cookies, zero IP storage, and zero fingerprinting. No cookie banner needed.

How big is the script?

Under 3KB. It uses sendBeaconso it doesn't block page load.

Can I use this with a single-page app?

Yes. The script automatically detects SPA route changes by wrapping pushState and replaceState. For hash-based routers, add data-hash="true".

How do I exclude my own visits?

Open your browser console and run localStorage.pulse_ignore = "true". All tracking stops in that browser.

I'm on WordPress — do I really need to edit theme files?

No. Download our official WordPress plugin, upload it via Plugins → Add New → Upload Plugin, activate, and paste your site token in Settings → Pulse Tower. Admins are excluded by default so your own visits don't skew analytics.

Can I track across subdomains?

Yes. Use the same data-site token on every subdomain. Since Pulse Tower is cookieless, subdomain tracking works automatically.