Ereignisse einrichten

Mit Ereignissen können Sie Nutzerinteraktionen auf Ihrer Website oder in Ihrer App erfassen. Sie können beispielsweise erfassen, wenn jemand eine Seite lädt, auf einen Link klickt oder einen Kauf tätigt. In Google Analytics werden Daten aus Ereignissen verwendet, um Berichte mit Informationen zu Ihrem Unternehmen zu erstellen. Weitere Informationen

Ereignistypen

Google Analytics-Ereignisse sind in vier Kategorien unterteilt:

Ereignistyp Link Einrichtung erforderlich? Beschreibung und Anwendungsfall
Automatisch erfasst Weitere Informationen Nein Werden standardmäßig erfasst, wenn Sie das Google Analytics-Tag auf Ihrer Website oder in Ihrer App einrichten. Beispiele: first_visit, session_start und user_engagement.
Optimierte Analysen Weitere Informationen Nein (in der Regel) Werden automatisch erfasst, wenn optimierte Analysen in der Google Analytics-Benutzeroberfläche aktiviert sind. Erfassen häufige Webinteraktionen wie scroll, click und file_download.
Empfohlen Referenz zu empfohlenen Ereignissen Ja Standardisierte Ereignisse für verschiedene Branchen (z.B. Einzelhandel, Reisen, Spiele), mit denen Sie vorgefertigte Berichtstabellen freischalten können. Beispiele: purchase, login, sign_up.
Benutzerdefiniert Weitere Informationen Ja Ereignisse, die Sie selbst definieren, weil kein automatisch erfasstes, optimiertes oder empfohlenes Ereignis Ihren Anforderungen entspricht. Über benutzerdefinierte Berichte zugänglich.

Hier erfahren Sie, wie Sie mit dem Google-Tag (gtag.js) oder Google Tag Manager empfohlene und benutzerdefinierte Ereignisse auf Ihrer Website einrichten. Sie müssen keine automatisch erfassten Ereignisse und Ereignisse für optimierte Analysen einrichten.

Zielgruppe

Sie haben Google Analytics eingerichtet und sehen bereits Daten in Ihren Berichten. Sie möchten aber mehr Informationen erfassen als die, die automatisch erfasst werden, oder bestimmte Funktionen in Analytics freischalten.


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.

Überblick über das Google-Tag (gtag.js)

Mit der Google-Tag-API (gtag.js) können Sie Ereignisse an Google Analytics senden. Die API hat eine Funktion namens gtag(). Wenn Sie ein Ereignis an Google Analytics senden möchten, verwenden Sie die folgende Syntax:

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

In diesem Beispiel enthält die Funktion gtag() Folgendes:

  • Einen event-Befehl, der Google mitteilt, dass Sie ein Ereignis senden
  • Den Namen des empfohlenen oder benutzerdefinierten Ereignisses
  • (Optional) Eine Sammlung von Parametern, die zusätzliche Informationen zum Ereignis liefern

Das folgende Beispiel zeigt ein empfohlenes Ereignis namens screen_view mit zwei Parametern:

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

Ereignisse zu Ihrem JavaScript hinzufügen

gtag() ist eine JavaScript-Funktion. Sie müssen die Funktion also dem JavaScript auf Ihrer Webseite hinzufügen. Sie können die Funktion beispielsweise in Ihre <script> Tags oder in eine separate JavaScript-Datei einfügen, die Sie in Ihre HTML Seite importieren.

Sie können Ereignisse an einer beliebigen Stelle unterhalb des Google-Tag-Snippets zu Ihrem JavaScript hinzufügen. Google verarbeitet keine Daten aus Ereignissen, die Sie oberhalb des Google-Tag-Snippets platzieren. Der folgende Beispielcode enthält beispielsweise ein empfohlenes Ereignis namens screen_view und ein benutzerdefiniertes Ereignis namens signup_newsletter innerhalb eines <script>-Tags:

<!DOCTYPE html>
<html lang="en">
<head>
    <!-- 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');
    </script>

    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Title of the page</title>
</head>
<body>
    <p>Welcome to my website!</p>
    
    <script>
      /**
      *   The following events are sent when the page loads. You send
      *   recommended and custom events the same way. You could wrap
      *   the events in JavaScript functions so they are sent when
      *   users perform specific actions.
      */
      gtag('event', 'screen_view', {
        'app_name': 'myAppName',
        'screen_name': 'Home'
      });
      gtag('event', 'signup_newsletter', {
        'method': 'web'
      });
    </script> 
</body>
</html>

Wenn Sie das Ereignis basierend auf einem Klick auf eine Schaltfläche (oder einer anderen Nutzeraktion) senden möchten, können Sie Ihrem Ereignis zusätzlichen JavaScript-Code hinzufügen.

Mehrere Ereignisse einrichten

Wenn Sie verschiedene Nutzerinteraktionen erfassen möchten, müssen Sie mehrere gtag('event', ...) Aufrufe im JavaScript Ihrer Website implementieren. Jeder Aufruf wird durch eine bestimmte Aktion oder Bedingung ausgelöst. In den Beispielen werden sowohl empfohlene Ereignisse als auch benutzerdefinierte Ereignisse verwendet.

Wenn Sie beispielsweise verschiedene Aktivitäten wie Nutzeranmeldungen, das Teilen von Inhalten und den Abschluss von Tutorials erfassen möchten, implementieren Sie separate gtag('event', ...) Aufrufe:

Beispiel: Anmeldungen erfassen

Dieses Snippet wird in die JavaScript-Funktion eingefügt, die erfolgreiche Nutzeranmeldungen verarbeitet.

// Send a 'login' event when a user signs in
gtag('event', 'login', {
  method: 'Email' // Example parameter indicating login method
});

Beispiel: Das Teilen von Inhalten erfassen

Dieses Snippet wird mit dem Click-Event einer Schaltfläche zum Teilen verknüpft.

// Send a 'share' event when a user clicks a share button
gtag('event', 'share', {
  method: 'Facebook',
  content_type: 'Article',
  item_id: 'C12345' // Example parameter for the shared item
});

Beispiel: Ein benutzerdefiniertes Ereignis erfassen

Dieses Snippet wird aufgerufen, wenn ein Nutzer ein Tutorial auf der Website erfolgreich abgeschlossen hat.

// Send a custom event
gtag('event', 'tutorial_complete', {
  tutorial_name: 'Introduction to GA4'
});

Sie betten diese gtag('event', ...) Aufrufe an verschiedenen Stellen im Code Ihrer Website ein, um die Daten zum richtigen Zeitpunkt zu erfassen. Jedes Ereignis wird an Google Analytics gesendet, sobald es auftritt. Es gibt keine spezielle Syntax oder einen einzelnen Aufruf, um mehrere verschiedene Arten von Ereignissen in einem Batch mit gtag.js zu definieren oder zu senden. Sie rufen gtag('event', ...) für jedes Ereignis auf, das Sie senden möchten.

Ereignisse in Analytics ansehen

Sie können sich Ihre Ereignisse und die zugehörigen Parameter in den Berichten Echtzeit und DebugView ansehen. Bevor Sie den Bericht DebugView verwenden können, sind einige zusätzliche Konfigurationsschritte erforderlich. In diesen beiden Berichten sehen Sie die Ereignisse, die Nutzer auf Ihrer Website auslösen, sobald sie ausgelöst werden.

Nächste Schritte

Zurück
Web
Weiter
Parameter hinzufügen