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 zu den Aktivitäten 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 liefern zusätzliche Informationen dazu, wie Nutzer mit Ihrer Website interagieren. Wenn sich beispielsweise jemand ein von Ihnen verkauftes Produkt ansieht, können Sie Parameter einfügen, die das angesehene Produkt beschreiben, z. B. Name, Kategorie und 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.

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 Analysen anzeigen und analysieren kann, müssen Sie sie in der Google Analytics-Benutzeroberfläche als benutzerdefinierte Dimensionen oder Messwerte registrieren. Ohne diese Registrierung werden die Parameterdaten zwar erfasst, 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 (in Ihrem <head> HTML-Tag) aktualisieren, um Parameter mit jedem Ereignis auf der Seite zu senden.

Im folgenden Beispiel wird der Seitentitel festgelegt und der Parameter dann 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 mit den Ber101ichten Echtzeit und DebugView prüfen, ob Ihre Ereignisse und Parameter korrekt gesendet werden. In diesen Berichten werden Daten angezeigt, sobald sie eingehen. Beachten Sie, dass der Bericht DebugView einige zusätzliche Konfiguration 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. Nach der Registrierung einer benutzerdefinierten Dimension oder eines benutzerdefinierten Messwerts 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 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.

Bei einigen Parametern werden vordefinierte Dimensionen und Messwerte in Google Analytics automatisch ausgefüllt. Ü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.

Zurück
Ereignisse einrichten
Weiter
User-IDs senden