Dieses Dokument richtet sich an Entwickler, die Seitenaufrufe in ihrer einseitigen Webanwendung mit Google Analytics erfassen möchten.
Einseitige Webanwendungen (Single-Page Applications, SPAs) sind Websites, die ein HTML-Dokument einmal laden und alle zusätzlichen Inhalte über JavaScript-APIs abrufen.
Beispiel: Sie haben ein Formular, um Leads zu generieren. Das Formular besteht aus drei Seiten: > * Auf der ersten Seite werden die Kundendaten erfasst. * Auf der zweiten Seite können Kunden ihr Interesse an bestimmten Diensten angeben. * Auf der dritten Seite können sie sich für Webinare zu ihren Interessen anmelden.
Um Seitenaufrufe von SPAs korrekt zu erfassen, müssen Sie die Seitenaufrufe für jede Seite zählen, mit der ein Nutzer interagiert, und den Seiten Referrer richtig ermitteln, damit Sie den Nutzerpfad korrekt nachvollziehen können.
Hinweis
Auf dieser Seite wird davon ausgegangen, dass Sie bereits Folgendes haben:
Ein Google Analytics-Konto und eine Property für Ihre Website. Informationen zum Einrichten von Google Analytics.
Ein Google-Tag, das auf Ihrer Website implementiert ist und ausgelöst wird, wenn die Seite zum ersten Mal geladen wird. Informationen zum Einrichten des Google Tags
Messung für einseitige Webanwendungen implementieren
Wenn Sie eine genaue Messung für einseitige Webanwendungen implementieren möchten, verwenden Sie eine der folgenden Methoden, um einen neuen virtuellen Seitenaufruf auszulösen:
Änderungen am Browserverlauf (empfohlen): Wenn Ihre einseitige Webanwendung die History API und insbesondere die
pushState()undreplaceState()Methode verwendet, um Seiten zu aktualisieren, verwenden Sie diese Option.Benutzerdefinierte Ereignisse: Wenn Ihre Website das
DocumentFragmentObjekt verwendet, um verschiedene Seiten zu rendern, verwenden Sie diese Option.
Implementierung von Änderungen am Browserverlauf
Wenn Ihre einseitige Webanwendung die History API verwendet, können Sie in Google Analytics optimierte Analysen aktivieren, um Seitenaufrufe automatisch anhand von Ereignissen im Browserverlauf zu erfassen.
Optimierte Analysen in Google Analytics aktivieren
So erfassen Sie page_views automatisch anhand des Browserverlaufs:
Öffnen Sie Google Analytics.
Klicken Sie unter Verwaltung und Datenerhebung und ‑änderung auf Datenstreams > Web.
Stellen Sie den Schieberegler unter Optimierte Analysen auf Ein, um alle Optionen zu aktivieren.
Klicken Sie auf , um einzelne Optionen zu bearbeiten. Klicken Sie unter Seitenaufrufe auf Erweiterte Einstellungen anzeigen. Aktivieren Sie sowohl Seitenaufrufe als auch Seitenänderungen basierend auf Ereignissen im Browserverlauf.
Speichern Sie die Änderungen.
Messkonfiguration überprüfen
So prüfen Sie, ob Ihre einseitige Webanwendung Seitenaufrufe korrekt erfasst:
Aktivieren Sie den Debug-Modus für jedes Tag in Ihrer Messkonfiguration für einseitige Webanwendungen. Informationen zum Beobachten von Ereignissen in DebugView.
Klicken Sie sich durch Ihre einseitige Webanwendung. Wenn Sie auf eine neue virtuelle Seite klicken, sollte in DebugView ein neues
page_view-Ereignis angezeigt werden. Vergleichen Sie diepage_view-Ereignisparameter mit dem vorherigenpage_view-Ereignis, um zu prüfen, ob der Seiten-Referrer und der Seitenstandort korrekt aktualisiert wurden.
Weitere Überlegungen für einseitige Webanwendungen
Neben dem Senden von page_view-Ereignissen sollten Sie auch die folgenden Aspekte berücksichtigen, um eine robuste Integration von einseitigen Webanwendungen in Google Analytics zu ermöglichen und die Nutzerfreundlichkeit zu verbessern:
Scrollposition verwalten
Wenn Nutzer zwischen Ansichten in einer einseitigen Webanwendung wechseln, behält der Browser in der Regel die aktuelle Scrollposition bei. Das kann dazu führen, dass Nutzer den oberen Teil der neuen virtuellen Seite nicht sehen, und sich auf das Tracking der Scrolltiefe auswirken.
Empfehlung:Setzen Sie die Scrollposition nach jeder virtuellen Seitenübergang programmatisch auf den Anfang der Seite oder des Hauptinhaltscontainers zurück.
// Example: Reset window scroll position on a route change in your SPA
window.scrollTo(0, 0);
// Or, if your content is within a specific element:
// document.getElementById('main-content').scrollTo(0, 0);
Mit dieser Änderung beginnen Nutzer oben auf der neuen Seite. So kann das Scroll-Tracking von Google Analytics das Engagement auf der neuen virtuellen Seite genau erfassen.
Zugriff auf Inhalte für Browserfunktionen ermöglichen
Wenn Nutzer Probleme mit Browserfunktionen wie der Suche auf der Seite (Strg + F) melden, die nach dem Seitenaufbau einer virtuellen Seite nicht funktionieren, kann dies darauf hindeuten, wie Ihre SPA das DOM aktualisiert.
Empfehlung:Achten Sie darauf, dass das Framework und die Routinglogik Ihrer einseitigen Webanwendung die relevanten Teile des DOM vollständig und synchron mit dem Inhalt der neuen Seite aktualisieren. Verzögert gerenderte oder im Haupt-DOM-Baum verborgene Inhalte können möglicherweise nicht sofort von der Suchfunktion des Browsers indexiert werden. Testen Sie die Suche auf der Seite nach virtuellen Navigationen, um die Zugänglichkeit von Inhalten zu bestätigen.
Auswirkungen auf automatische Ereignisse
Wenn Sie die Messung virtueller Seitenaufrufe in Ihrer einseitigen Webanwendung korrekt implementieren, werden andere automatische Ereignisse von Google Analytics entsprechend verarbeitet. Wenn virtuelle Seitenaufrufe für Seitenänderungen nicht erfasst werden, behandelt Google Analytics die einseitige Webanwendung als eine einzelne Seite, was zu verzerrten Messwerten führt.
Mit dem Ereignis user_engagement wird beispielsweise die Zeit erfasst, die ein Nutzer aktiv auf einer Seite verbringt. Ohne virtuelle Seitenaufrufe wird die gesamte Interaktionsdauer dem ersten Laden der Seite zugeschrieben. So lässt sich die Zeit, die auf einzelnen Seiten verbracht wird, nicht analysieren.
Wenn die Messung virtueller Seitenaufrufe korrekt implementiert ist, gilt Folgendes:
- Das Ereignis
user_engagementwird gesendet, wenn der Nutzer von einer virtuellen Seite zu einer anderen wechselt. - Die Interaktionsdauer für die vorherige virtuelle Seite wird berechnet und zusammen mit dem Ereignis
user_engagementgesendet, in der Regel kurz bevor das Ereignispage_viewfür die neue virtuelle Seite verarbeitet wird. - Andere Ereignisse wie Klicks oder Scrolls werden mit dem
page_locationder virtuellen Seite verknüpft, die der Nutzer gerade aufruft.
So können Sie das Nutzer-Engagement und andere Messwerte für einzelne Seiten oder Bereiche in Ihrer einseitigen Webanwendung analysieren und ein genaueres Bild des Nutzerpfads erhalten.