Ereignisparameter einrichten

In dieser Anleitung erfahren Sie, wie Sie Parameter für empfohlene Ereignisse und benutzerdefinierte Ereignisse auf Ihrer Website einrichten, damit Sie mehr Informationen aus Ihren Ereignissen erfassen können. Informationen zum Hinzufügen von Parametern auf Artikelebene finden Sie unter E-Commerce messen.

Zielgruppe

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

Sie verwenden auf Ihrer Website entweder das Google-Tag (gtag.js) oder Google Tag Manager. Informationen zum Einrichten von Ereignisparametern für eine mobile App finden Sie unter Ereignisse protokollieren.


Hinweis

In diesem Leitfaden wird davon ausgegangen, dass Sie

Außerdem wird vorausgesetzt, dass Sie

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

Lesen Sie vor dieser Anleitung auch den Hilfeartikel Ereignisse einrichten.

Ereignisparameter

Parameter geben Aufschluss darüber, 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 Ereignis parameter 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 Werte von Ereignisparametern.

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 (in Ihrem <head> HTML-Tag) aktualisieren, um Parameter mit jedem Ereignis auf der Seite zu senden.

Mit dem folgenden Befehl 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 alle IDs die Werte übernehmen. 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 sich Ihre Ereignisse und die zugehörigen Parameter in den Berichten Echtzeit und DebugView ansehen. Beachten Sie, dass der Bericht DebugView einige zusätzliche Konfigurationsschritte erfordert, bevor Sie ihn verwenden können.

Wenn Sie die Werte von benutzerdefinierten Parametern in der Google Analytics-Berichtsoberfläche (z. B. in Analysen oder Standardberichten) sehen und analysieren möchten, müssen Sie sie zuerst als benutzerdefinierte Dimensionen oder Messwerte registrieren.

In DebugView prüfen

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

Von gewissen 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

Erstellen Sie benutzerdefinierte Dimensionen und Messwerte für Ihre benutzerdefinierten Ereignisparameter.