Applications monopage – Personyze Wiki

Si votre site est une application monopage — React, Vue, Angular ou tout autre framework où la navigation se fait côté client sans rechargement complet des pages — Personyze a besoin d’une configuration explicite pour suivre ces changements de route. Sinon, toute l’application ressemble à une seule page vue pour Personyze, et la personnalisation qui dépend de l’URL ou de la route ne se déclenchera pas lors des navigations suivantes.

Activer le mode SPA

Allez dans Account Settings → General Settings → Tracker Settings et placez l’interrupteur Single Page Application sur On.

Une fois activé, chaque changement d’URL dans votre SPA :

Ajoute une nouvelle entrée à l’historique des pages vues du visiteur
Réévalue les correspondances d’audience pour la nouvelle URL ou route
Remplace le contenu d’emplacement lié à la page vue précédente par celui de la nouvelle route
Déclenche le suivi des objectifs et les autres règles conditionnées par l’URL

Fonctionnement de la détection

Personyze écoute les signaux de navigation SPA standard — les événements history.pushState, history.replaceStateet popstate . La plupart des frameworks modernes (React Router, Vue Router, navigation côté client de Next.js) les émettent correctement. Si votre framework utilise un routage par hash (URL#/route ), Personyze les suit aussi.

Conflit avec Google Tag Manager. Si vous chargez Personyze via GTM, utilisez le type de déclencheur Page vue — pas Modification de l’historique. Le déclencheur de modification de l’historique de GTM émet son propre événement de page vue, qui entre en conflit avec la détection SPA de Personyze. Voir le guide GTM pour la bonne configuration du déclencheur.

Vérifier que le suivi SPA fonctionne

Ouvrez les outils de développement, onglet Réseau, filtrez sur counter.personyze.com.
Naviguez dans votre SPA sans rechargement complet (cliquez sur un lien interne).
Vous devriez voir une nouvelle requête partir vers counter.personyze.com avec la nouvelle URL.
Dans l’administration Personyze, allez dans Activité des visiteurs en temps réel et vérifiez que les deux URL apparaissent dans l’historique de votre session de test.

Suivi inter-domaines

Le mode SPA est indépendant du suivi inter-domaines, mais les deux vont souvent de pair. Si vos visiteurs passent d’un domaine à l’autre au sein de votre compte (par ex. de marketing.brand.com à app.brand.com), activez les deux — voir le guide du suivi inter-domaines pour cette configuration. Ensemble, le mode SPA et le suivi inter-domaines garantissent qu’un même visiteur correspond à un seul profil Personyze sur chaque route de chaque domaine.

Dépannage

La personnalisation ne se met pas à jour lors d’un changement de route. Vérifiez que le mode SPA est activé, puis que le ciblage de votre campagne inclut le nouveau motif d’URL (et pas seulement l’URL d’arrivée initiale).
Nombre de pages vues gonflé. Certaines SPA déclenchent pushState pour d’autres raisons que la navigation (ouverture d’une fenêtre modale, changement d’onglet). Si vous constatez un nombre de pages vues anormalement élevé, vérifiez votre code de routage ou contactez le support — nous pouvons configurer des filtres d’URL pour ignorer certains motifs.
Les objectifs ne se déclenchent pas. Les objectifs définis comme « l’URL contient X » se déclencheront désormais sur chaque route SPA qui correspond. Si c’est trop large, ajoutez une condition d’URL plus précise.