Ereignisse

In diesem Artikel erfahren Sie, wie Sie Universal Analytics-Ereignisse (UA) zu Google Analytics 4-Ereignissen (GA4) migrieren.

Da sich die Messmodelle für UA und GA4 unterscheiden, sollten Sie Ihre Datenerhebung im Hinblick auf das GA4-Modell überdenken, anstatt Ihre vorhandene UA-Ereignisstruktur auf GA4 zu übertragen.

Weitere Informationen zu GA4-Ereignissen

Vergleich von UA- und GA4-Ereignissen

Universal Analytics

Bei Universal Analytics (UA) werden Treffer gesendet, um die Messung durchzuführen. Die meisten Treffertypen werden verwendet, um bestimmte Interaktionen zu messen (z. B. pageview). Der Treffertyp event ist jedoch für die benutzerdefinierte/allgemeine Messung verfügbar. Die mit einem event-Treffer gesendeten Daten umfassen Category, Action und Label.

Unten sehen Sie Beispiele für Universal Analytics-Ereignisse für analytics.js- und gtag.js-Bibliotheken:

analytics.js (UA)

// Send an event using analytics.js.
ga('send', 'event', 'Settings', 'Enable', 'Dark mode');

// Alternatively, you can specify the event fields in the fieldsObject.
// The command above could be rewritten as:
ga('send', {
  hitType: 'event',
  eventCategory: 'Settings',
  eventAction: 'Enable',
  eventLabel: 'Dark mode'
});

gtag.js (UA)

gtag('event', 'Enable', {
  event_category: 'Settings',
  event_label: 'Dark mode'
});

Google Analytics 4

Bei Google Analytics 4 (GA4) werden Ereignisse gesendet. Es gibt Ereignisse, die automatisch erfasst werden, vordefinierte Ereignisse, die Sie bei Bedarf senden können, und benutzerdefinierte Ereignisse, die Sie senden können, wenn automatische oder empfohlene Ereignisse Ihren Anwendungsfall nicht erfüllen.

Hier sehen Sie ein Beispiel für ein benutzerdefiniertes Ereignis in GA4:

gtag.js (GA4)

gtag('event', 'settings_update', {
  setting: 'mode',
  status : 'dark'
});

UA-Ereignis zu GA4 zuordnen

Wenn Sie ein UA-Ereignis zu GA4 migrieren möchten, müssen Sie herausfinden, ob ein entsprechendes GA4-Ereignis vorhanden ist. Wenn Sie ein UA-Ereignis GA4 zuordnen möchten, gehen Sie so vor:

  1. Sehen Sie sich die Liste der automatisch erfassten Ereignisse an. Wenn ein in GA4 automatisch erfasstes Ereignis genau mit dem UA-Ereignis übereinstimmt, entfernen Sie das UA-Ereignis und verlassen Sie sich auf das automatisch erfasste Ereignis.

  2. Wenn Sie im vorherigen Schritt keine Übereinstimmung gefunden haben, sehen Sie sich die Ereignisse an, die über optimierte Analysen erfasst wurden. Wenn ein GA4-Ereignis für optimierte Analysen dem Zweck des UA-Ereignisses genau entspricht, migrieren Sie das UA-Ereignis nicht, sondern verwenden Sie optimierte Analysen, um das Ereignis zu senden. Prüfen Sie, ob optimierte Analysen für Ihre GA4-Property richtig konfiguriert sind, damit das Ereignis erfasst wird.

  3. Wenn Sie im vorherigen Schritt keine Übereinstimmung gefunden haben, sehen Sie sich die Liste der empfohlenen Ereignisse an. Wenn ein für GA4 empfohlenes Ereignis dem Zweck des UA-Ereignisses möglichst genau entspricht, verwenden Sie das empfohlene Ereignis und legen Sie beim Senden alle anwendbaren Ereignisparameter fest.

  4. Wenn Sie im vorherigen Schritt keine Übereinstimmung gefunden haben, senden Sie ein benutzerdefiniertes Ereignis.

Migrationsszenarien und Beispiele

Automatisch erfasste Ereignisse

Automatisch erfasste Ereignisse werden immer gesendet und können in der Regel nicht deaktiviert werden, es sei denn, sie lassen sich über optimierte Analysen konfigurieren. Im Allgemeinen sollten Sie keine UA-Ereignisse migrieren, für die ein ausreichend gleichwertiges automatisch erfasstes Ereignis vorhanden ist.

Beispielsweise muss ein UA-Ereignis, das zum Erfassen einer Dateidownloadinteraktion gesendet wird, wahrscheinlich nicht zu GA4 migriert werden, da das Ereignis file_download in GA4 automatisch erfasst wird.

Optimierte Analysen

In der Regel müssen UA-Ereignisse nicht zu GA4 migriert werden, wenn über optimierte Analysen ein ausreichend gleichwertiges GA4-Ereignis erfasst wird. Beispielsweise müssen die folgenden UA-Ereignisse wahrscheinlich nicht zu GA4 migriert werden, da sie bereits in GA4 über optimierte Analysen erfasst werden:

Überschreibung der optimierten Analysen

Wenn der Zweck eines Ereignisses für optimierte Analysen dem UA-Ereignis entspricht, aber nicht alle benötigten Daten erfasst werden, können Sie das Ereignis manuell mit zusätzlichen benutzerdefinierten Parametern senden. Dazu müssen Sie die optimierte Analyse für das entsprechende Ereignis konfigurieren oder deaktivieren und das GA4-Ereignis manuell senden.

Das über optimierte Analysen erfasste file_download-Ereignis stimmt beispielsweise genau mit Ihrem UA-Ereignis überein, es fehlen jedoch Informationen zur Dateigröße. So überschreiben Sie das Ereignis für optimierte Analysen und fügen Informationen zur Dateigröße hinzu:

  1. Deaktivieren Sie in Optimierte Analysen die Option Dateidownloads.
  2. Senden Sie das Ereignis file_download gegebenenfalls manuell mit benutzerdefinierten Parametern.
    • Da das automatisch erfasste Ereignis über optimierte Analysen deaktiviert ist, müssen Sie die Parameter, die normalerweise mit dem Ereignis erfasst werden (z. B. file_extension oder file_name), manuell festlegen.
  3. Erstellen Sie eine benutzerdefinierte Dimension bzw. einen benutzerdefinierten Messwert, um die Werte benutzerdefinierter Parameter in Berichten zu sehen.

Im folgenden gtag.js-Beispiel wird ein GA4-Ereignis vom Typ file_download mit einem benutzerdefinierten file_size-Parameter gesendet.

gtag('event', 'file_download', {
  file_extension: '.mp4',
  file_name: 'tutorial.mp4',
  link_url: '/videos/tutorial.mp4',
  link_text: 'Download the tutorial!',

  // Custom parameter.
  file_size: '275 MB'
});

Wenn für Ihr UA-Ereignis ein ausreichend gleichwertiges GA4-Ereignis vom Typ Empfohlenes Ereignis vorhanden ist , migrieren Sie es zum empfohlenen Ereignis.

Das folgende Beispiel zeigt ein analytics.js-UA-Ereignis, mit dem eine Anmeldung erfasst wird:

ga('send', 'event', 'login', 'google-sso');

Mit dem GA4-Ereignis login kann das UA-Ereignis zu GA4 migriert werden. Das GA4-gtag.js-Äquivalent sieht so aus:

gtag('event', 'login', {
  method: 'google-sso'
});

Benutzerdefiniertes Ereignis

Wenn Ihr UA-Ereignis kein entsprechendes Ereignis vom Typ Automatisch erfasst, Optimierte Analysen oder Empfohlenes Ereignis hat, migrieren Sie es zu einem benutzerdefinierten Ereignis und erstellen Sie dann nach Bedarf benutzerdefinierte Dimensionen und Messwerte.

Im folgenden Beispiel sehen Sie ein analytics.js-UA-Ereignis, mit dem Änderungen an den Ausrichtungsoptionen der Benutzeroberfläche gemessen werden:

ga('send', 'event', 'orientation', 'layout', 'wide');

Es gibt kein vordefiniertes GA4-Ereignis zum Erfassen des UA-Ereignisses oben. Stattdessen sehen Sie im folgenden gtag.js-Beispiel, wie mit einem benutzerdefinierten Ereignis dieselbe Interaktion in GA4 gemessen wird:

gtag('event', 'orientation_update', {
  ui_element: 'layout',
  configuration: 'wide'
});

Wenn Sie ui_element und configuration in Ihre Berichte aufnehmen möchten, müssen Sie die entsprechenden Dimensionen aus diesen Ereignisparametern erstellen. Weitere Informationen finden Sie unter Benutzerdefinierte Dimensionen und Messwerte.