Single-page apps
Client-side routing is tracked without extra code. The script hooks into the History API:
history.pushState, which routers call when you navigate to a new page.- The
popstateevent, fired by the back and forward buttons.
history.replaceState is not tracked. Routers use it to rewrite the current URL in place, for example to update a filter in the query string, and those calls are not new pageviews.
When a pageview is sent
A pageview is sent only when the path or the query string changes. Changing only the #hash sends nothing, and pushing the same URL twice sends one pageview.
The referrer is sent with the first pageview of a page load only. Route changes after it carry no referrer, so they stay in the same channel as the landing.
Sessions
Pageviews from the same visitor belong to one session until there are 30 minutes without an event. See How attribution works.
Frameworks
This covers Next.js, Nuxt, SvelteKit, Remix, React Router, Vue Router and Astro view transitions, since all of them navigate with pushState. Load the script once in the root layout. See Framework guides.