Erfahren Sie, wie Sie ein Cookie-Zustimmungsbanner zu Ihrem Help Center hinzufügen, entweder über eine direkte Consent Management Platform (CMP)-Integration oder Google Tag Manager (GTM). Diese Anleitung behandelt Anforderungen, Schritt-für-Schritt-Anweisungen und wichtige Überlegungen zur Einhaltung und Funktionalität.
Bevor Sie beginnen
Wichtig:
Sie müssen eine benutzerdefinierte domain für Ihr Help Center einrichten. Dieser Prozess funktioniert nicht mit der Standarddomain von Intercom (z. B. intercom.help).
Das Aktivieren benutzerdefinierter Skripte entfernt den Intercom Messenger und Google Analytics nur dann aus Ihrem Help Center, wenn Sie ein benutzerdefiniertes Skript bereitstellen. Wenn Sie Messenger und Google Analytics weiterhin mit benutzerdefinierten Skripten verwenden möchten, müssen Sie diese in Ihr benutzerdefiniertes Skript aufnehmen. Details finden Sie im Abschnitt Wie füge ich Intercom Messenger zu meinem benutzerdefinierten Skript hinzu? weiter unten.
Hinweis: Help Center ohne benutzerdefinierte Skripte laden Intercom Messenger und Google Analytics weiterhin normal, auch wenn die Funktion für Ihren Arbeitsbereich aktiviert ist.
Das von Ihnen bereitgestellte benutzerdefinierte Skript wird nur im
<head>-Abschnitt Ihrer Help Center-Seite ausgeführt.Wenn benutzerdefinierte Skripte für Ihren Arbeitsbereich aktiviert sind:
Help Center mit benutzerdefinierten Skripten: Es werden nur Ihre benutzerdefinierten Skripte geladen. Standard-Intercom-Skripte (Messenger, Google Analytics) werden nicht geladen.
Help Center ohne benutzerdefinierte Skripte: Laden weiterhin die Standard-Intercom-Skripte (Messenger, Google Analytics) normal.
Wie verschiedene CMPs integriert werden
Alle CMPs können mit Ihrem Help Center arbeiten – der Implementierungsansatz variiert je nach Anbieter.
OneTrust
Hat eine integrierte Integration mit dem Help Center.
Die Schaltfläche für die Cookie-Einstellungen verbindet sich automatisch mit dem OneTrust-Modal.
Ihr Skript muss Ihre OneTrust-Konfiguration enthalten.
Kein zusätzlicher Code zur Schaltflächensteuerung erforderlich.
Andere CMPs (Usercentrics, Cookiebot, CookieYes usw.)
Benötigen zusätzlichen Code von Ihrem Entwicklungsteam.
Ihr Skript muss mit der Schaltfläche für die Cookie-Einstellungen des Help Centers verbunden sein.
Details finden Sie im Abschnitt Cookie-Einstellungen-Schaltfläche weiter unten.
Cookie-Einstellungen-Schaltfläche
Das Help Center erstellt automatisch eine Cookie-Einstellungen-Schaltfläche mit der ID ot-sdk-btn, die Besucher zur Verwaltung ihrer Präferenzen verwenden.
Mit OneTrust
Die Schaltfläche verbindet sich automatisch mit dem Zustimmungsmodal von OneTrust.
Kein zusätzlicher Code erforderlich.
Mit anderen CMPs
Ihr Skript muss Code enthalten, der Klicks auf diese Schaltfläche überwacht.
Beim Klicken löst Ihr Code die Anzeige der Einstellungen Ihres CMP aus.
Ohne diesen Code funktioniert die Schaltfläche nicht.
Hinweis: Ihr Entwicklungsteam muss einen Ereignis-Listener für das Element ot-sdk-btn hinzufügen. Die spezifische Implementierung hängt von der API Ihres CMP ab – konsultieren Sie die Dokumentation Ihres CMP-Anbieters für die korrekte Funktion zum Öffnen der Zustimmungseinstellungen.
Wie man ein Cookie-Zustimmungsbanner implementiert
Sie haben zwei Optionen, um ein Cookie-Banner hinzuzufügen:
Option 1: Direkte CMP-Integration
Diese Option erfordert ein Skript von Ihrem Engineering-Team, das Ihre gewählte Consent Management Platform (CMP) implementiert.
Schritt 1: Bereiten Sie Ihr Skript vor
Ihr Engineering-Team muss ein Skript vorbereiten, das:
Ihre gewählte CMP implementiert.
Sicherstellt, dass Cookies, die nach geltendem Datenschutzrecht der Zustimmung des Nutzers bedürfen, erst nach Einholung der Zustimmung gesetzt werden.
Hinweis: Das Aktivieren benutzerdefinierter Skripte entfernt den Intercom Messenger und Google Analytics aus Ihrem Help Center. Wenn Sie diese weiterhin verwenden möchten, müssen Sie sie in Ihr benutzerdefiniertes Skript aufnehmen (siehe Wie füge ich Intercom Messenger zu meinem benutzerdefinierten Skript hinzu? für Details).
Schritt 2: Kontaktieren Sie uns, um das Skript einzufügen
Sobald Ihr Skript fertig ist, wenden Sie sich an unser Support-Team und stellen Sie ihnen das Skript zur Verfügung. Sie werden es in Ihr Help Center einfügen.
Hinweis: Dieser Prozess erfordert, dass unser Support-Team das Skript manuell einfügt. Es handelt sich nicht um eine Selbstbedienungskonfiguration.
Schritt 3: Überprüfen Sie die Implementierung
Nachdem wir bestätigt haben, dass das Skript eingefügt wurde, müssen Sie überprüfen, dass Cookies erst gesetzt werden, nachdem Sie alle erforderlichen Zustimmungen von Ihren Help Center-Besuchern eingeholt haben.
Option 2: Google Tag Manager (GTM) + CMP
Wenn Sie Google Tag Manager verwenden, ist GTM in Ihrem benutzerdefinierten Skript enthalten und wird nicht separat eingefügt. Das Help Center kann das <noscript>-Body-Element von GTM separat einfügen, aber das Haupt-GTM-JavaScript im <head> nicht unabhängig einfügen.
Schritt 1: Konfigurieren Sie GTM
Ihr benutzerdefiniertes Skript sollte Folgendes enthalten:
- Ihre CMP-Konfiguration.
- GTM-Initialisierung.
- Intercom Messenger (falls benötigt – siehe FAQs unten).
- Verbindung zur Cookie-Einstellungen-Schaltfläche, wenn Sie OneTrust nicht verwenden (siehe Abschnitt Cookie-Einstellungen-Schaltfläche oben).
Stellen Sie das GTM-<noscript>-Body-Element separat bereit, wenn Sie Ihr Skript einreichen. Unser Team wird es in den <body> Ihres Help Centers einfügen.
Schritt 2: Kontaktieren Sie uns, um das GTM-Skript einzufügen
Sobald Ihr GTM-Skript fertig ist, wenden Sie sich an unser Support-Team und stellen Sie es ihnen zur Verfügung. Sie werden es in Ihr Help Center einfügen.
Hinweis: Dieser Prozess erfordert, dass unser Support-Team das Skript manuell einfügt. Es handelt sich nicht um eine Selbstbedienungskonfiguration.
Schritt 3: Überprüfen Sie die Implementierung
Nachdem wir bestätigt haben, dass das Skript eingefügt wurde, stellen Sie sicher, dass Cookies erst gesetzt werden, nachdem Sie alle erforderlichen Zustimmungen von Ihren Help Center-Besuchern eingeholt haben.
CSP-Domain-Anforderungen
Bevor Sie Ihr Skript einreichen, identifizieren Sie, welche domains Ihr CMP benötigt. Diese müssen zur Content Security Policy (CSP)-Konfiguration hinzugefügt werden – ohne diese blockiert der Browser die Anfragen Ihres CMP.
So finden Sie die erforderlichen domains
Überprüfen Sie die technische Dokumentation Ihres CMP-Anbieters.
Suchen Sie nach „CSP-Anforderungen“ oder „domains zur Whitelist“.
Kontaktieren Sie Ihren CMP-Anbieter, wenn dies nicht dokumentiert ist.
CMP-spezifische Hinweise
OneTrust: Keine zusätzlichen domains erforderlich (integrierte Unterstützung).
Usercentrics, Cookiebot, CookieYes: Überprüfen Sie die Dokumentation Ihres Anbieters für erforderliche domains.
Hinweis: Wenn Sie Ihr Skript einreichen, fügen Sie die Liste der erforderlichen domains bei, damit unser Support-Team sie zur CSP-Konfiguration hinzufügen kann.
Technische Details
Ihr benutzerdefiniertes Skript wird oben im <head> der Seite geladen. Das Erstellen neuer Skriptelemente mit document.createElement("script") oder innerHTML erbt nicht das Nonce und wird von CSP blockiert. Um Kompatibilität zu gewährleisten, führen Sie JavaScript-Code direkt aus, anstatt neue Skriptelemente einzufügen. Wenn dieser Ansatz nicht Ihren Anforderungen entspricht, kontaktieren Sie uns für weitere Anleitungen.
Sie können mehrere <script>-Tags zu Ihrem Help Center hinzufügen. Zum Beispiel:
<script src="https://..." />
<script>
console.log("test");
</script>
Unterstützung für Body-noscript-Elemente:
Wenn Sie noscript-Elemente zum <body> Ihrer Help Center-Seite hinzufügen müssen (z. B. Google Tag Manager noscript-Tags), können Sie die Body-Elemente bereitstellen, die Sie hinzufügen möchten.
Beispiel:
<noscript>
<iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXX"
height="0" width="0" style="display:none;visibility:hidden">
</iframe>
</noscript>
FAQs
Was passiert, wenn ich die Standard-Intercom-domain verwende?
Was passiert, wenn ich die Standard-Intercom-domain verwende?
Sie müssen eine benutzerdefinierte domain für Ihr Help Center verwenden. Dieser Prozess funktioniert nicht mit der Standarddomain von Intercom (z. B. intercom.help).
Entfernt das Aktivieren benutzerdefinierter Skripte den Intercom Messenger oder Google Analytics?
Entfernt das Aktivieren benutzerdefinierter Skripte den Intercom Messenger oder Google Analytics?
Das Aktivieren benutzerdefinierter Skripte entfernt den Intercom Messenger und Google Analytics aus Ihrem Help Center nur, wenn Sie ein benutzerdefiniertes Skript bereitstellen. Help Center ohne benutzerdefinierte Skripte laden Intercom Messenger und Google Analytics weiterhin normal. Wenn Sie ein benutzerdefiniertes Skript bereitstellen und Messenger und Google Analytics weiterhin verwenden möchten, müssen Sie diese in Ihr benutzerdefiniertes Skript aufnehmen. Details finden Sie unter Wie füge ich Intercom Messenger zu meinem benutzerdefinierten Skript hinzu?.
Kann ich mehrere Skripte zu meinem Help Center hinzufügen?
Kann ich mehrere Skripte zu meinem Help Center hinzufügen?
Ja. Sie können mehrere <script>-Tags zu Ihrer Help Center-Seite hinzufügen.
Wie füge ich Intercom Messenger zu meinem benutzerdefinierten Skript hinzu?
Wie füge ich Intercom Messenger zu meinem benutzerdefinierten Skript hinzu?
Siehe unsere Messenger-Installationsanleitung für detaillierte Anweisungen, wie Sie den Messenger zu Ihrem benutzerdefinierten Skript hinzufügen.
Wichtig: Wenn Sie den Messenger zu Ihrem benutzerdefinierten Skript hinzufügen, müssen Sie ihn auch mit Ihrer Consent Management Platform (CMP) integrieren, um Messenger-Cookies basierend auf der Zustimmung der Nutzer zu steuern. Details zur Implementierung finden Sie unter Wie kann ich Intercom Messenger-Cookies mit meinem Zustimmungsbanner steuern? weiter unten.
Wie kann ich Intercom Messenger-Cookies mit meinem Zustimmungsbanner steuern?
Wie kann ich Intercom Messenger-Cookies mit meinem Zustimmungsbanner steuern?
Für detaillierte Schritt-für-Schritt-Anleitungen zur Implementierung lesen Sie unseren Artikel: Intercom Messenger Cookies.