Single-Page-Applications (SPA)

Wenn Ihre Website eine Single-Page-Application ist — React, Vue, Angular oder ein anderes Framework, bei dem die Navigation clientseitig ohne vollständiges Neuladen der Seite erfolgt —, braucht Personyze eine ausdrückliche Konfiguration, um diese Routenwechsel zu erfassen. Andernfalls sieht die gesamte SPA für Personyze wie ein einziger Seitenaufruf aus, und Personalisierung, die von URL/Route abhängt, greift bei späteren Navigationen nicht.

Den SPA-Modus aktivieren

Gehen Sie zu Account Settings → General Settings → Tracker Settings und stellen Sie den Schalter Single Page Application auf On.

Sobald er aktiviert ist, bewirkt jede URL-Änderung in Ihrer SPA Folgendes:

Sie fügt dem Seitenaufrufverlauf des Besuchers einen neuen Eintrag hinzu
Sie wertet die Zielgruppenzuordnung für die neue URL/Route neu aus
Sie ersetzt frühere, auf den Seitenaufruf bezogene Platzhalterinhalte durch Inhalte für die neue Route
Sie löst das Ziel-Tracking und andere URL-abhängige Regeln aus

Wie die Erkennung funktioniert

Personyze lauscht auf die üblichen SPA-Navigationssignale — history.pushState, history.replaceStateund die Ereignisse popstate . Die meisten modernen Frameworks (React Router, Vue Router, clientseitige Navigation in Next.js) senden diese korrekt. Wenn Ihr Framework hashbasiertes Routing nutzt (URLs mit#/route ), erfasst Personyze diese ebenfalls.

Konflikt mit Google Tag Manager.Wenn Sie Personyze über GTM laden, verwenden Sie den Triggertyp Page View — nicht History Change. Der History-Change-Trigger von GTM löst ein eigenes Seitenaufruf-Ereignis aus, das mit der SPA-Erkennung von Personyze kollidiert. Die richtige Trigger-Einrichtung finden Sie in der GTM-Anleitung.

Prüfen, ob das SPA-Tracking funktioniert

Öffnen Sie die Entwicklertools, Tab Netzwerk, und filtern Sie nach counter.personyze.com.
Navigieren Sie innerhalb Ihrer SPA ohne vollständiges Neuladen (klicken Sie auf einen internen Link).
Sie sollten eine neue Anfrage an counter.personyze.com mit der neuen URL sehen.
Gehen Sie im Personyze-Admin zu Visitors Activity in Real-Time und prüfen Sie, ob beide URLs im Verlauf Ihrer Testsitzung erscheinen.

Domainübergreifendes Tracking

Der SPA-Modus ist unabhängig vom domainübergreifenden Tracking, aber beide werden oft kombiniert. Wenn Ihre Besucher zwischen mehreren Domains Ihres Kontos wechseln (z. B. von marketing.brand.com zu app.brand.com), aktivieren Sie beides — die Einrichtung finden Sie in der Anleitung zum domainübergreifenden Tracking. Zusammen sorgen SPA-Modus und domainübergreifendes Tracking dafür, dass ein einzelner Besucher über jede Route auf jeder Domain einem einzigen Personyze-Profil zugeordnet wird.

Fehlerbehebung

Die Personalisierung aktualisiert sich beim Routenwechsel nicht. Prüfen Sie, ob der SPA-Modus an ist, und dann, ob das Targeting Ihrer Kampagne das neue URL-Muster einschließt (nicht nur die ursprüngliche Einstiegs-URL).
Überhöhte Seitenaufrufzahlen. Manche SPAs lösen pushState auch für Zwecke ohne Navigation aus (Öffnen von Modals, Tab-Wechsel). Wenn Ihnen die Seitenaufrufe verdächtig hoch vorkommen, prüfen Sie Ihren Routing-Code oder kontaktieren Sie den Support — wir können URL-Filter einrichten, die bestimmte Muster ignorieren.
Ziele werden nicht ausgelöst. Ziele, die als „URL enthält X“ definiert sind, werden nun bei jeder passenden SPA-Route ausgelöst. Wenn das zu großzügig ist, fügen Sie eine genauere URL-Bedingung hinzu.