Installation
Wie messe ich eine Single-Page-App?
Mit automatischen Seitenaufrufen (autoPageviews, voreingestellt) zählt das SDK auch Seitenwechsel ohne Neuladen selbst: Es bemerkt jede Adressänderung über pushState, replaceState und die Zurück-Taste. Selbst rufst du metrunio.page() nur auf, wenn dein Router die Ansicht wechselt, ohne die Adresse zu ändern, oder wenn du autoPageviews abgeschaltet hast.
Was tun, wenn Seitenwechsel ohne Neuladen nicht gezählt werden?
- 01Das Snippet oder GTM-Tag wie gewohnt einmalig im Layout einbinden.
- 02autoPageviews eingeschaltet lassen. Dann misst das SDK den ersten Seitenaufruf und jeden weiteren, bei dem sich die Adresse ändert.
- 03Wechselt dein Router Ansichten, ohne die Adresse zu ändern, rufe dort metrunio.page() auf. Bei eingeschaltetem autoPageviews nicht zusätzlich bei jeder Adressänderung: Sonst kann derselbe Seitenaufruf zweimal zählen.
- 04Conversions weiterhin über metrunio.conversion() oder serverseitig melden.
- 05Zielschritte einer Anwendung über metrunio.goal() melden, nach einem einmaligen metrunio.identify() beim Anmelden und nicht bei jedem Routenwechsel. Ein zweiter Aufruf desselben Schritts zählt nicht noch einmal.
Achtung
Rufe init() nicht bei jedem Routenwechsel erneut auf. Das SDK meldet dann DOUBLE_INIT. Ein einziger init-Aufruf je Seitenladung genügt.
Zuletzt geprüft am 12.10.2026
Ebenfalls gefragt
- React Router Tracking
- SPA Pageviews
- Vue oder Next.js einbinden
Weiterführende Artikel
- Welche Funktionen hat das Tracking-SDK?
Welche JavaScript-Aufrufe stehen mir zur Verfügung?
Das SDK stellt init, setConsent, page, track, identify, conversion, goal und reset bereit, dazu paymentReference für Stripe und PayPal, fillForm für Formulare sowie renderSurvey und survey für die Nachkauf-Frage. Es lädt asynchron, sammelt Aufrufe vor dem Laden in einer Warteschlange und sendet Events gebündelt.
- Wie baue ich das Code-Snippet ein?
Wie installiere ich Metrunio ohne Tag Manager?
Der fertige Codeblock steht im Portal unter „Einrichtung → Snippet“ und enthält Site-ID und Collector-Adresse. Den Schreibschlüssel siehst du nur einmal, beim Anlegen; ist er nicht mehr bekannt, steht im Code der Platzhalter DEIN_WRITE_KEY, und daneben erzeugst du mit einem Klick einen neuen. Der Block gehört unmittelbar vor das schließende head-Tag und lädt asynchron.
- Wie melde ich einen Zielschritt?
Wie sende ich die Schritte meines Funnels aus Browser oder Backend?
Im Browser mit
metrunio.identify(userId)einmal nach der Anmeldung und dannmetrunio.goal('schluessel')je Schritt; aus dem Backend mitPOST /v1/server/eventsund einem Ereignis vom Typgoalmitgoal_keyunduser_id. Beide Wege sind gleichwertig; ein Schritt ohne Kundenkennung wird abgelehnt.