Google Tag Manager-Integration
GTM-Container-ID in docs.json hinzufügen, um Google Tag Manager mit Analyse- und Tracking-Tags auf jeder Seite zu laden.
Füge deine GTM-Container-ID in docs.json hinzu, um Google Tag Manager auf jeder Seite deiner Dokumentation zu laden. Dein Marketingteam richtet anschließend Analysen, Conversion-Pixel und Event-Tracking in GTM ein.
GTM-Container-IDs beginnen mit GTM-. Für reines Google Analytics siehe Google Analytics-Integration für eine einfachere Einrichtung.
Wann Sie GTM verwenden sollten
Verwende Google Tag Manager, wenn du Folgendes benötigst:
- Mehrere Tracking-Tools: GA4, Facebook Pixel, LinkedIn usw.
- Kontrolle durch das Marketingteam: Marketer fügen Tags ohne Hilfe von Entwicklern hinzu
- Erweiterte Trigger: Klicks auf Schaltflächen, Formularabsendungen, Videoaufrufe verfolgen
- A/B-Testing-Integration: Tools wie Google Optimize anbinden
Für einfache Analysen ist das direkte Hinzufügen von GA4 einfacher.
Ihre Container-ID abrufen
- Öffne Google Tag Manager
- Wähle dein Konto und deinen Container aus (oder erstelle neue)
- Kopiere die Container-ID oben auf der Seite (beginnt mit
GTM-)
GTM zu Ihrer Dokumentation hinzufügen
Füge die Container-ID zu deiner docs.json hinzu:
{
"name": "My Docs",
"integrations": {
"gtm": {
"tagId": "GTM-XXXXXXX"
}
}
}Ersetze GTM-XXXXXXX durch deine Container-ID.
Cookie-Einwilligung
Richte Cookie-Banner zur Einwilligung selbst ein, falls du sie benötigst. Jamdesk lädt deinen GTM-Container auf jeder Seite. Jedes Tag, das du konfigurierst, wird für jeden Besucher ausgelöst. Wenn DSGVO, CCPA oder ähnliche Vorschriften für deine Leser gelten, konfiguriere den Consent Mode in GTM oder verwende eine Consent-Management-Plattform. Jamdesk kann GTM selbst auch hinter einer Einwilligung sperren. Siehe Cookie-Einwilligung.
GA4 über GTM einrichten
Lade GA4 über GTM statt es direkt hinzuzufügen:
- Gehe in GTM zu Tags → Neu
- Wähle Google Analytics: GA4-Konfiguration
- Gib deine GA4-Messungs-ID ein (beginnt mit
G-) - Setze den Trigger auf All Pages
- Veröffentliche deinen Container
Wenn du GA4 über GTM konfigurierst, füge es nicht zusätzlich direkt in docs.json hinzu. Das führt zu doppeltem Tracking.
Installation überprüfen
GTM-Vorschaumodus verwenden
- Klicke in GTM oben rechts auf Vorschau
- Gib die URL deiner Dokumentationsseite ein
- Ein Debug-Fenster zeigt, welche Tags auf jeder Seite ausgelöst werden
Browser-Entwicklertools verwenden
- Öffne deine Seite mit den Entwicklertools (F12)
- Wechsle zum Tab Netzwerk
- Filtere nach
gtm.jsodergoogletagmanager - Bestätige, dass die Anfragen erscheinen
Häufige GTM-Tags für Dokumentationen
Ausgehende Links verfolgen
Verfolge Klicks auf externe Links mit diesem Tag:
- Tag: Google Analytics: GA4-Ereignis
- Ereignisname:
click - Trigger: Klick – Nur Links, bei dem Click URL deine Domain nicht enthält
Suchnutzung verfolgen
Verfolge die Nutzung der Suche:
- Tag: Google Analytics: GA4-Ereignis
- Ereignisname:
search - Trigger: Benutzerdefiniertes Ereignis, das deiner Sucheingabe entspricht
Verweildauer auf der Seite verfolgen
Miss, wie lange Leser auf einer Seite bleiben:
- Tag: Google Analytics: GA4-Ereignis
- Ereignisname:
timing - Trigger: Timer-Trigger (z. B. alle 30 Sekunden)
Fehlerbehebung
- Container-ID prüfen: Sie muss mit
GTM-beginnen - Container veröffentlichen: Nicht veröffentlichte Änderungen erscheinen nicht auf deiner Seite
- Vorschaumodus verwenden: Die GTM-Vorschau zeigt, welche Tags auf jeder Seite ausgelöst werden
GA4, das an zwei Stellen eingerichtet ist, zählt jeden Seitenaufruf doppelt:
- Direkt in
docs.json(integrations.ga4) - Über GTM als GA4-Tag
Entferne eine der beiden Einrichtungen.
