Single-Page-Anwendungen messen

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, bei denen ein HTML-Dokument einmal geladen wird. Alle zusätzlichen Inhalte werden über JavaScript APIs abgerufen.

Beispiel: Sie haben ein Formular, um Leads zu generieren. Das Formular besteht aus drei Seiten:

• Erste Seite zum Erfassen der Kundendaten
• Zweite Seite, auf der Kunden ihr Interesse an bestimmten Diensten angeben
• Dritte Seite, auf der sie sich für Webinare zu den Interessen des Kunden anmelden können

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 die Customer Journey korrekt nachvollziehen können.

Hinweis

Auf dieser Seite wird davon ausgegangen, dass Sie bereits Folgendes haben:

• Ein Google Analytics 4-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 .

Erfassung für einseitige Webanwendungen implementieren

Wenn Sie SPAs genau erfassen möchten, verwenden Sie eine der folgenden Methoden, um einen neuen virtuellen Seitenaufruf auszulösen:

• Änderungen am Browserverlauf (empfohlen): Verwenden Sie diese Option, wenn Ihre SPA die History API verwendet, insbesondere die pushState() und replaceState() Methode, um Seiten zu aktualisieren.

• Benutzerdefinierte Ereignisse: Verwenden Sie diese Option, wenn Ihre Website das DocumentFragment -Objekt verwendet, um verschiedene Seiten zu rendern.

Implementierung von Änderungen am Browserverlauf

Wenn Ihre SPA die History API verwendet, können Sie in Google Analytics optimierte Analysen aktivieren, um Seitenaufrufe automatisch basierend auf Ereignissen im Browserverlauf zu erfassen.

Optimierte Analysen in GA4 aktivieren

So erfassen Sie page_views automatisch basierend auf dem Browserverlauf:

1. Öffnen Sie Google Analytics.

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 auf die einzelnen Optionen, um sie 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.

Hinweis:Wenn die optimierten Analysen für „Seitenänderungen basierend auf Ereignissen im Browserverlauf“ aktiviert sind, wartet Google Analytics automatisch auf Ereignisse im Browserverlauf (z. B. solche, die in SPAs verwendet werden) und sendet page_view-Ereignisse. Sie müssen in Google Tag Manager keine bestimmten Variablen oder Trigger für den Browserverlauf konfigurieren, um Seitenaufrufe an GA4 zu senden.

Google Tag Manager-Trigger für Ereignisse im Browserverlauf verwenden

Wenn Sie in Google Tag Manager andere Arten von Tags basierend auf Änderungen am Browserverlauf auslösen müssen, z. B. um Daten an andere Marketingplattformen zu senden, können Sie den Trigger vom Typ „Änderung des Browserverlaufs“ verwenden.

Achten Sie beim Konfigurieren von Tags oder Variablen für die Verwendung mit dem Trigger „Änderung des Browserverlaufs“ darauf, dass Sie die richtigen integrierten Variablen verwenden, die von Google Tag Manager bereitgestellt werden:

• History New URL Fragment: Das Fragment der URL nach dem Ereignis im Browserverlauf.
• History Old URL Fragment: Das Fragment der URL vor dem Ereignis im Browserverlauf.
• History New State: Das neue Objekt für den Browserverlaufsstatus.
• History Old State: Das alte Objekt für den Browserverlaufsstatus.
• History Source: Die Quelle des Ereignisses im Browserverlauf (z. B. popstate, pushState, replaceState).

Diese integrierten Variablen müssen möglicherweise zuerst in Google Tag Manager unter Variablen > Konfigurieren aktiviert werden.

Weitere Informationen zu diesem Trigger finden Sie unter Trigger „Änderung des Browserverlaufs“.

Erfassungseinrichtung überprüfen

So prüfen Sie, ob Ihre einseitige Webanwendung Seitenaufrufe korrekt erfasst:

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

2. 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 die Parameter des page_view-Ereignisses mit dem vorherigen page_view-Ereignis, um zu prüfen, ob der Seiten-Referrer und der Seitenstandort korrekt aktualisiert wurden.

Auswirkungen auf automatische Ereignisse

Wenn Sie die Erfassung virtueller Seitenaufrufe in Ihrer SPA korrekt implementieren, werden andere automatische Ereignisse in Google Analytics entsprechend verarbeitet. Wenn virtuelle Seitenaufrufe für Bildschirmänderungen nicht erfasst werden, behandelt Google Analytics die SPA 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 Seitenaufbau zugeschrieben. So lässt sich nicht analysieren, wie viel Zeit auf einzelnen Seiten verbracht wurde.

Wenn die Erfassung virtueller Seitenaufrufe korrekt implementiert ist, gilt Folgendes:

• Das Ereignis user_engagement wird 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_engagement gesendet, in der Regel kurz bevor das Ereignis page_view für die neue virtuelle Seite verarbeitet wird.
• Andere Ereignisse wie Klicks oder Scrollen werden mit dem page_location der virtuellen Seite verknüpft, die der Nutzer gerade aufruft.

So können Sie die Nutzerinteraktion und andere Messwerte für einzelne Seiten oder Abschnitte in Ihrer SPA analysieren und so ein genaueres Bild der Customer Journey erhalten.