Diese Seite richtet sich an Entwickler, die das Google-Tag mit gtag.js konfigurieren müssen. Mit dem Google-Tag lassen sich auch einige Einstellungen auf der Benutzeroberfläche anpassen (siehe Google-Tag-Einstellungen konfigurieren).
Nachdem Sie das Google-Tag installiert haben, können Sie nach dem Google-Tag-Snippet an einer beliebigen Stelle im Code gtag()-Befehle aufrufen.
Auf dieser Seite wird erläutert, wie Sie
- Mit dem Befehl
configeinen Datenfluss zwischen Ihrer Website und Google-Produkten einrichten - Ereignisse mit dem Befehl
eventan Ihre Google-Produkte senden - Mit dem Befehl
setkönnen Sie Werte festlegen, die bei jedem Ereignis gesendet werden
Hinweis
In diesem Leitfaden wird davon ausgegangen, dass Sie Folgendes getan haben:
- Sie haben sich mit der Funktionsweise des Google-Tags vertraut gemacht.
- Das Google-Tag wurde installiert.
Zum Einrichten des Datenflusses benötigen Sie Folgendes:
- Zugriff auf den Code der Website, auf der Sie das Google-Tag eingefügt haben
- Die Tag-ID des Google-Produkts, das Sie mit dem Google-Tag verbinden 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 das Tag jetzt zwei IDs: eine alte ID (AW) und eine Google-Tag-ID (GT).
Die Tag-IDs sind austauschbar. In der folgenden Tabelle finden Sie 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 (altes Präfix) | Google Analytics 4-Tags sind Google-Tags mit einem G-Präfix und einer eindeutigen ID. |
| AW-XXXXXX | Google-Tag (altes Präfix) | Google Ads-Tags sind Google-Tags mit einem AW-Präfix und einer eindeutigen ID. |
| DC-XXXXXX | Google-Tag (altes 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 ermitteln:
Schritt 1: Google-Produkte mit dem Tag verbinden
Informationen zum Befehl config
Der Befehl config gibt 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
Über das Google-Tag (GT-XXXXXX) werden Daten an die Ziele gesendet, die Sie dafür definiert haben, z. B. Google Ads und GA4.
Das folgende Beispiel zeigt, wie Sie Ihren Code aktualisieren, um ein zweites Google-Tag zu laden, das mit einem Floodlight-Ziel verbunden ist.
Zum Senden von Daten an Floodlight (Tag-ID DC-ZZZZZZ) 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 config-Verhalten
Abhängig von dem in TAG_ID angegebenen Produkt kann der Befehl config auch ein bestimmtes Verhalten für dieses Produkt auslösen.
In manchen Fällen weisen Sie gtag.js beispielsweise mit dem Befehl config an, ein Ereignis vom Typ „Seitenaufruf“ zu initiieren.
Weitere Informationen zum Verhalten des Befehls config in Bezug auf einzelne Produkte 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
Informationen zum 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 diesen 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
nach der Initialisierung des Google-Tags können Sie die Methode event an einer beliebigen Stelle im Code aufrufen.
Definieren Sie ein Ereignis. Wenn Sie ein empfohlenes Ereignis verwenden, müssen Sie die standardisierten Ereignisnamen und vordefinierten Schlüssel/Wert-Paare verwenden.
Legen Sie fest, wann das Ereignis ausgelöst wird, z. B. wenn es beim Laden der Seite gesendet wird oder wenn jemand auf eine Schaltfläche klickt.
Beispiel
Das folgende Beispiel zeigt eine mögliche Methode, um Anmeldungen für einen Newsletter zu messen, wenn ein Nutzer auf eine Schaltfläche klickt. Im Beispiel wird ein benutzerdefiniertes Ereignis 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" onlick="newsletterSignup()">Sign me up!</button>
...
</body>
Optional: Mit set bei jedem Ereignis Daten 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, sodass mehrere Tags auf derselben Seite darauf zugreifen können.
Der Befehl hat folgendes Format:
gtag('set', 'parameterName');
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 detaillierter verwalten möchten, lesen Sie Daten gruppieren und weiterleiten.