TL;DR, kort antwoord
8 min leestijdEen single-page application laadt één HTML-document en wisselt schermen met JavaScript, dus een tag die alleen bij het laden van de pagina vuurt, legt één paginaweergave vast voor het hele bezoek. SPA-tracking lost dat op met een virtuele paginaweergave bij elke routewissel, ofwel via events van de History API (de GA4-instelling "Page changes based on browser history events" luistert naar pushState, popState en replaceState) ofwel via handmatige page_view-aanroepen. Dubbeltellingen ontstaan als twee daarvan tegelijk draaien; ontbrekende paginaweergaven komen van routers die de URL niet aanraken of van paginaweergaven die worden verstuurd voordat de URL is bijgewerkt.
Wat is SPA-tracking?
In een single-page application betekent SPA-tracking dat je een virtuele paginaweergave vastlegt telkens als de app met JavaScript van scherm wisselt, omdat de browser het HTML-document één keer laadt en bij latere routewissels nooit een nieuwe pagina laadt. Google omschrijft SPA's als "websites that load an HTML document once and fetch any additional content using JavaScript APIs," en formuleert het doel helder: "The key to measuring page views from SPAs correctly is to count page views for each screen a user interacts with and get the page referrer right, so you can correctly trace the user journey."
Een virtuele paginaweergave is een paginaweergave-event dat je analyticstool verstuurt zonder dat er echt een pagina laadt. De browser vraagt nooit een nieuw document op, maar het rapport toont een nieuwe pagina met een eigen URL en verwijzer, alsof dat wel zo was.
Waarom mist een standaard analyticstag de paginaweergaven van een SPA?
Een standaard analyticstag mist de paginaweergaven van een SPA omdat hij zijn paginaweergave verstuurt wanneer het script voor het eerst draait, en in een SPA draait het script één keer per bezoek. Een bezoeker die op / binnenkomt en via links in de app /pricing en daarna /signup opent, heeft beslissingen genomen op drie schermen, terwijl een tag die alleen bij het laden vuurt één paginaweergave voor / vastlegt.
De schade reikt verder dan het aantal paginaweergaven. Google merkt op dat zonder virtuele paginaweergaven "Google Analytics treats the SPA as a single page, leading to skewed metrics," en dat "all engagement time is attributed to the initial page load, making it impossible to analyze time spent on individual screens." Klikken en scrolls worden ook onder de landings-URL geboekt. De gids over paginaweergaven vs sessies vs gebruikers legt uit waarom een laag aantal paginaweergaven per sessie in een SPA eerder een trackingsignaal is dan een gedragssignaal.
![]()
Hoe geeft de History API een routewissel door?
De History API geeft een routewissel door via methodes die je router aanroept en events die de browser afvuurt, en die twee lopen niet één op één gelijk. Door dat verschil moeten trackers op meer dan één plek luisteren.
| Wijziging | Wat het veroorzaakt | Event dat de browser afvuurt |
|---|---|---|
history.pushState() | Je router, bij een link in de app | Geen |
history.replaceState() | Je router, als hij de huidige URL herschrijft | Geen |
| Terug- of vooruitknop | De bezoeker | popstate |
history.back(), forward(), go() | Je code | popstate |
Hashwijziging (#section) | Een link of code die het fragment wijzigt | hashchange |
MDN is expliciet over de eerste twee rijen: "just calling history.pushState() or history.replaceState() won't trigger a popstate event." Een tracker die alleen naar popstate luistert, ziet klikken op terug en vooruit, maar mist elke voorwaartse navigatie via je eigen links. Trackers lossen dit op door pushState en replaceState direct te wrappen of te observeren.
Hoe trackt GA4 single-page applications?
GA4 trackt single-page applications via een instelling van verbeterde meting die een page_view verstuurt als de browsergeschiedenis verandert. Het helpcentrum van Google omschrijft de page_view-trigger als "each time the page loads or the browser history state is changed by the active site," en zegt dat de geavanceerde instelling "listens for pushState, popState, and replaceState." Google raadt deze route aan "If your SPA uses the History API, specifically the pushState() and replaceState() method to update screens."
Zo zet je het aan:
- Open Admin in Google Analytics.
- Klik onder Data collection and modification op Data streams en daarna op je webstream.
- Zet onder Enhanced measurement de schakelaar aan.
- Klik op het instellingenicoon en klik onder Page views op Show advanced settings.
- Schakel zowel Page loads als Page changes based on browser history events in.
- Sla op.
De andere route is handmatig. Google noemt "Custom events" voor sites waar schermen renderen zonder URL-wijziging, zoals een app die DocumentFragment-objecten gebruikt. In dat geval verstuur je zelf gtag('event', 'page_view', { page_title: '...', page_location: '...' }) vanuit je router.
Wat veroorzaakt dubbeltellingen bij SPA-tracking?
Dubbeltellingen bij SPA-tracking ontstaan als twee mechanismen elk een paginaweergave versturen voor dezelfde routewissel. De gebruikelijke opzetten die het veroorzaken:
- Google Tag Manager plus history-events van GA4. De waarschuwing van Google: "If you configure your tags using Google Tag Manager, don't enable automatic history tracking in Google Analytics, as this can lead to double-counting page views." Een History Change-trigger in GTM vuurt al "when the URL fragment changes or when a site uses the HTML5 pushstate API."
- Handmatige page_view-aanroepen plus de history-instelling.
send_page_view: falsestopt paginaweergaven op basis van de geschiedenis niet. Google zegt: "If Enhanced Measurement is enabled, Google Analytics will sendpage_viewevents based on browser history changes even if you setsend_page_view: false." Zet Page changes based on browser history events uit als je router zelf paginaweergaven verstuurt. - replaceState gebruikt voor filters of tabbladen. GA4 noemt replaceState bij de history-wijzigingen waar het naar luistert, dus een productlijst die
?sort=pricemetreplaceStatein de URL schrijft, kan bij elke filterwijziging paginaweergaven opleveren. Test dit in DebugView voordat je de paginatellingen op schermen met veel filters vertrouwt. - Twee Google-tags met dezelfde ID. Een hard gecodeerd gtag-fragment en een Google-tag in GTM die naar dezelfde meet-ID wijzen, versturen elk hun eigen events.
Wat veroorzaakt ontbrekende paginaweergaven bij SPA-tracking?
Ontbrekende paginaweergaven bij SPA-tracking komen van routewissels die de History API nooit bereiken, en van paginaweergaven die op het verkeerde moment worden verstuurd.
- Routers die de URL nooit wijzigen. Een app die componenten in het geheugen wisselt, geeft een history-listener niets om te horen. Gebruik de route met custom events.
- Hashrouting met een tracker die alleen naar de geschiedenis kijkt. Het wijzigen van
#/pricingvuurthashchangeaf. Controleer of je tool fragmentwijzigingen telt, en stel het in als dat niet zo is. - Paginaweergaven verstuurd voordat de URL is bijgewerkt. Een
page_viewdie vóórpushStatevuurt, legt de oudepage_locationvast. Google raadt aan in DebugView elkepage_viewte vergelijken "with the precedingpage_viewevent to check if the page referrer and page location have been updated correctly." - Verouderde verwijzers. Het voorbeeld van Google met custom events bewaart de oude URL en geeft die mee als
page_referrer, omdat de eigendocument.referrervan de browser het hele bezoek vast blijft staan op de oorspronkelijke verwijzer.
Eén verwante valkuil zit buiten de router. web.dev merkt op dat de back/forward cache "doesn't work for 'soft navigations' within a single-page app," dus een klik op terug binnen je app is een history-event, terwijl een klik op terug die vanaf een andere site naar je app terugkeert de hele pagina uit het geheugen kan herstellen zonder enig history-event af te vuren.
![]()
Hoe controleer je of SPA-tracking werkt?
Je controleert SPA-tracking door met debugmodus aan door de app te klikken en na te gaan dat elk nieuw scherm precies één paginaweergave oplevert met de juiste locatie en verwijzer. De eigen check van Google is debugmodus aanzetten, "click through your single-page application," en bevestigen dat er "a new page_view event in DebugView" verschijnt voor elk virtueel scherm. Herhaal dat daarna met de terug- en vooruitknop, een filterwijziging en een hashlink, want dat zijn de gevallen die dubbel tellen of wegvallen. De checklist om analytics te verifiëren past hetzelfde idee toe op elke tracker, en de gids over gemiddelde sessieduur laat zien wat kapotte SPA-tracking met cijfers over tijd op de site doet.
Realtime dashboard
Doelen bijhouden
Tracking zonder cookies
Twee kleinere oplossingen helpen de cijfers overeind te houden. Zet de scrollpositie bij elke routewissel terug met window.scrollTo(0, 0), zodat de scrolldiepte voor het nieuwe scherm geldt en niet voor het oude, en verstuur de paginaweergave pas nadat de router de URL en de titel heeft bijgewerkt.
Hoe gaat Flowsery om met SPA-navigatie?
Flowsery trackt SPA-navigatie automatisch, dus een routewissel in React Router of Next.js verschijnt als eigen paginaweergave zonder extra code. De docs van de npm-SDK van Flowsery noemen "pageviews, including SPA navigation" onder automatische tracking, en de FAQ over prijzen zegt dat Flowsery "counts a pageview each time a visitor loads a page on your site, including single-page app navigations." Voor apps die met URL-fragmenten routeren, heeft de npm-SDK een optie hashMode, en de scriptdocs beschrijven een versie van de tracker voor SPA's met hashrouting. Wisselt je app van scherm zonder de URL te wijzigen, dan biedt de SDK trackPageview(), zodat je er zelf een vanuit je code verstuurt. De pagina over React analytics behandelt hoe Flowsery routes aan de clientkant, custom events, funnels en omzet in React-apps meet.
Veelgestelde vragen
Wat is een virtuele paginaweergave?
Een virtuele paginaweergave is een paginaweergave-event dat wordt verstuurd zonder dat er echt een pagina laadt, gebruikt als een SPA via JavaScript van scherm wisselt. Het heeft een eigen paginalocatie en verwijzer, dus rapporten behandelen elk scherm als aparte pagina. Zonder virtuele paginaweergave verschijnt een SPA-bezoek als één lange weergave van de landingspagina.
Trackt GA4 routewissels in een SPA automatisch?
Ja, als verbeterde meting aanstaat en Page changes based on browser history events is ingeschakeld onder de geavanceerde instellingen van Page views. Die instelling luistert naar pushState, popState en replaceState. Het helpt niet bij apps die van scherm wisselen zonder de URL te wijzigen.
Waarom telt GA4 elke paginaweergave in mijn SPA dubbel?
Twee mechanismen versturen paginaweergaven voor dezelfde wijziging. De gebruikelijke paren zijn history-triggers in GTM met history-events van GA4, of handmatige page_view-aanroepen met history-events van GA4. Zet een van de twee uit; Google zegt dat send_page_view: false paginaweergaven op basis van de geschiedenis niet stopt.
Vuurt pushState popstate af?
Nee. MDN zegt dat het aanroepen van history.pushState() of history.replaceState() geen popstate-event afvuurt. Alleen browseracties zoals de terug- en vooruitknop, of aanroepen als history.back(), vuren het af.
Hoe hoort page_referrer te werken in een SPA?
Elke virtuele paginaweergave hoort de URL van het vorige scherm als verwijzer mee te krijgen. Bewaar de oude URL vóór de routewissel en geef die mee als page_referrer met de nieuwe page_location. Anders meldt elk scherm de oorspronkelijke verwijzer van de landing.
Heeft de back/forward cache invloed op SPA-tracking?
Niet bij navigatie binnen de app. web.dev zegt dat de bfcache niet werkt voor soft navigations binnen een SPA. Hij werkt wel als een bezoeker je app verlaat en met de terugknop terugkomt, wat de hele pagina uit het geheugen kan herstellen zonder nieuwe laadbeurt, als de pagina daarvoor in aanmerking komt.
Hoe zet ik SPA-tracking aan in GA4?
Open Admin, klik op Data streams, kies je webstream en zet Enhanced measurement aan. Klik daarna op het instellingenicoon, open Show advanced settings onder Page views en schakel zowel Page loads als Page changes based on browser history events in. Sla op. Deze route werkt als je router pushState en replaceState gebruikt.
Moet ik history-tracking in GA4 aanzetten als ik Google Tag Manager gebruik?
Laat het uit. Google waarschuwt dat beide gebruiken tot dubbeltellingen van paginaweergaven kan leiden. Een History Change-trigger in GTM vuurt al wanneer het URL-fragment verandert of wanneer een site de HTML5 pushstate API gebruikt.
Hoe track ik hashroutes zoals #/pricing in een SPA?
Het wijzigen van het fragment vuurt hashchange af, dus een tracker die alleen naar de History API kijkt, kan het missen. Controleer of je tool fragmentwijzigingen telt en stel het in als dat niet zo is. De npm-SDK van Flowsery heeft een optie hashMode, en de scriptdocs beschrijven een versie van de tracker voor hashrouting.
Hoe controleer ik of mijn SPA één paginaweergave per scherm verstuurt?
Zet debugmodus aan, klik door de app en zoek in DebugView naar een nieuw page_view-event voor elk scherm. Vergelijk elk met de voorgaande page_view om te bevestigen dat de paginalocatie en de verwijzer zijn bijgewerkt. Herhaal dat daarna met de terug- en vooruitknop, een filterwijziging en een hashlink.
Was dit artikel nuttig?
Laat ons weten wat je ervan vindt!
Zie ons vaker in Google
Met één klik markeer je Flowsery als voorkeursbron, zodat onze artikelen hoger staan in je Topverhalen, AI-modus en AI-overzichten.
Voordat je gaat...
Flowsery
Analytics voor je website, met omzet voorop
Volg elke bezoeker, bron en conversie in realtime. Eenvoudig, krachtig en zonder cookies.
Realtime dashboard
Doelen bijhouden
Tracking zonder cookies
Gerelateerde begrippen


Waarom je GA4-bouncepercentage gewoon het omgekeerde engagementpercentage is
Je GA4-bouncepercentage is het aandeel sessies zonder engagement. Hoe Google het definieert, hoe het verschilt van Universal Analytics en waar je het toevoegt.


Wat het rapport over landingspagina's in GA4 telt en waar het leeg blijft
Het rapport over landingspagina's in GA4 toont de eerste pagina van elke sessie. Waar je het vindt, de standaardstatistieken, waarom (not set)-rijen verschijnen en hoe je de bron toevoegt.


Hoe het bijhouden van zoekopdrachten op je site in GA4 vastlegt wat bezoekers typen
Stel zoekopdrachten op je site in GA4 in met enhanced measurement, voeg je eigen queryparameters toe, vind de dimensie Search term en volg zoekopdrachten zonder URL.


Gebruikerseigenschappen in GA4 instellen en erover rapporteren
Stel gebruikerseigenschappen in GA4 in met gtag of Tag Manager, registreer ze als aangepaste dimensies op gebruikersniveau en blijf binnen de limiet van 25 eigenschappen.


Zo koppel je Search Console aan GA4 en publiceer je de rapporten
Zo koppel je Search Console aan GA4 via Beheer, welke rollen je nodig hebt, hoe je de twee rapporten in de Bibliotheek publiceert en wat de data niet kan combineren.


Wat de bfcache doet met terugnavigaties en je aantal paginaweergaven
De bfcache, of back/forward cache, herstelt een pagina uit het geheugen bij klikken op terug en vooruit. Welke pagina's in aanmerking komen, en waarom analytics ze mist of dubbel telt.
Gerelateerde artikelen


Zo bouw je berekende statistieken in GA4 binnen een quotum van vijf plekken
Google beperkt berekende statistieken in GA4 tot 5 per standaardproperty. Leer de formulesyntaxis, de eenheden, waar ze verschijnen en wat een formule niet mag gebruiken.


Contentgroepering in GA4 instellen met één parameter
Stel contentgroepering in GA4 in met de parameter content_group in gtag of Tag Manager, lees de dimensie Content group en houd (not set)-rijen eruit.


Annotaties toevoegen in GA4 en een wijzigingslog bijhouden
In GA4 zetten Google Analytics-annotaties een gedateerde notitie op lijngrafieken. Wie ze kan toevoegen, de limieten van 60 en 150 tekens, het maximum van 1.000 en gebruik als wijzigingslog.