Google-Produkte konfigurieren und Ereignisdaten senden

Diese Seite richtet sich an Entwickler, die das Google-Tag mit gtag.js konfigurieren müssen. Mit dem Google-Tag können Sie auch einige Einstellungen in der Benutzeroberfläche anpassen. Weitere Informationen finden Sie unter Google-Tag-Einstellungen konfigurieren.

Nachdem Sie das Google-Tag installiert haben, können Sie gtag()-Befehle an einer beliebigen Stelle im Code nach dem Google-Tag-Snippet aufrufen.

Auf dieser Seite wird erläutert, wie Sie

  1. mit dem Befehl config einen Datenfluss zwischen Ihrer Website und Google-Produkten einrichten
  2. mit dem Befehl event Ereignisse an Ihre Google-Produkte senden
  3. mit dem Befehl set Werte festlegen, die mit jedem Ereignis gesendet werden

Hinweis

In diesem Leitfaden wird davon ausgegangen, dass Sie bereits diese Schritte ausgeführt haben:

Für die Einrichtung des Datenflusses benötigen Sie Folgendes:

  • Zugriff auf den Websitecode, in dem Sie das Google-Tag installiert haben
  • Die Tag-ID des Google-Produkts, das Sie mit dem Google-Tag verknüpfen möchten

Was ist eine Tag-ID und wo finde ich sie? Eine Tag-ID identifiziert ein Google-Tag. Ein einzelnes Google-Tag kann mehrere Tag-IDs haben. Wenn Sie beispielsweise Google Ads verwenden, hat Ihr Tag jetzt zwei IDs: eine Legacy-ID (AW) und eine Google-Tag-ID (GT). Bildschirm mit einem Google-Tag in Google Ads mit zwei Tag-IDs. Die Tag-IDs sind austauschbar. Die folgende Tabelle enthält eine Übersicht der Tags, die mit dem Google-Tag kompatibel sind.
Präfix ID-Typ Beschreibung
GT-XXXXXX Google-Tag Jedes neu erstellte Google-Tag erhält ein GT-Präfix und eine eindeutige ID.
G-XXXXXX Google-Tag (Legacy-Präfix) Google Analytics 4-Tags sind Google-Tags mit einem G-Präfix und einer eindeutigen ID.
AW-XXXXXX Google-Tag (Legacy-Präfix) Google Ads-Tags sind Google-Tags mit einem AW-Präfix und einer eindeutigen ID.
DC-XXXXXX Google-Tag (Legacy-Präfix) Google Floodlight-Tags sind Google-Tags mit einem DC-Präfix und einer eindeutigen ID.
Universal Analytics-Tags (UA) sind nicht mit dem Google-Tag (GT) kompatibel.

Tag-ID finden:

Schritt 1: Google-Produkte mit Ihrem Tag verknüpfen

Verwenden Sie den Befehl config, um einen Datenfluss zu Google-Produkten einzurichten.

Der Befehl config

Mit dem Befehl config geben Sie die Google-Produkte an, an die Sie Ereignisdaten senden möchten. Der Befehl hat folgendes Format:

gtag('config', 'TAG_ID', {<additional_config_params>});

Zusätzliche Konfigurationsparameter

Sie können einen config Befehl anpassen und erweitern, indem Sie Parameter im optionalen {<additional_config_params>} Objekt angeben. Wenn Sie beispielsweise den folgenden Parameter hinzufügen, wird ein Google Analytics-Seitenaufruf nicht automatisch gesendet:

gtag('config', 'TAG_ID', {'send_page_view': false});

Datenerhebung einrichten

Wenn Sie die Datenerhebung für ein Google-Produkt einrichten möchten, fügen Sie den Befehl config mit einer Tag-ID hinzu.

Beispiel

Das Google-Tag (GT-XXXXXX) sendet Daten an die Ziele, die Sie dafür definiert haben, z. B. Google Ads und GA4.

Im folgenden Beispiel wird gezeigt, wie Sie Ihren Code aktualisieren, um ein zweites Google-Tag zu laden, das mit einem Floodlight-Ziel verknüpft ist.

Wenn Sie Daten an Floodlight (Tag-ID DC-ZZZZZZ) senden möchten, fügen Sie einen weiteren config-Befehl hinzu, nachdem Sie das erste Google-Tag (Tag-ID GT-XXXXXX) initialisiert haben:

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

config-Verhalten für bestimmte Produkte

Je nach Produkt, das in TAG_ID angegeben ist, kann der Befehl config auch bestimmte Verhaltensweisen für dieses Produkt auslösen. In einigen Fällen weist der Befehl config gtag.js beispielsweise an, ein Seitenaufruf-Ereignis zu initiieren.

Weitere Informationen zum Verhalten des Befehls config in Bezug auf einzelne Produkte finden Sie in der produktspezifischen Dokumentation:

Schritt 2: Daten mit event senden

Nachdem Sie Verbindungen zu Google-Produkten konfiguriert haben, müssen Sie den Befehl event verwenden, um Daten zu senden.

Der Befehl event

Mit dem Befehl event können Sie Ereignisdaten an die Produkte senden, die Sie mit config angegeben haben. Der Befehl hat folgendes Format:

gtag('event', 'event_name', {
  'key': 'value',
});

Ereignisnamen und Schlüssel-Wert-Paare

Empfohlene Ereignisse: Empfohlene Ereignisse werden von Ihnen implementiert, haben aber vordefinierte Schlüssel-Wert-Paare. Mit empfohlenen Ereignissen können Sie vorhandene und zukünftige Berichtsfunktionen nutzen.

Benutzerdefinierte Ereignisse: Wenn Sie eigene Ereignisse und Datenstrukturen definieren möchten, können Sie benutzerdefinierte Werte eingeben, um ein benutzerdefiniertes Ereignis zu senden.

Ereignisse einrichten

Sie können die Methode event an einer beliebigen Stelle im Code aufrufen, nachdem Sie das Google-Tag initialisiert haben.

  1. Definieren Sie ein Ereignis. Wenn Sie ein empfohlenes Ereignis verwenden, müssen Sie die standardisierten Ereignisnamen und vordefinierten Schlüssel-Wert-Paare verwenden.

  2. Definieren Sie, wann das Ereignis ausgelöst werden soll, z. B. wenn es mit einem Seitenaufruf gesendet wird oder wenn ein Nutzer auf eine Schaltfläche klickt.

Beispiel

Im folgenden Beispiel wird eine mögliche Methode zum Messen von Newsletter-Registrierungen veranschaulicht, wenn ein Nutzer auf eine Schaltfläche klickt. Im Beispiel wird ein benutzerdefiniertes Ereignis verwendet und an eine Google Analytics 4-Property gesendet.

<head>
   ...
   /* 1. Initialize the Google tag and gtag.js library */
   <!-- Google tag (gtag.js) -->
   <script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
   <script>
     window.dataLayer = window.dataLayer || [];
     function gtag(){dataLayer.push(arguments)};
     gtag('js', new Date());
     gtag('config', 'TAG_ID');
   </script>
</head>

<body>
   <script>
     let date = Date.now();
     /* 2. Define your event. */
     function newsletterSignup() {
       gtag('event', 'newsletter_signup', {
       'time': date,
       });
   }
   </script>
   ...
   /* 3. Trigger your event */
   <button type="submit" onclick="newsletterSignup()">Sign me up!</button>
   ...
</body>

Optional: Daten mit jedem Ereignis über set senden

Mit dem Befehl set können Sie Parameter definieren, die mit jedem nachfolgenden Ereignis auf der Seite verknüpft werden.

Sie können beispielsweise Kampagnen parameter freigeben, damit mehrere Tags auf derselben Seite darauf zugreifen können.

Der Befehl hat folgendes Format:

gtag('set', 'parameterName');

Schritt 3: Einrichtung überprüfen

So prüfen Sie, ob Ihre Ereignisdaten korrekt gesendet werden:

  1. Öffnen Sie das Google-Produkt, in dem Sie Daten sehen möchten.
  2. Prüfen Sie, ob Daten eingehen. In jedem Produkt gibt es eine andere Stelle, an der Sie prüfen können, ob Daten empfangen werden:
    • Google Analytics: Prüfen Sie den Echtzeit bericht.
    • Google Ads: Prüfen Sie die Tabelle „Conversion-Aktionen“ und sehen Sie sich die Spalte „Status“ an. Es kann bis zu 24 Stunden dauern, bis die Daten aktualisiert werden.
    • Floodlight: Verwenden Sie den Tag Assistant, um zu prüfen , ob Floodlight-Tags ausgelöst werden.

Nächste Schritte

Nachdem Sie Ihre Google-Produkte und Ereignisse eingerichtet haben, ist die grundlegende Google-Tag-Konfiguration abgeschlossen.

Wenn Sie mehrere Produkte verwalten und den Datenfluss detaillierter verwalten möchten, lesen Sie Daten gruppieren und weiterleiten.