Google-Produkte konfigurieren und Ereignisdaten senden

Diese Seite richtet sich an Entwickler, die das Google-Tag mit gtag.js konfigurieren müssen. Wenn Sie die Einstellungen stattdessen in der Benutzeroberfläche anpassen möchten, lesen Sie den Hilfeartikel 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. Ereignisse mit dem Befehl event an Ihre Google-Produkte senden
2. 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:

• Sie haben sich mit der Funktionsweise des Google-Tags vertraut gemacht.
• Google-Tag installiert

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

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

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

Befehl config

Mit dem Befehl config geben Sie die Google-Produkte an, an die Ereignisdaten gesendet werden sollen. Der Befehl hat folgendes Format:

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

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

Über das Google-Tag (GT-XXXXXX) werden Daten an die von Ihnen definierten Ziele gesendet, z. B. Google Ads und Google Analytics.

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 nach der Initialisierung des ersten Google-Tags (Tag-ID GT-XXXXXX) einen weiteren config-Befehl hinzu:

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

Produktspezifisches Verhalten von config

Je nach dem in TAG_ID angegebenen Produkt kann der Befehl config auch ein bestimmtes Verhalten 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 dazu, wie sich der Befehl config in Bezug auf einzelne Produkte verhält, finden Sie in der produktspezifischen Dokumentation:

• Google Ads-Conversions und Remarketing
• Campaign Manager und Display & Video 360
• Search Ads 360
• Google Analytics

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.

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',
});

Ereignisse einrichten

Sie können die Methode event an einer beliebigen Stelle im Code nach der Initialisierung des Google-Tags aufrufen.

1. Ereignis definieren Wenn Sie ein empfohlenes Ereignis verwenden, achten Sie darauf, die standardisierten Ereignisnamen und vordefinierten Schlüssel/Wert-Paare zu verwenden.

2. Legen Sie fest, wann das Ereignis ausgelöst wird, z. B. wenn es mit einem Seitenaufbau gesendet wird oder wenn jemand auf eine Schaltfläche klickt.

Beispiel

Im folgenden Beispiel wird eine mögliche Methode zum Erfassen von Newsletter-Anmeldungen veranschaulicht, wenn ein Nutzer auf eine Schaltfläche klickt. In diesem Beispiel wird ein benutzerdefiniertes Ereignis verwendet und an eine Google Analytics-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 Kampagnenparameter freigeben, damit mehrere Tags auf derselben Seite darauf zugreifen können.

Der Befehl hat folgendes Format:

gtag('set', 'parameterName');

Schritt 3: Einrichtung validieren

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

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

Nächste Schritte

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

Wenn Sie mehrere Produkte verwalten und deren Datenfluss genauer steuern möchten, lesen Sie den Hilfeartikel Daten gruppieren und weiterleiten.