Google-Analytics-Integration
Fügen Sie Google Analytics 4 mit einer Mess-ID zu Ihrer Dokumentationsseite hinzu, um Besucher zu verfolgen und das Engagement mit Inhalten zu verstehen.
Fügen Sie Google Analytics 4 zu Ihrer Dokumentationsseite hinzu, um zu verstehen, wie Benutzer mit Ihren Inhalten interagieren.
Die Google-Analytics-Integration funktioniert mit GA4-Mess-IDs (Google Analytics 4), die mit G- beginnen.
Mess-ID abrufen
- Gehen Sie zu Google Analytics
- Wählen Sie Ihre Property aus (oder erstellen Sie eine)
- Gehen Sie zu Admin → Data Streams
- Wählen Sie Ihren Web-Datenstream aus (oder erstellen Sie einen)
- Kopieren Sie die Measurement ID (beginnt mit
G-)
GA4 zu Ihrer Dokumentation hinzufügen
Fügen Sie die Mess-ID zu Ihrer docs.json hinzu:
{
"name": "My Docs",
"integrations": {
"ga4": {
"measurementId": "G-XXXXXXXXXX"
}
}
}Ersetzen Sie G-XXXXXXXXXX durch Ihre tatsächliche Mess-ID.
Daten anzeigen
Nach dem Hinzufügen der Integration:
- Lösen Sie einen neuen Build Ihrer Dokumentation aus
- Besuchen Sie Ihre Live-Dokumentationsseite
- Gehen Sie in Google Analytics zu Reports → Real-time
- Ihr Besuch sollte innerhalb von 30 Sekunden angezeigt werden
Es kann 24–48 Stunden dauern, bis Daten in Standardberichten angezeigt werden. Verwenden Sie Echtzeitberichte zur sofortigen Überprüfung.
Mit Google Tag Manager verwenden
Wenn Sie Google Tag Manager bereits verwenden, können Sie GA4 über GTM konfigurieren, anstatt es direkt hinzuzufügen. Weitere Informationen finden Sie unter Google-Tag-Manager-Integration.
Sie sind dafür verantwortlich, Einwilligungsbanner für Cookies für alle Tags einzurichten, die Sie über Google Tag Manager laden, sofern Sie diese benötigen. Jamdesk lädt Ihren GTM-Container für alle Besucher ohne Einwilligungsprüfung. Unter Cookie-Einwilligung erfahren Sie, wie Sie Analytics erst nach der Einwilligung von Besuchern aktivieren.
Fügen Sie dieselbe GA4-Property nicht sowohl direkt in docs.json als auch über Google Tag Manager hinzu, da dies zu doppeltem Tracking führt.
Datenschutzaspekte
Google Analytics erfasst Besucherdaten. Erwägen Sie Folgendes:
- Fügen Sie ein Einwilligungsbanner für Cookies hinzu, wenn die DSGVO/CCPA gilt. Jamdesk lädt GA4 standardmäßig für jeden Besucher. Verwenden Sie daher Cookie-Einwilligung, um GA4 erst nach der Einwilligung zu aktivieren.
- Aktualisieren Sie Ihre Datenschutzrichtlinie, um Analytics zu erwähnen
- Verwenden Sie bei Bedarf IP-Anonymisierung
Fehlerbehebung
- Überprüfen Sie Ihre Mess-ID – Sie muss mit
G-beginnen - Prüfen Sie Werbeblocker – Sie können Analytics-Skripte blockieren
- Warten Sie auf den Build – Änderungen erfordern einen neuen Build, bevor sie wirksam werden
- Verwenden Sie Echtzeitberichte – Standardberichte haben eine Verzögerung von 24–48 Stunden
Die ID muss:
- Mit
G-beginnen - Nach
G-nur Buchstaben und Zahlen enthalten - Exakt aus Google Analytics kopiert sein (ohne zusätzliche Leerzeichen)
