blickfang Cookie Consent Manager (CCM) integrieren
Zur Einbindung des CCM benötigen Sie einen entsprechenden Account. Bitte kontaktieren Sie uns, falls Ihnen dieser noch nicht vorliegt.
Einbindung benötigter Scripte
Fügen Sie die folgenden Scripte in den head-Bereich jeder Seite Ihrer Webseite ein und ersetzen Sie den api_key und die domain mit Ihren entsprechenden Werten. Um eine bestmögliche Ausführung zu erhalten, achten Sie darauf, die Scripte möglichst weit oben im Quellcode zu platzieren.
<script src="https://ccm.blickfang-media.com/public/app.js?apiKey=api_key&domain=domain" referrerpolicy="origin"></script>
Anpassung Cookie-setzender Script-Tags
Um eine vorherige Zustimmung durch den Benutzer zu ermöglich, müssen Sie Cookie-setzende Scripte entsprechend anpassen. Hierfür ergänzen Sie das Attribut type und setzen dessen Wert auf text/x-ccm-loader.
Gruppe für den Script-Loader
Haben Sie Ihre Skripte auf der Website entsprechend angepasst, können Sie diese Skripte gruppieren und einheitlich blockieren. Den Gruppennamen definieren Sie pro Einbindung selbst unter dem Punkt "Gruppe für den Script-Loader". Die Gruppenbezeichnung ergänzen Sie anschließend durch das Attribut data-ccm-loader-group.
<script type="text/x-ccm-loader" data-ccm-loader-group="google-analytics">...</script>
<script type="text/x-ccm-loader" data-ccm-loader-group="google-maps" data-ccm-loader-src="..."></script>
Eigenschaften
Name | Typ | Beschreibung |
---|---|---|
CCM.acceptedCookies | string[] | Liste der Namen aller akzeptierten Cookies. |
CCM.acceptedEmbeddings | object[] | Liste aller akzeptieren Einbindungen. |
CCM.consent | bool | Wahr, wenn der Consent-Dialog geschlossen wurde. |
CCM.ucid | ?string | Eindeutige Consent-ID. null, wenn noch kein Consent erteilt wurde. |
Methoden
Name | Beschreibung |
---|---|
CCM.closeControlPanel() | Schließt den Dialog zur Auswahl der zu akzeptierenden Zwecke. |
CCM.openControlPanel() | Öffnet den Dialog zur Auswahl der zu akzeptierenden Zwecke. |
CCM.closeWidget() | Schließt den Cookie-Dialog. |
CCM.openWidget() | Öffnet den Cookie-Dialog. |
Alternativ können Sie die Dialoge auch über Links mit den Zielen #CCM.openWidget, #CCM.closeWidget, #CCM.openControlPanel und #CCM.closeControlPanel steuern.
Events
Die Ereignisse des CCM werden auf dem globalen window-Objekt ausgeführt.
Name | Beschreibung |
---|---|
ccm19EmbeddingAccepted | Wird ausgelöst, sobald eine Einbindung durch den Benutzer akzeptiert wurde. Dieser Event erfolgt sowohl beim Erteilen der Zustimmung, als auch beim wiederholten Seitenaufruf. |
ccm19WidgetLoaded | Wird ausgelöst, sobald die Initialisierung des CCM abgeschlossen ist. |
ccm19WidgetClosed | Wird ausgelöst, sobald das letzte sichtbare CCM1-Widget-Element geschlossen wird. Dabei kann es sich um ein Resultat eines Klicks auf einen Speichern-Button handeln, der zum Schließen des Widgets führt. |
ccm19CookieAccepted | Ein Cookie wurde durch den Nutzer akzeptiert. Dieses Event wird für jedes Cookie ausgelöst, das in den akzeptierten Zwecken gelistet ist. Diese Events erfolgen beim Erteilen des Consents durch den Besucher und werden bei jeden folgenden Seitenbesuch beim Laden der Seite wiederholt. |
<div class="ccm-cookie-declaration">Bitte aktivieren Sie Javascript, um die Liste aller deklarierten Cookies und ähnlicher Techniken zu sehen.</div>