How does agent analytics work?
Updated
Short answer
Agent analytics reads your server logs, not a script on the page, because AI crawlers do not run JavaScript. It names the AI agent behind each request, shows which pages it fetched, and separates crawlers learning your site from fetches made to answer a live question.
How to connect it
- A generic webhook that sends your log lines to Noma.
- A Vercel log drain.
- An access log file you upload.
There is nothing to add to your pages: a tag in the page would never be run by a crawler.
Crawlers and citations
A crawler visit is a model reading your site to learn it. A citation fetch is a model retrieving your page because someone asked a question and the answer is being written now. Agent analytics records them as different events.
What to look for
- Whether the pages you wrote for AI answers are the ones being fetched.
- Important pages that no agent ever reaches.
- Which agents visit, matched on their own user-agent signatures.