WordPress Plugin
Install and configure Pulse Analytics on WordPress without touching code.
The Pulse Analytics plugin handles script installation, proxy routing, and frustration tracking configuration directly from your WordPress admin. No theme editing required.
Installation
- In your WordPress admin, go to Plugins → Add New.
- Search for Pulse Analytics.
- Install and activate the plugin.
- Navigate to Settings → Pulse to configure.
Settings reference
| Setting | Default | Description |
|---|---|---|
| Domain | auto-detected | Your domain as registered in Pulse. Auto-detected from site_url(), but override here if they differ. |
| Enable Proxy | ON | Route the tracking script and API calls through your WordPress server (see below). |
| Frustration Tracking | OFF | Load the rage click / dead click extension script. |
| Track Admins | OFF | Track pageviews from logged-in administrators. Disable to keep dev traffic out of analytics. |
| API URL | https://pulse-api.ciphera.net | Advanced — only change if you are self-hosting the Pulse backend. |
| Script URL | https://js.ciphera.net/script.js | Advanced — only change if you are self-hosting the Pulse backend. |
Proxy mode
When Enable Proxy is on, the plugin:
- Generates a randomised REST API path on your WordPress domain (e.g.
/wp-json/xk7f2p/collect). - Serves the Pulse script from your own domain instead of
js.ciphera.net. - Forwards analytics events from your server to the Pulse backend — visitors never connect to Pulse directly.
The script is cached locally and refreshed daily via WP Cron. Because the request appears to come from your own domain, most ad blockers and browser privacy filters do not block it.
Proxy mode requires that your server can make outbound HTTPS requests to pulse-api.ciphera.net. If your host restricts outbound connections, disable proxy mode and use direct script loading instead.
Changing the proxy path setting invalidates any previously cached script URLs. If you change it, the old path will return 404s until your visitors' caches expire. Leaving it on the auto-generated value is recommended.
Multisite
On WordPress Multisite, the plugin can be network-activated. Each subsite uses its own domain setting, which defaults to the subsite's site_url(). Configure each subsite's domain separately in Settings → Pulse per subsite.