One-page-applicaties (SPA’s)

Is je site een single-page-applicatie — React, Vue, Angular of een ander framework waarin navigatie client-side gebeurt zonder dat de pagina volledig opnieuw laadt — dan moet Personyze expliciet worden ingesteld om die routewijzigingen te volgen. Anders ziet de hele SPA er voor Personyze uit als één paginaweergave, en gaat personalisatie die van de URL/route afhangt bij latere navigaties niet af.

SPA-modus inschakelen

Ga naar Accountinstellingen → Algemene instellingen → Trackerinstellingen en zet de schakelaar Single Page Application op Aan.

Zodra het aan staat, doet elke URL-wijziging in je SPA het volgende:

• Voegt een nieuw item toe aan de geschiedenis van paginaweergaven van de bezoeker
• Beoordeelt de doelgroepmatches opnieuw voor de nieuwe URL/route
• Vervangt eerdere placeholdercontent die aan de paginaweergave gebonden is door content voor de nieuwe route
• Activeert het volgen van doelen en andere regels die van de URL afhangen

Hoe detectie werkt

Personyze luistert naar de standaardsignalen voor SPA-navigatie — history.pushState, history.replaceState, en popstate events. De meeste moderne frameworks (React Router, Vue Router, client-side navigatie in Next.js) sturen die correct. Gebruikt je framework routing op basis van hashes (URL’s met#/route ), dan volgt Personyze die ook.

Controleren of SPA-tracking werkt

1. Open de ontwikkelaarstools, het netwerktabblad, en filter op counter.personyze.com.
2. Navigeer binnen je SPA zonder volledig opnieuw te laden (klik op een interne link).
3. Je zou een nieuw verzoek moeten zien afgaan naar counter.personyze.com met de nieuwe URL.
4. Ga in de Personyze-admin naar Livebezoeken en controleer of beide URL’s in de geschiedenis van je testsessie staan.

Tracking over domeinen

SPA-modus staat los van tracking over domeinen, maar ze gaan vaak samen. Bewegen je bezoekers tussen meerdere domeinen in je account (bijv. van marketing.brand.com naar app.brand.com), zet dan beide aan — zie de handleiding voor tracking over domeinen voor die installatie. Samen zorgen SPA-modus en tracking over domeinen ervoor dat één bezoeker op elke route van elk domein aan één Personyze-profiel wordt gekoppeld.

Problemen oplossen

• Personalisatie wordt niet bijgewerkt bij een routewijziging. Controleer of de SPA-modus aan staat, en daarna of de targeting van je campagne het nieuwe URL-patroon omvat (niet alleen de URL waarop werd geland).
• Opgeblazen aantallen paginaweergaven. Sommige SPA’s roepen pushState aan voor dingen die geen navigatie zijn (modals openen, tabbladen wisselen). Zie je verdacht hoge aantallen paginaweergaven, controleer dan je routingcode of neem contact op met support — we kunnen URL-filters instellen die specifieke patronen negeren.
• Doelen gaan niet af. Doelen die zijn gedefinieerd als “URL bevat X” gaan nu af op elke SPA-route die overeenkomt. Is dat te ruim, voeg dan een specifiekere URL-voorwaarde toe.