FAQ & Troubleshooting

Answers to the questions we see most often.

Tracker

Why aren't my events showing up?

Work through this checklist in order:

Open your browser's devtools Network tab and reload the page. You should see requests going out to Produl returning a successful response on page load.
If no request is being made, verify that your Produl script tag is loading correctly and isn't blocked by a browser extension or ad blocker.
If the request is going but events don't appear, verify the data-site (or siteId prop) matches a site in your dashboard exactly.
Enable debug mode — add data-debug="1" to the script tag (or debug prop on the React component) and look for the bottom-right overlay.

How do I track events in a Single Page App?

The framework components (produl-tracker/next, /react, /vue, /remix) auto-track client-side route changes via history.pushState interception. For custom routers or edge cases, call track() manually on each route change.

Can I use Produl with a Content Security Policy?

Yes — allow-list the tracker script and API in your CSP:

text

script-src 'self' https://app.produl.tech
connect-src 'self' https://app.produl.tech

How do I exclude myself from my own analytics?

The simplest approach: open your site, run this in the devtools console, and refresh:

localStorage.setItem('_ma_disabled', '1')

The tracker checks that flag on boot and bails out if set. Clear it with localStorage.removeItem('_ma_disabled').

How do I debug the tracker?

Add data-debug="1" to the script tag, or pass debug to the framework component:

tsx

<Analytics siteId={process.env.NEXT_PUBLIC_PRODUL_SITE_ID!} debug />

A compact overlay appears in the bottom-right corner showing script status, resolved server URL, site ID, and a live log of every tracked event (pageview / event / ping).

Data & analytics

Why is my event count different from Google Analytics?

A few common reasons:

GA uses cookies + consent-dependent collection. Produl is consent-free, so blocker rates are usually different — Produl typically sees more visitors than GA in regions with heavy cookie-banner attrition.
GA deduplicates sessions more aggressively across a 30-minute window; Produl ends sessions on tab close.
Bots: both platforms try to filter bots, with different heuristics. Small discrepancies (~1-3%) on bot-heavy sites are normal.

Why is my bounce rate different from what I expect?

Produl counts a bounce when a session has exactly one pageview. No engagement-time metric is mixed in. If you expect GA4-style "engaged sessions", our bounce will read higher because we don't count 10-second-engagement rule.

How do I export my data?

Dashboards can be exported as CSV from any widget's overflow menu. Full raw export (all events for a date range) is available via the API or by request to support — open a ticket from Account → Support.

Can I self-host Produl?

Produl is a managed service and doesn't offer self-hosting out of the box. If self-hosting is a hard requirement, reach out to sales@produl.tech— we've worked with Enterprise customers on managed private deployments.

Billing

What happens if I exceed my plan limit?

Events are still accepted and counted. Your oldest sites are marked "over limit" and their dashboards lock until you upgrade or the billing cycle resets. No data is deleted for going over.

How are the event limits calculated?

Events are counted on the calendar month. The counter resets at 00:00 UTCon the first day of each month. Pings (heartbeats) don't count — only pageviews, custom events, and vitals.

Can I downgrade mid-cycle?

Yes. Downgrades take effect immediately and are prorated as a credit toward your next invoice. Data within the new plan's shorter retention window is preserved going forward.

Account & security

How do I delete a site's data?

Open Account → Support, create a ticket titled "Delete site data", and include the site ID. Deletions are processed within 30 days. See Privacy & Compliance.

I lost access to my account — what do I do?

Email support@produl.techfrom the address your account was registered under. Include your site ID(s) if possible. We'll help you recover access.

My server key leaked. Now what?

Rotate immediately

In your dashboard, go to Settings → Server keys, click the key that leaked, and Revoke. Then create a new one and update your environment variable. Revoked keys stop working immediately.

Privacy & Compliance