In dieser Anleitung erfahren Sie, wie Sie die Google Analytics-Messung für eine Single-Page-Anwendung (SPA) mit Google Tag Manager einrichten. Sie lernen, wie Sie Ihre Google Analytics-Property konfigurieren, die erforderlichen GTM-Variablen aktivieren und Tags erstellen, die bei Verlaufsänderungen ausgelöst werden.
Hinweis
Für diese Anleitung wird Folgendes vorausgesetzt:
- Ein Google Analytics-Konto und eine Google Analytics-Property.
- Ein Google Tag Manager Container, der in Ihrer SPA installiert ist.
- Mindestens die Rolle „Bearbeiter“ für Google Analytics und Google Tag Manager.
Schritt 1: GA4-Datenstream vorbereiten
Wenn Sie page_view-Ereignisse in einer SPA manuell erfassen möchten, müssen Sie zuerst automatische seitenverlaufsbasierte Seitenaufrufe in GA4 deaktivieren, um doppelte Zählungen zu vermeiden.
- Öffnen Sie Google Analytics.
- Klicken Sie auf der Seite Verwaltung unter Datenerhebung und ‑änderung auf Daten streams.
- Wählen Sie Ihren Web-Datenstream aus.
- Klicken Sie unter Optimierte Analysen auf das Einstellungssymbol
.
- Deaktivieren Sie unter Seitenaufrufe > Erweiterte Einstellungen anzeigen die Option Seitenänderungen basierend auf Browserverlaufsereignissen.
- Klicken Sie auf Speichern.
Schritt 2: Integrierte Verlaufsvariablen in Tag Manager aktivieren
Wenn Sie verlaufsbasierte Trigger oder Variablen in GTM verwenden möchten, müssen Sie zuerst die integrierten Verlaufsvariablen aktivieren.
- Öffnen Sie Google Tag Manager.
- Gehen Sie in Ihrem Arbeitsbereich zu Variablen.
- Klicken Sie unter Integrierte Variablen auf Konfigurieren.
- Aktivieren Sie im Bereich Verlauf die folgenden Variablen:
History New URL FragmentHistory Old URL FragmentHistory New StateHistory Old StateHistory Source
- Schließen Sie den Konfigurationsbereich.
Schritt 3: Trigger für Verlaufsänderungen erstellen
Erstellen Sie als Nächstes einen Trigger, der immer dann ausgelöst wird, wenn in Ihrer SPA ein Ereignis für Verlaufsänderungen (z. B. pushState oder replaceState) auftritt.
- Gehen Sie in Ihrem Tag Manager-Arbeitsbereich zum Menü Trigger.
- Klicken Sie auf Neu.
- Wählen Sie unter Triggerkonfiguration den Trigger Verlaufsänderung aus.
- (Optional) Wenn Sie nur bestimmte Bildschirmänderungen erfassen möchten, aktualisieren Sie den Trigger so, dass er bei Einigen Verlaufsänderungen ausgelöst wird.
- Geben Sie einen Namen für den Trigger ein (z.B. „Verlaufsänderung“) und klicken Sie auf Speichern.
Schritt 4: Google-Tag erstellen
Erstellen Sie jetzt ein Google-Tag, das den Parameter page_location aktualisiert, wenn eine Verlaufsänderung auftritt.
- Klicken Sie im Menü Tags auf Neu.
- Wählen Sie unter Tag-Konfiguration die Option Google-Tag aus.
- Geben Sie Ihre Tag-ID ein (dieselbe ID, die Sie für Ihr ursprüngliches Google-Tag verwendet haben).
Fügen Sie unter Konfigurationseinstellungen die folgenden Parameter hinzu:
page_location:{{Page URL}}page_title:{{Page Title}}update:true
Geben Sie einen Namen für das Tag ein (z. B. „Google-Tag – SPA-Update“) und klicken Sie auf Speichern.
Schritt 5: Virtuelles page_view-Ereignis senden
Erstellen Sie abschließend ein GA4-Ereignis-Tag, um das tatsächliche page_view-Ereignis für jeden virtuellen Seitenaufruf zu senden.
- Klicken Sie im Menü Tags auf Neu.
- Wählen Sie unter Tag-Konfiguration die Option Google Analytics: GA4-Ereignis aus.
- Geben Sie Ihre Mess-ID ein.
- Legen Sie für Ereignisname den Wert
page_viewfest. - Wählen Sie unter Erweiterte Einstellungen > Tag-Reihenfolge die Option Tag vor GA4-Ereignis – Virtueller Seitenaufruf auslösen aus und wählen Sie das Tag Google-Tag – SPA-Update aus, das Sie in Schritt 4 erstellt haben.
- Wählen Sie unter Trigger den Trigger Verlaufsänderung aus, den Sie in Schritt 3 erstellt haben.
- Geben Sie einen Namen für das Tag ein (z. B. „GA4-Ereignis – Virtueller Seitenaufruf“) und klicken Sie auf Speichern.
Schritt 6: Einrichtung überprüfen
So prüfen Sie, ob Ihre virtuellen Seitenaufrufe korrekt erfasst werden:
- Klicken Sie in Tag Manager auf Vorschau, um den Vorschau modus aufzurufen.
- Navigieren Sie durch Ihre SPA.
- Prüfen Sie in Google Analytics
DebugView, ob für jede Bildschirmänderung ein neues
page_viewEreignis angezeigt wird. - Prüfen Sie, ob die
page_location-Werte Ihren Erwartungen entsprechen.