Troubleshooting

No browser events

1. Is v5.js loading? Check the network tab for /js/v5.js and POST /api/event (202).
2. Did you set localStorage.v5_ignore while testing?
3. Does data-domain match the site you created?
4. If you vendored the script, did you set data-api?
5. Ad blockers: the path /js/v5.js is short on purpose. A filter list that blocks plausible will not match it, but a generic "analytics" list might.

No crawlers

1. Middleware installed and deployed? v5.js cannot see GPTBot.
2. Matcher excluding the pages crawlers hit?
3. Simulate: curl -A "GPTBot" https://your.site/.
4. Confirm /api/hit returns 202, not 404.

404 unknown site

The domain on the event / hit is not in sites. Create it in the dashboard. www vs apex is the usual mismatch.

Empty insights

V5_LLM_PROVIDER is none, or Ollama is down (OLLAMA_HOST). Insights also need rollups — a brand-new site has nothing to say.

Double-counted humans

You set recordHumans: true and loaded v5.js. Pick one path for browsers. recordHumans.