Javascript- APIs
CCM19 bietet mehrere Javascript
Globales Objekt
Die direkten Steuerungsmöglichkeiten von CCM19 sind im globalen JavascriptCCM gebündelt:
-
{
id: string,
name: string,
}
, …
]
(ab Version 2020.10.28) ['de_DE', 'en_US']
(ab Version 2022.03.24)
(ab Version 2020.10.14) 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)
(ab Version 2020.10.28)
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().
In Abhängigkeit von 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.
Bitte nur einmal pro Benutzerinteraktion aufrufen, nicht wiederholt pro Seitenaufruf.
Seit Version 2023.07.17 wird zusätzlich das Event ccm19WidgetClosed ausgelöst.
• noch kein Consent konfiguriert wurde (erster Seitenbesuch) oder
• sich in der CCM19
• die festgelegte Gültigkeitsdauer abgelaufen ist.
Dieser Wert sollte bei jedem Seitenaufruf überprüft und berücksichtigt werden.
In den obigen Fällen wird seit Version 2023.07.17 zusätzlich das Event 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 Fallback
(nach Version 2024.03.13)
(ab Version 2023.06.01)
(ab Version 2023.06.01)
Mit CCM.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.
-
name: string,
code: string,
purpose: string,
mandatory: boolean,
}
Veraltet: Bitte auf ccm19EmbeddingAccepted umsteigen.
name: string,
code: string,
purpose: string,
mandatory: boolean,
}
(ab Version 2020.10.28)