Integration von Google Tag Manager
Fügen Sie Ihre GTM-Container-ID zu docs.json hinzu, um Google Tag Manager auf jeder Seite zu laden. Verwalten Sie Analyse- und Tracking-Tags in GTM.
Fügen Sie Ihre GTM-Container-ID zu docs.json hinzu, um Google Tag Manager auf jeder Seite Ihrer Dokumentationswebsite zu laden. Anschließend kann Ihr Marketingteam Analysen, Conversion-Pixel und Event-Tracking vollständig in GTM konfigurieren.
GTM-Container-IDs beginnen mit GTM-. Wenn Sie nur Google Analytics benötigen, finden Sie unter Integration von Google Analytics eine einfachere Einrichtung.
Wann Sie GTM verwenden sollten
Verwenden Sie Google Tag Manager, wenn Sie Folgendes benötigen:
- Mehrere Tracking-Tools - GA4, Facebook Pixel, LinkedIn usw.
- Kontrolle durch das Marketingteam - Marketingmitarbeiter können Tags ohne Unterstützung durch Entwickler hinzufügen
- Erweiterte Trigger - Klicks auf Schaltflächen, Formularübermittlungen und Videoaufrufe verfolgen
- Integration von A/B-Tests - Tools wie Google Optimize verbinden
Für grundlegende Analysen ist das direkte Hinzufügen von GA4 einfacher.
Ihre Container-ID abrufen
- Öffnen Sie Google Tag Manager
- Wählen Sie Ihr Konto und Ihren Container aus (oder erstellen Sie neue)
- Kopieren Sie die Container-ID oben auf der Seite (sie beginnt mit
GTM-)
GTM zu Ihrer Dokumentation hinzufügen
Fügen Sie die Container-ID zu Ihrer docs.json hinzu:
{
"name": "My Docs",
"integrations": {
"gtm": {
"tagId": "GTM-XXXXXXX"
}
}
}Ersetzen Sie GTM-XXXXXXX durch Ihre tatsächliche Container-ID.
Cookie-Einwilligung
Sie sind dafür verantwortlich, Cookie-Einwilligungsbanner einzurichten, falls Sie diese benötigen. Jamdesk lädt Ihren GTM-Container auf jeder Seite, sodass alle von Ihnen konfigurierten Tags für alle Besucher ausgelöst werden. Wenn Ihre Leser der DSGVO, dem CCPA oder ähnlichen Vorschriften unterliegen, konfigurieren Sie den Einwilligungsmodus in GTM oder verwenden Sie eine Plattform zur Verwaltung von Einwilligungen. Jamdesk kann GTM auch selbst hinter einer Einwilligung zurückhalten. Weitere Informationen finden Sie unter Cookie-Einwilligung.
GA4 über GTM einrichten
Wenn Sie GA4 über GTM verwenden möchten, anstatt es direkt hinzuzufügen:
- Gehen Sie in GTM zu Tags → New
- Wählen Sie Google Analytics: GA4 Configuration
- Geben Sie Ihre GA4 Measurement ID ein (sie beginnt mit
G-) - Setzen Sie den Trigger auf All Pages
- Publish Sie Ihren Container
Wenn Sie GA4 über GTM konfigurieren, fügen Sie es nicht zusätzlich direkt in docs.json hinzu. Dies führt zu doppeltem Tracking.
Installation überprüfen
GTM-Vorschaumodus verwenden
- Klicken Sie in GTM oben rechts auf Preview
- Geben Sie die URL Ihrer Dokumentationswebsite ein
- Ein Debugfenster zeigt, welche Tags auf jeder Seite ausgelöst werden
Browser-Entwicklertools verwenden
- Öffnen Sie Ihre Website mit den Entwicklertools (F12)
- Gehen Sie zum Tab Network
- Filtern Sie nach
gtm.jsodergoogletagmanager - Es sollten ausgeführte Anfragen angezeigt werden
Häufige GTM-Tags für Dokumentationen
Ausgehende Links verfolgen
Erstellen Sie ein Tag, um zu verfolgen, wann Benutzer auf externe Links klicken:
- Tag: Google Analytics: GA4 Event
- Event Name:
click - Trigger: Click - Just Links, wobei Click URL Ihre Domain nicht enthält
Suchnutzung verfolgen
Verfolgen Sie, wann Benutzer mit der Suchfunktion interagieren:
- Tag: Google Analytics: GA4 Event
- Event Name:
search - Trigger: Custom event matching your search interaction
Verweildauer auf der Seite verfolgen
Ermitteln Sie, wie lange Benutzer mit dem Lesen verbringen:
- Tag: Google Analytics: GA4 Event
- Event Name:
timing - Trigger: Timer trigger (z. B. alle 30 Sekunden)
Fehlerbehebung
- Container-ID überprüfen - Sie muss mit
GTM-beginnen - Container veröffentlichen - Nicht veröffentlichte Änderungen werden auf Ihrer Website nicht angezeigt
- Vorschaumodus verwenden - Die GTM-Vorschau zeigt, welche Tags auf jeder Seite ausgelöst werden
Wenn Sie GA4 auf beide Arten konfiguriert haben:
- Direkt in
docs.json(integrations.ga4) - Über GTM als GA4-Tag
Erhalten Sie doppelte Seitenaufrufe. Entfernen Sie eine der beiden Konfigurationen.
