Single-Page-Anwendungen messen

Dieses Dokument richtet sich an Entwickler, die Seitenaufrufe in ihrer Single-Page-Anwendung mit Google Analytics erfassen möchten.

Single-Page-Anwendungen (SPAs) sind Websites, die ein HTML-Dokument einmal laden und alle zusätzlichen Inhalte über JavaScript-APIs abrufen.

Beispiel: Angenommen, Sie haben ein Formular, mit dem Sie Leads generieren möchten. Das Formular besteht aus drei Bildschirmen:

• Erster Bildschirm zum Erfassen der Kundeninformationen.
• Auf dem zweiten Bildschirm können Kunden Interesse an bestimmten Diensten bekunden.
• Auf der dritten Seite können sich Nutzer für Webinare zu ihren Interessen anmelden.

Der Schlüssel zur korrekten Erfassung von Seitenaufrufen in SPAs besteht darin, Seitenaufrufe für jeden Bildschirm zu zählen, mit dem ein Nutzer interagiert, und den Referrer der Seite richtig zu erfassen, damit Sie den Nutzerpfad korrekt nachvollziehen können.

Hinweis

Folgende Voraussetzungen sollten erfüllt sein:

• Sie haben ein Google Analytics 4-Konto und eine Property für Ihre Website. Weitere 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

Analyse von Single-Page-Anwendungen implementieren

Verwenden Sie eine der folgenden Methoden, um einen neuen virtuellen Seitenaufruf auszulösen und so eine genaue SPA-Analyse zu ermöglichen:

• Änderungen am Browserverlauf (empfohlen): Wenn Ihre SPA die History API, insbesondere die Methoden pushState() und replaceState(), zum Aktualisieren von Bildschirmen verwendet, sollten Sie diese Option auswählen.

• Benutzerdefinierte Ereignisse: Wenn auf Ihrer Website das DocumentFragment-Objekt zum Rendern verschiedener Bildschirme verwendet wird, sollten Sie diese Option nutzen.

Implementierung von Änderungen am Browserverlauf

Wenn in Ihrer Single-Page-Anwendung die History API verwendet wird, können Sie optimierte Analysen in Google Analytics aktivieren, um Seitenaufrufe automatisch anhand von Browserverlaufsereignissen zu erfassen.

Optimierte Analysen in GA4 aktivieren

So messen Sie page_views automatisch anhand des Browserverlaufs:

1. Google Analytics öffnen

2. Klicken Sie auf der Seite Verwaltung unter Datenerhebung und ‑änderung auf Datenstreams > Web.

3. Stellen Sie den Schieberegler unter Optimierte Analysen auf Ein, um alle Optionen zu aktivieren.

4. Klicken Sie, um einzelne Optionen zu bearbeiten. Klicken Sie unter Seitenaufrufe auf Erweiterte Einstellungen anzeigen. Achten Sie darauf, dass sowohl Seitenaufrufe als auch Seitenänderungen basierend auf Ereignissen im Browserverlauf aktiviert sind.

   

5. Speichern Sie die Änderungen.

Einrichtung der Analyse überprüfen

So prüfen Sie, ob Ihre Single-Page-Anwendung Seitenaufrufe richtig erfasst:

1. Aktivieren Sie den Debug-Modus für jedes Tag in Ihrer SPA-Einrichtung. Informationen zum Beobachten von Ereignissen in DebugView

2. Klicken Sie sich durch Ihre Single-Page-Anwendung. Wenn Sie auf einen neuen virtuellen Bildschirm klicken, sollte in DebugView ein neues page_view-Ereignis angezeigt werden. Vergleichen Sie die page_view-Ereignisparameter mit dem vorherigen page_view-Ereignis, um zu prüfen, ob der Seiten-Referrer und der Seitenstandort richtig aktualisiert wurden.

Auswirkungen auf automatische Ereignisse

Wenn Sie die Erfassung virtueller Seitenaufrufe in Ihrer SPA richtig implementieren, werden andere automatische Ereignisse in Google Analytics entsprechend verarbeitet. Wenn keine virtuellen Seitenaufrufe für Bildschirmänderungen erfasst werden, wird die SPA in Google Analytics als einzelne Seite behandelt, was zu verzerrten Messwerten führt.

Mit dem Ereignis user_engagement wird beispielsweise die Zeit gemessen, die ein Nutzer aktiv auf einer Seite verbringt. Ohne virtuelle Seitenaufrufe wird die gesamte Interaktionszeit dem ersten Seitenaufbau zugeordnet. Es ist dann nicht möglich, die auf einzelnen Bildschirmen verbrachte Zeit zu analysieren.

Wenn die Messung virtueller Seitenaufrufe korrekt implementiert ist:

• Das Ereignis user_engagement wird gesendet, wenn der Nutzer von einer virtuellen Seite zur nächsten wechselt.
• Die Interaktionsdauer für die vorherige virtuelle Seite wird berechnet und zusammen mit dem user_engagement-Ereignis gesendet, in der Regel kurz bevor das page_view-Ereignis für die neue virtuelle Seite verarbeitet wird.
• Andere Ereignisse wie Klicks oder Scrollvorgänge sind der page_location der virtuellen Seite zugeordnet, die der Nutzer gerade aufruft.

So können Sie das Nutzer-Engagement und andere Messwerte für einzelne Bildschirme oder Abschnitte in Ihrer SPA analysieren und erhalten ein genaueres Bild des Nutzerverhaltens.