Sign up

Troubleshooting

The handful of things that trip people up most often.

I don't see myself in Realtime

  • Disable ad-blockers — uBlock and similar tools sometimes block analytics scripts by default.
  • Double-check the data-site ID matches your site in the dashboard.
  • Open DevTools → Network and look for a request to piqo.app/api/event.

Custom events aren't firing

  • Confirm the script has loaded first — window.piqo should be defined.
  • Check the browser console for errors thrown by your event call.
  • Wait up to 5 seconds — the collector batches writes to ClickHouse.

Stripe revenue isn't attributing

  • Make sure the cookie is being set — inspect document.cookie on your site.
  • Confirm piqo_visitor_id appears in the Stripe session metadata.
  • Verify the webhook is reaching us — check Stripe's webhook delivery log.
Still stuck? Email [email protected] with your site ID and we'll dig in.