Javascript- APIs
CCM19 bietet mehrere Javascript
Globales Objekt
Die direkten Steuerungsmöglichkeiten von CCM19 sind im globalen JavascriptCCM gebündelt:
string, name: string, } , … ] ['de_DE', 'en_US'] (ab Version 2022.03.24) CCM.consent. (nach Version 2023.03.29) location.href = url), berücksichtigt dabei aber die Consentreplace steuert, ob location.replace verwendet wird und navigateTop steuert, ob bei Frames die vollständige Seite navigiert wird. (ab Version 2020.10.14) CCM.availableLocales()(ab Version 2022.03.24)
Die Dialoge können alternativ auch über Links mit den Zielen #CCM.openWidget, #CCM.closeWidget, #CCM.openControlPanel und #CCM.closeControlPanel gesteuert werden.
Erweiterung für werbe- und trackingfreie Netzwerke
Sofern die Option "Meine Website ist Teil eines werbe
Die folgenden Endpunkte wurden mit der Version 2023.03.20 veröffentlicht und sind in älteren Versionen nicht verfügbar.
-CCM.revokeAllPrivileges(). CCM.requiresConsentUpdate kann eine erneute Zustimmung erforderlich sein. Bitte nur einmal pro Benutzerinteraktion aufrufen, nicht wiederholt pro Seitenaufruf. Seit Version 2023.07.17 wird zusätzlich das Event ccm19WidgetClosed ausgelöst. ccm19WidgetClosed ausgelöst. ccm19WidgetOpened ausgelöst. assets (Cookies) werden Übersetzungen für alle Sprachen geliefert, die für das Frontend aktiv sind. • CCM.embeddings[].name
• CCM.embeddings[].vendor
• CCM.embeddings[].l10n.de_DE
• CCM.embeddings[].l10n.en_US
• CCM.embeddings[].l10n._ • CCM.embeddings[].assets[].name • CCM.embeddings[].assets[].type • CCM.embeddings[].assets[].l10n Mit l10n._ stehen neben den aktiven Locales noch die Spracheinträge der FallbackCCM.tcf.vendors.map(x => x.id) können die IDs aller aktiven Anbieter ausgelesen werden. Bis Version 2023.05.25 war diese Eigenschaft noch als Objekt statt als Array implementiert; die Anpassung hat in Absprache mit dem ersten Nutzer dieses Features stattgefunden.
Da die obigen Schnittstellen nur verfügbar sind, wenn die entsprechende Option für werbe
if (typeof window.CCM == 'object' && typeof window.CCM.denyAllPrivileges == 'function') {
// Option "Meine Website ist Teil eines werbe<nt>-</nt> und trackingfreien Netzwerks" ist aktiv
// und der Zugriff auf die Eigenschaften kann erfolgen.
}
else {
console.log('Bitte Option in CCM19 aktivieren.');
}
Javascript- Events
Einige Ereignisse in CCM19 werden zu CustomEvents auf dem windowwindow.addEventListener(…) kann darauf reagiert werden.
string, code: string, purpose: string, mandatory: boolean, } ccm19EmbeddingAccepted umsteigen. string, code: string, purpose: string, mandatory: boolean, }