Ereignisparameter einrichten

In diesem Leitfaden erfahren Sie, wie Sie Parameter für empfohlene Ereignisse und benutzerdefinierte Ereignisse auf Ihrer Website einrichten, um mehr Informationen zu Ihren Ereignissen zu erfassen. Informationen zum Hinzufügen von Parametern auf Artikelebene finden Sie unter E-Commerce messen.

Zielgruppe

Sie möchten über die bereits eingerichteten Ereignisse weitere Informationen zur Aktivität Ihrer Nutzer erfassen.

Sie verwenden entweder das Google-Tag (gtag.js) oder Google Tag Manager auf Ihrer Website. Wenn Sie Ereignisparameter für eine mobile App einrichten möchten, lesen Sie den Hilfeartikel Ereignisse protokollieren.


Hinweis

In diesem Leitfaden wird davon ausgegangen, dass Sie

Außerdem wird vorausgesetzt, dass Sie

  • Sie haben Zugriff auf den Quellcode Ihrer Website.
  • Mindestens die Rolle „Bearbeiter“ für das Google Analytics-Konto

Lesen Sie außerdem den Artikel Ereignisse einrichten, bevor Sie diese Anleitung lesen.

Ereignisparameter

Parameter liefern zusätzliche Informationen dazu, wie Nutzer mit Ihrer Website interagieren. Wenn sich jemand beispielsweise eines Ihrer Produkte ansieht, können Sie Parameter verwenden, die das aufgerufene Produkt beschreiben, z. B. den Namen, die Kategorie und den Preis.

Die automatisch erfassten Ereignisse und die Ereignisse für optimierte Analysen umfassen standardmäßig Parameter. Google stellt außerdem eine Reihe erforderlicher und optionaler Parameter zur Verfügung, die für jedes empfohlene Ereignis verwendet werden können. Außerdem haben Sie die Möglichkeit, bei Bedarf weitere Ereignisparameter einzufügen.

Ereignisparameter einrichten

Ereignisse haben die folgende Struktur, wobei <event_parameters> Ihre Ereignisparameter sind, die als Schlüssel/Wert-Paare geschrieben werden:

gtag('event', '<event_name>', {
  <event_parameters>
});

Dazu ein Beispiel:

gtag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

In diesem Fall gilt Folgendes:

  • app_name und screen_name sind Namen von Ereignisparametern.
  • myAppName und Home sind Ereignisparameterwerte.

Wichtig: Benutzerdefinierte Parameter registrieren

Das Senden benutzerdefinierter Parameter in Ihrem Code ist nur der erste Schritt. Damit Google Analytics Daten aus benutzerdefinierten Parametern in Standardberichten und explorativen Datenanalysen anzeigen und analysieren kann, müssen Sie sie als benutzerdefinierte Dimensionen oder Messwerte registrieren. Ohne diese Registrierung werden die Parameterdaten zwar erhoben, sind aber nicht für Berichte verfügbar.

Weitere Informationen zu benutzerdefinierten Dimensionen und Messwerten

Parameter für jedes Ereignis einrichten

In den Beispielen im vorherigen Abschnitt wird der Befehl event in einer gtag()-Funktion verwendet, um Parameter für ein Ereignis zu senden. Sie können auch den config-Befehl im Google-Tag-Snippet (im <head>-HTML-Tag) aktualisieren, um Parameter mit jedem Ereignis auf der Seite zu senden.

Mit dem folgenden Code wird der Seitentitel festgelegt und der Parameter mit jedem Ereignis auf der Seite gesendet:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());

gtag('config', 'G-XXXXXXXXXX', {
  'page_title': 'Contact Us',
  'currency': 'EUR'
});
</script>

Wenn Sie Ihrer Seite mehrere Tag-IDs hinzufügen, verwenden Sie den Befehl set für dokumentierte globale Parameter (z. B. user_id, page_title, currency), damit die Werte für alle IDs übernommen werden. Platzieren Sie den Befehl set über dem Befehl config.

gtag('set', {
  'page_title': 'Travel Destinations',
  'currency': 'USD'
});
// Place your config commands after the set command like follows
gtag('config', 'G-XXXXXXXXXX-1');
gtag('config', 'G-XXXXXXXXXX-2');
gtag('config', 'G-XXXXXXXXXX-3');

Ereignisse in Analytics ansehen

Sie können mithilfe der Berichte Echtzeit und DebugView prüfen, ob Ihre Ereignisse und Parameter richtig gesendet werden. In diesen Berichten werden Daten angezeigt, sobald sie eingehen. Bevor Sie den Bericht DebugView verwenden können, sind einige zusätzliche Konfigurationsschritte erforderlich.

Wenn Sie die Werte von benutzerdefinierten Parametern, die Sie senden, in der Google Analytics-Berichtsoberfläche (z. B. in explorativen Datenanalysen oder Standardberichten) sehen und analysieren möchten, müssen Sie sie zuerst als benutzerdefinierte Dimensionen oder Messwerte registrieren. Nachdem Sie eine benutzerdefinierte Dimension oder einen benutzerdefinierten Messwert registriert haben, kann es bis zu 48 Stunden dauern, bis die Daten in Ihren Berichten verfügbar sind.

Weitere Informationen zu benutzerdefinierten Dimensionen und Messwerten

In DebugView prüfen

Wenn Sie den Bericht DebugView verwenden, werden mit gtag('set') definierte Parameter auf alle nachfolgenden gtag('event')-Aufrufe auf der Seite angewendet. Prüfen Sie, ob der gtag('set')-Befehl vor dem Auslösen des Ereignisses ausgeführt wird. Wählen Sie dann ein Ereignis in DebugView aus und sehen Sie sich auf dem Tab Parameter die zusammengeführte Liste der Parameter an, einschließlich der global festgelegten.

Von einigen Parametern werden automatisch Daten für die vordefinierten Dimensionen und Messwerte in Google Analytics zur Verfügung gestellt. Über die Parameter für die automatisch erfassten Ereignisse und die Ereignisse für optimierte Analysen sowie die erforderlichen und optionalen Parameter, die Sie mit den empfohlenen Ereignissen weitergeben, werden die vordefinierten Dimensionen und Messwerte ausgefüllt.

Bei anderen Parametern müssen Sie benutzerdefinierte Dimensionen und Messwerte erstellen, damit Parameterwerte in Google Analytics zur Verfügung stehen.

Nächste Schritte

Benutzerdefinierte Dimensionen und Messwerte für Ihre benutzerdefinierten Ereignisparameter erstellen

Zurück
Ereignisse einrichten
Weiter
User-IDs senden