Skip to main content
Zenovay
Free5 minutesBeginner

My first event hasn't appeared — what's wrong?

A 60-second checklist to diagnose why your first Zenovay event isn't showing up: tracking code mismatch, ad blocker, CSP, localhost, and more.

troubleshootinginstallfirst-eventdebugmissing-data
Last updated:

If you installed the Zenovay tracker and your first visit isn't appearing in the Live tab after 30-60 seconds, work through this checklist in order.

1. Are you watching the right place?

The Live tab updates in real time. The main dashboard charts have a 1-2 minute aggregation lag — a brand-new event won't show up there yet. Always verify install on the Live tab first.

2. Did the script actually load?

Open your site in an incognito window, hit F12 to open DevTools, go to the Network tab, and filter for zenovay.

You should see two requests:

  • z.js — the tracker script itself, status 200
  • A request to api.zenovay.com/track (or api.zenovay.com/event) — status 204

If z.js is missing, the script tag never executed. If it returns a 404, the URL is wrong (it should be exactly https://api.zenovay.com/z.js).

3. Is the tracking code correct?

In your dashboard, go to Settings → Tracking Code and copy the value. It looks like zv_abc123xyz. Compare it character-for-character with the data-tracking-code attribute on your <script> tag.

A common mistake is pasting a placeholder like YOUR_TRACKING_CODE and forgetting to replace it.

4. Is an ad blocker eating the request?

uBlock Origin, AdGuard, Brave Shields, and most major privacy extensions do not block Zenovay by default — but a custom block list might. Test by:

  • Disabling extensions for that site, or
  • Using a different browser, or
  • Loading the site on your phone over mobile data

If the event appears with the blocker disabled, the install is fine — your visitors will just have slightly lower numbers reported. Consider first-party tracking (Pro plan) for ad-blocker resistance.

5. Are you testing on localhost?

By default the tracker skips events on localhost and 127.0.0.1. To enable local testing, add data-allow-localhost="true" to the script tag.

6. Does your CSP block the tracker?

If your site uses a Content-Security-Policy header, both directives must allow api.zenovay.com:

script-src ... https://api.zenovay.com;
connect-src ... https://api.zenovay.com;

Look for CSP errors in the browser console — they're explicit about which directive blocked the request.

7. Has your visitor signaled GPC or DNT?

If Sec-GPC: 1 or DNT: 1 is set in your test browser, Zenovay deliberately drops the event server-side. Test in a browser without privacy extensions or with GPC turned off.

8. Did your tracking code get rotated?

If you regenerated your tracking code in the dashboard, the old code stops accepting events. Update the script tag and re-deploy.

Still nothing?

Was this article helpful?