In diesem Leitfaden wird beschrieben, wie Sie benutzerdefinierte Dimensionen und Messwerte mit analytics.js senden.
Überblick
Benutzerdefinierte Dimensionen und Messwerte sind eine effektive Möglichkeit, benutzerdefinierte Daten an Google Analytics zu senden. Webentwickler können benutzerdefinierte Dimensionen und Messwerte verwenden, um Unterschiede zwischen angemeldeten und nicht angemeldeten Nutzern, Autoren von Seiten, Levels in Spielen oder anderen Geschäftsdaten auf einer Seite zu segmentieren und zu messen.
Eine vollständige Übersicht über die Funktionsweise dieser Funktion finden Sie unter Funktionsreferenz für benutzerdefinierte Dimensionen und Messwerte.
Daten zu benutzerdefinierten Dimensionen und Messwerten werden mit einem oder beiden der folgenden Werte gesendet:
| Feldname | Werttyp | Erforderlich | Beschreibung |
|---|---|---|---|
| Dimension[0–9]+ | Text | Nein | Der Dimensionsindex. Jeder benutzerdefinierten Dimension ist ein Index zugeordnet.Es sind maximal 20 benutzerdefinierte Dimensionen (200 bei Analytics 360-Konten) zulässig. Das Indexsuffix muss eine positive Ganzzahl größer als 0 sein (z.B. „dimension3“). |
| Metrik[0-9]+ | Ganzzahl | Nein | Der Messwertindex. Jedem benutzerdefinierten Messwert ist ein Index zugeordnet. Es sind maximal 20 benutzerdefinierte Messwerte (200 für Analytics 360-Konten) zulässig. Das Indexsuffix muss eine positive Ganzzahl größer als 0 sein (z.B. Messwert5). |
Implementierung
Sie müssen zuerst eine benutzerdefinierte Dimension oder einen benutzerdefinierten Messwert über die Verwaltungsoberfläche von Google Analytics konfigurieren. Nach der Konfiguration wird der benutzerdefinierten Dimension oder dem benutzerdefinierten Messwert ein eindeutiger Index zugewiesen, mit dem eine benutzerdefinierte Dimension oder ein benutzerdefinierter Messwert identifiziert und voneinander unterschieden werden kann. Anschließend verwenden Sie den Index in der analytics.js-Bibliothek, um Daten für eine bestimmte benutzerdefinierte Dimension oder einen bestimmten benutzerdefinierten Messwert zu senden.
Daten senden
Daten zu benutzerdefinierten Dimensionen oder Messwerten dürfen nur mit einem vorhandenen Treffer gesendet werden. Um beispielsweise eine benutzerdefinierte Dimension für einen Treffer vom Typ pageview mit dem Index 15 zu senden, verwenden Sie Folgendes:
ga('send', 'pageview', {
'dimension15': 'My Custom Dimension'
});
Um einen benutzerdefinierten Messwert für einen Treffer vom Typ event mit dem Index 18 zu senden, verwenden Sie Folgendes:
ga('send', 'event', 'category', 'action', {
'metric18': 8000
});
Wenn für den benutzerdefinierten Messwert ein Währungstyp konfiguriert ist, können Sie Dezimalwerte senden:
ga('send', 'event', 'category', 'action', {
'metric19': 24.99
});
In manchen Fällen möchten Sie vielleicht eine benutzerdefinierte Dimension oder einen benutzerdefinierten Messwert mit allen Treffern auf einer bestimmten Seite (oder für die Lebensdauer des Tracker-Objekts) senden. In diesem Fall können Sie die benutzerdefinierte Dimension oder die benutzerdefinierten Messwerte mit dem Befehl set festlegen:
ga('set', 'dimension5', 'custom data');
Um Werte für eine Dimension und einen Messwert zu set, können Sie Folgendes verwenden:
ga('set', {
'dimension5': 'custom dimension data',
'metric5': 'custom metric data'
});
Im Abschnitt Benutzerdefinierte Dimensionen und Messwerte des Dokument zur Feldreferenz finden Sie Informationen dazu, wie diese Daten gesendet werden.
Beispiel
Ein gutes Beispiel für den Einsatz von benutzerdefinierten Dimensionen ist eine inhaltsbasierte Website mit vielen Autoren. Als Analysefachkraft möchten Sie vielleicht wissen, welche Autoren die beliebtesten Inhalte haben. Um diese Frage zu beantworten, könnten Sie einen Bericht aufrufen, in dem Seitenaufrufe nach Autor verglichen werden. Auch wenn in Google Analytics standardmäßig keine Autorendaten verfügbar sind, können Sie sie bei jedem Seitenaufruf als benutzerdefinierte Dimension senden.
Der erste Schritt besteht darin, eine neue benutzerdefinierte Dimension auf der Verwaltungsoberfläche zu konfigurieren. Der Name sollte author und der Bereich vom Typ hit sein. Nach der Konfiguration wird der neuen benutzerdefinierten Dimension ein Index zugewiesen. In diesem Beispiel ist der Index 5.
Nachdem die benutzerdefinierte Dimension „author“ konfiguriert und einem Index zugewiesen wurde, kann sie zusammen mit der analytics.js-Bibliothek verwendet werden, um Autorendaten als benutzerdefinierte Dimension zu senden. Wenn Ihre Seite beispielsweise in PHP geschrieben ist, wird der tatsächliche Autor der Seite wahrscheinlich in einer PHP-Variablen wie $author gespeichert. In Ihrer PHP-Vorlage können Sie diese Variable „author“ verwenden, um den Wert „author“ an die benutzerdefinierte Dimension zu übergeben:
ga('send', 'pageview', {
'dimension5': '<?=$author?>'
});