Mit der Messung der Seitenaufrufe können Sie ermitteln, wie oft eine bestimmte Seite Ihrer Website aufgerufen wurde. Seiten entsprechen oft einem kompletten HTML-Dokument, können aber auch dynamisch geladene Inhalte umfassen. Dies wird als „virtuelle Seitenaufrufe“ bezeichnet.
In diesem Leitfaden wird erläutert, wie Sie die Messung von Seitenaufrufen mit analytics.js implementieren.
Überblick
Das JavaScript-Tag enthält einen Befehl zum Erstellen eines Tracker-Objekts und einen Befehl zum Senden eines Seitenaufrufs an Google Analytics. Wenn der Tracker erstellt wird, werden einige der Felder basierend auf dem Browser-Kontext festgelegt. Das Feld title wird auf den Wert document.title gesetzt und das Feld location auf den Wert document.location gesetzt, wobei der Ankerteil der URL ignoriert wird.
Bei Ausführung des Befehls send werden die im Tracker gespeicherten Felder title und location gesendet. Anhand dieser Werte wird in Google Analytics angezeigt, welche Seiten Ihre Nutzer besucht haben.
Der Standard-Tracker legt das Feld page nicht fest. Wenn Sie es jedoch manuell festlegen, wird dieser Wert als Seitenpfad in Berichten verwendet und der Wert des Felds location wird überschrieben.
Implementierung
Seitenaufruftreffer können mit dem Befehl send unter Angabe des hitType pageview gesendet werden. Der Befehl send hat die folgende Signatur für den Treffertyp pageview:
ga('send', 'pageview', [page], [fieldsObject]);
Seitenaufruffelder
In der folgenden Tabelle sind die wichtigsten Felder für die Messung von Seitenaufrufen zusammengefasst. Weitere Details (und einige zusätzliche Felder) finden Sie in der Feldreferenz im Abschnitt Inhaltsinformationen.
| Feldname | Werttyp | Erforderlich | Beschreibung |
|---|---|---|---|
title |
Text | nein | Titel der Seite (z.B. Startseite) |
location |
Text | nein * | URL der Seite. |
page |
Text | nein * | Der Pfadteil einer URL. Dieser Wert muss mit einem Schrägstrich (/) beginnen. |
*
Obwohl weder das Feld page noch das Feld location erforderlich ist, muss eines davon vorhanden sein. Andernfalls ist der Treffer ungültig.
Beispiele:
Mit dem folgenden Befehl wird ein Treffer für einen Seitenaufruf an Google Analytics gesendet. Er enthält den Pfad der aktuellen Seite.
ga('send', 'pageview', location.pathname);
Wie bei allen send-Befehlen können die in den Convenience-Parametern übergebenen Felder auch im fieldsObject angegeben werden. Der obige Befehl könnte so umgeschrieben werden:
ga('send', {
hitType: 'pageview',
page: location.pathname
});
Seiten-URLs ändern
Manchmal unterscheidet sich die URL, die Sie an Google Analytics senden möchten, von der URL, die in der Adressleiste des Browsers des Nutzers angezeigt wird. Stellen Sie sich beispielsweise eine Website mit einigen Seiten vor, auf denen sich Nutzer anmelden und ihre persönlichen Daten anzeigen/bearbeiten können. Wenn diese Website separate Seiten für personenbezogene Daten, Kontoinformationen und Benachrichtigungseinstellungen hat, sehen die URLs dieser Seiten in etwa so aus:
/user/USER_ID/profile/user/USER_ID/account/user/USER_ID/notifications
Wenn Sie beispielsweise wissen möchten, wie viele Personen die einzelnen Seiten insgesamt besuchen, wird das erschwert, wenn Sie in den URLs einen Wert für die eindeutige Nutzer-ID angeben.
Zur Lösung dieses Problems können Sie einen page-Wert ohne die User-ID angeben:
// Checks to see if the current user's userID is
// found in the URL, if it is, remove it.
// (Note, this assume the user ID is stored
// in a variable called `userID`)
if (document.location.pathname.indexOf('user/' + userID) > -1) {
var page = document.location.pathname.replace('user/' + userID, 'user');
ga('send', 'pageview', page);
}
Dadurch werden für alle Nutzer die folgenden page-Werte gesendet:
/user/profile/user/account/user/notifications
Falls von der aktuellen Seite auch andere Treffer (z. B. Ereignisse) gesendet werden, müssen Sie sicherstellen, dass jeder Treffer mit der richtigen URL gesendet wird. In solchen Fällen sollten Sie das Feld page auf dem Tracker aktualisieren, anstatt es im Befehl send zu übergeben.
Wenn Sie ihn im Tracker festlegen, wird der neue Wert page für alle nachfolgenden Treffer verwendet:
if (document.location.pathname.indexOf('user/' + userID) > -1) {
var page = document.location.pathname.replace('user/' + userID, 'user');
// Sets the page value on the tracker.
ga('set', 'page', page);
// Sending the pageview no longer requires passing the page
// value since it's now stored on the tracker object.
ga('send', 'pageview');
}
Tracking virtueller Seitenaufrufe
Viele Websites laden Inhalte heute dynamisch über AJAX, ohne dass für jede „Seite“ eine vollständige Seite geladen werden muss. Derartige Websites werden im Allgemeinen als Single Page Applications (SPAs) bezeichnet.
Wenn die Seiteninhalte auf Ihrer Website dynamisch geladen und die URL des Dokuments aktualisiert wird, sollten Sie zusätzliche Seitenaufrufe senden, um diese „virtuellen Seitenaufrufe“ zu messen. Umfassende Informationen zur Implementierung finden Sie im Leitfaden zum Tracking von Single-Page-Anwendungen mit analytics.js.