Nutzertiming mit gtag.js messen

Eine kürzere Seitenladezeit kann die Nutzerfreundlichkeit einer Website insgesamt verbessern. Auf dieser Seite wird beschrieben, wie Sie Informationen zum Nutzertiming an Google Analytics senden.

Implementierung

Verwenden Sie den Befehl event, um ein timing_complete-Ereignis zu senden:

gtag('event', 'timing_complete', {<timing_parameters>});

wobei <timing_parameters> ein oder mehrere Parameter/Wert-Paare ist. Trennen Sie die einzelnen Paare durch Kommas. Durch diesen Befehl wird beispielsweise ein Nutzertiming-Ereignis an Google Analytics gesendet, das angibt, dass es 3.549 Millisekunden gedauert hat, bis die aktuelle Webseite alle externen JavaScript-Abhängigkeiten geladen hat.

gtag('event', 'timing_complete', {
  'name' : 'load',
  'value' : 3549,
  'event_category' : 'JS Dependencies'
});

Parameter für das Nutzertiming

In der folgenden Tabelle sind die Parameter für das Nutzertiming zusammengefasst:

Parametername	Datentyp	Erforderlich	Beschreibung
name	string	Yes	Ein String zur Identifizierung der aufgezeichneten Variable (z.B. 'load').
value	integer	Yes	Die Anzahl der Millisekunden während der verstrichenen Zeit für die Berichterstellung an Google Analytics (z.B. 20).
event_category	string	Nein	Ein String zum Kategorisieren aller Nutzertiming-Variablen in logische Gruppen (z.B. 'JS Dependencies').
event_label	string	Nein	Ein String, mit dem Nutzerzeiten in Berichten flexibler dargestellt werden können (z.B. 'Google CDN').

Zeit messen

Für das timing_complete-Ereignis ist ein value-Parameter erforderlich, der die verstrichene Zeit in Millisekunden angibt. Sie müssen Code schreiben, der diesen Wert erfasst.

Am einfachsten ist es, einen Zeitstempel am Anfang eines Zeitraums und einen weiteren Zeitstempel am Ende der Periode zu erstellen. Berechnen Sie dann die Zeit, die zwischen den Zeitstempeln verstrichen ist.

Die meisten modernen Browser unterstützen die Navigation Timing API, die Methoden für das Objekt window.performance zum Messen der Leistung von Webseiten anhand von hochauflösenden Zeitdaten enthält.

Im folgenden Beispiel wird die Methode performance.now() verwendet, die die Zeit zurückgibt, die seit dem ersten Laden der Seite vergangen ist:

// Feature detects Navigation Timing API support.
if (window.performance) {
  // Gets the number of milliseconds since page load
  // (and rounds the result since the value must be an integer).
  var timeSincePageLoad = Math.round(performance.now());

  // Sends the timing event to Google Analytics.
  gtag('event', 'timing_complete', {
    'name': 'load',
    'value': timeSincePageLoad,
    'event_category': 'JS Dependencies'
  });
}

Überlegungen zur Stichprobenerhebung

In Google Analytics werden Stichproben der Zeitereignisse erhoben, um eine gleichmäßige Verteilung der Systemressourcen für diese Funktion zu gewährleisten.

Die Häufigkeit, mit der Ereignisse erfasst werden, ergibt sich aus der Gesamtzahl der Seitenaufrufe, die am Vortag für die Property erzielt wurden. In der folgenden Tabelle wird beschrieben, wie die zeitliche Abtastrate bestimmt wird:

Gesamtzahl der Seitenaufrufe (vorheriger Tag)	Maximale Anzahl der Zeitereignisse, die verarbeitet werden
0–1.000	100
1.000–100.000	10% der Gesamtzahl der Seitenaufrufe
100.000–1.000.000	10.000
Mehr als 1.000.000	1% der Gesamtzahl der Seitenaufrufe