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&amp;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>

Javascript-API

Der CCM bietet eine Javascript-API, mit welcher auf Eigenschaften und Funktionalitäten zugegriffen werden können. Somit erhalten Sie die volle Kontrolle und können noch besser auf Benutzerinteraktionen reagieren. 

Eigenschaften

NameTypBeschreibung
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

NameBeschreibung
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. 

NameBeschreibung
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.

Cookie Tabelle

Über das folgende Code Snippet können Sie auf Ihrer Datenschutzsseite eine Cookie Tabelle anzeigen lassen.

<div class="ccm-cookie-declaration">Bitte aktivieren Sie Javascript, um die Liste aller deklarierten Cookies und ähnlicher Techniken zu sehen.</div>