Consent Ready API

Fügen Sie den UniConsent-Tag einmal mit Ihrem Lizenzschlüssel ein. Der Tag definiert sofort zwei Funktionen und lädt anschließend die vollständige CMP im Hintergrund.

<script src="https://cmp.uniconsent.com/v2/cmp.js" data-license="YOUR_LICENSE"></script>

Den Lizenzschlüssel finden Sie im Bereich Install & Setup. Die vollständige Installationsanleitung, einschließlich des klassischen zweiteiligen Tags für bestehende Installationen, finden Sie unter UniConsent-Tags für Web installieren.

unicReady(callback)

Wird einmal ausgelöst, sobald der Einwilligungsstatus endgültig ist.

• DSGVO und IAB TCF Canada: nachdem der Nutzer eine Auswahl getroffen hat oder eine gespeicherte Auswahl wiederhergestellt wurde.
• CCPA / US-Bundesstaatengesetze / andere Opt-out-Regionen: sobald die CMP geladen ist.
• Einwilligungskategorien-Banner: nach der Auswahl in Ihrer DSGVO-Region oder überall, wenn die DSGVO weltweit gilt, außer in Kalifornien, wenn CCPA aktiviert ist, und in Kanada, wenn IAB TCF Canada aktiviert ist. Anderswo, sobald die CMP lädt. Prüfen Sie daher UNIC_EP_1 … UNIC_EP_4, bevor Sie Tags für zustimmungspflichtige Kategorien laden.

Wer sich erst nach dem Auslösen anmeldet, wird sofort zurückgerufen.

unicReady(function (status) {
  if (status.UNIC_P_1) {
    loadAnalytics();
  }
});

unicUpdate(callback)

Wird zeitgleich mit unicReady ausgelöst und danach bei jeder Änderung der Einwilligung (zum Beispiel wenn der Nutzer die Einstellungen erneut öffnet und einen Zweck ändert). Eine späte Anmeldung wird sofort mit dem aktuellen Status zurückgerufen, danach bei jeder weiteren Änderung. Speichervorgänge ohne Änderung werden ignoriert.

unicUpdate(function (status) {
  applyConsent(status);
});

DOM-Events

Dieselben Daten werden auf window als unic:ready und unic:update ausgelöst. Registrieren Sie die Listener vor dem Tag, damit sie beim Auslösen der Events vorhanden sind.

window.addEventListener('unic:update', function (e) {
  applyConsent(e.detail);
});

Synchrones Laden

Platzieren Sie Ihren Code an beliebiger Stelle nach dem Tag. Mehr ist nicht erforderlich.

<script src="https://cmp.uniconsent.com/v2/cmp.js" data-license="YOUR_LICENSE"></script>
<script>
  unicReady(function (status) { /* Einwilligung ist endgültig */ });
  unicUpdate(function (status) { /* jede Änderung */ });
</script>

Asynchrones Laden

Mit async kann Ihr Inline-Code vor dem Tag ausgeführt werden. Fügen Sie den zweizeiligen Queue-Guard hinzu, damit frühe Aufrufe nach dem Laden des Tags nachgeholt werden.

<script async src="https://cmp.uniconsent.com/v2/cmp.js" data-license="YOUR_LICENSE"></script>
<script>
  window.unicReady  = window.unicReady  || function (cb) { (window.unicReady.q  = window.unicReady.q  || []).push(cb); };
  window.unicUpdate = window.unicUpdate || function (cb) { (window.unicUpdate.q = window.unicUpdate.q || []).push(cb); };

  unicReady(function (status) { /* Einwilligung ist endgültig */ });
  unicUpdate(function (status) { /* jede Änderung */ });
</script>

Status-Objekt

Hinweise

• unicReady und unicUpdate sind reservierte Namen auf window. Definieren Sie keine Funktionen mit diesen Namen für andere Zwecke.
• Callbacks sind in try/catch eingeschlossen. Ein Fehler in einem Callback stoppt die anderen nicht.
• Beide Funktionen akzeptieren beliebig viele Abonnenten.
• Der Tag ignoriert sich selbst, wenn das CMP-Skript bereits auf der Seite ist.
• Der Tag setzt einen Google Consent Mode-Standard mit allen Speicherarten auf „denied" und einem wait_for_update von 3 Sekunden. Wenn Sie bereits eigene Consent Mode-Standards setzen, platzieren Sie diese nach dem Tag, sonst werden sie überschrieben.

Verwandte Themen

• UniConsent-Tags für Web installieren
• UniConsent JavaScript API
• Integration von Drittanbieter-JavaScript-Tags
• Google Consent Mode

Noch Fragen?

Kontaktieren Sie uns: support@uniconsent.com