Dokumentation / Skript-Installation

Installation des Cookienovo-Skripts

Technische Informationen zum Cookienovo-Banner für Entwickler: wie man das Skript einfügt, Tags konfiguriert, Skripte nach Kategorie blockiert und Google Consent Mode v2 anbindet.

Skript einfügen

Damit Ihre Website den Cookienovo-Banner anzeigt und Cookie-Einwilligungen erfasst, fügen Sie unser Skript in den Quellcode der Seite ein. Sie finden es in Ihrem Cookienovo-Konto (Sie haben es auch per E-Mail bei der Registrierung erhalten). Fügen Sie das Skript in den Abschnitt ein <head>, so weit oben wie möglich — vor Google Tag Manager und andere Mess-Skripte.

Die Installation besteht aus zwei Teilen: (1) einem Inline-Skript, das synchron die Standard-Einwilligungen von Google Consent Mode v2 setzt vor dem Auslösen jeglicher Google-Tags, und (2) das eigentliche Banner-Skript:

<!-- Krok 1: predvolené súhlasy PRED akýmikoľvek Google tagmi -->
<script>
window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}
gtag('consent','default',{
  'ad_storage':'denied','ad_personalization':'denied','ad_user_data':'denied',
  'analytics_storage':'denied','functionality_storage':'denied',
  'personalization_storage':'denied','security_storage':'granted','wait_for_update':500
});
gtag('set','ads_data_redaction',true);
</script>

<!-- Krok 2: banner Cookienovo (možno použiť defer) -->
<script site-token="<site-token>" type="text/javascript"
        src="https://cookienovo.com/assets/client.js" defer></script>

Verwenden Sie ein Optimierungs- oder Cache-Plugin (WP Rocket, LiteSpeed Cache, Autoptimize, SG Optimizer, W3 Total Cache…)? Schließen Sie das Cookienovo-Skript von dessen Änderungen aus — insbesondere von der JavaScript-Minifizierung/-Kombinierung und der verzögerten Ausführung (Delay JavaScript). Fügen Sie den Ausnahmelisten hinzu cookienovo und leeren Sie nach der Änderung den Plugin-Cache. Andernfalls wird der Cookie-Banner möglicherweise nicht angezeigt.

Skript-Tags

Das Cookienovo-Banner-Skript unterstützt diese Attribute:

site-token — erforderlich. Die UUID Ihrer Website aus dem Cookienovo-Konto (Sie haben sie auch per E-Mail erhalten). Ohne den richtigen Token wird der Banner nicht angezeigt.
theme — optional. Erzwingt das Design des Banners: "light" oder "dark".
consent-mode — optional. Überschreibt den Einwilligungsmodus des Banners. Standardmäßig "true"; stellen Sie ein "false", wenn Sie keine Einwilligungen senden möchten.

Skriptblockierung nach Kategorie

Damit Mess- und Marketing-Skripte erst nach der Einwilligung ausgeführt werden, weisen Sie ihnen über das Attribut eine Kategorie zu cn-category. Der Cookienovo-Banner führt sie dann nur aus, wenn der Besucher die jeweilige Kategorie erlaubt:

<script type="text/javascript" cn-category="analytics">
  // analytický skript
</script>

Mögliche Werte des Attributs cn-category: necessary (notwendig), functional (funktional), analytics (Analyse), marketing.

Ereignisverarbeitung

Wenn Sie den Einwilligungsstatus in eigenen Skripten verarbeiten möchten, hören Sie auf das Ereignis CookienovoUserConsentChanged:

<script type="text/javascript">
  document.addEventListener("CookienovoUserConsentChanged", (e) => {
    console.log("súhlas zmenený", e.detail);
  });
</script>

Im Objekt detail finden Sie den Einwilligungsstatus für jede Kategorie (Kategorie + boolescher Wert, ob der Nutzer sie erlaubt hat):

{
  "detail": [
    { "category": "necessary",  "allowed": true  },
    { "category": "analytics",  "allowed": false },
    { "category": "functional", "allowed": true  },
    { "category": "marketing",  "allowed": true  }
  ]
}

Google Consent Mode v2

Cookienovo erfüllt Google Consent Mode v2 vollständig und richtet ihn automatisch ein — ohne Zutun des Nutzers oder Administrators. Die Standard-Einwilligungen werden sofort beim Laden der Seite gesetzt und nach der Auswahl des Besuchers aktualisiert.

Dank der zweiteiligen Installation (Inline-Standard-Einwilligungen + Banner-Skript) sind die Signale ad_storage, analytics_storage, ad_user_data und ad_personalization standardmäßig eingestellt auf 'denied' noch vor dem Auslösen der Google-Tags. Der Ansatz folgt Branchenstandards und funktioniert auch mit asynchron geladenen Google-Tags. Die Standardwerte umfassen wait_for_update:500 und ads_data_redaction:true für maximalen Datenschutz.

Mehr in Google-Dokumentation.

Debug-Funktionen

Zur Überprüfung der Consent-Mode-v2-Implementierung bietet Cookienovo Debug-Funktionen, die Sie in der Browserkonsole ausführen. Öffnen Sie die Konsole (F12) auf einer beliebigen Seite mit installiertem Cookienovo und führen Sie aus:

// zapni debug režim a spusti plnú validáciu
window.cookienovoDebug.enableDebugMode()

// len validačné kontroly
window.cookienovoDebug.runFullValidation()

// report súladu
window.cookienovoDebug.generateComplianceReport()

// stav Consent Mode
window.cookienovoDebug.checkConsentMode()

// test implementácie
window.cookienovoDebug.testConsentModeImplementation()

// kontrola Shopify integrácie
window.cookienovoDebug.checkShopifyIntegration()

Die Funktionen geben detaillierte Informationen zu Ihrer Implementierung aus: Compliance-Score, erkannte Google-Tags, Probleme und konkrete Empfehlungen. Die Diagnose können Sie auch starten aus dem Dashboard ohne die Konsole zu öffnen.

Automatische Tracker-Blockierung

Cookienovo kann Tracker von Drittanbietern außerhalb von Google (z. B. Facebook Pixel, Hotjar oder Microsoft Clarity) automatisch neutralisieren vor der Einwilligung und sie in dem Moment wieder aktivieren, in dem der Besucher die jeweilige Kategorie erlaubt. Die Google-Tags werden separat über Consent Mode v2 geregelt, sodass sie nicht manuell blockiert werden müssen.

Bei unterstützten Trackern sind keine Codeänderungen erforderlich. Die Blockierung erfolgt nach bestem Bemühen: Sie deckt die Liste bekannter Tracker und direkt eingebettete Skripte ab in <head> können einmal ausgelöst werden, bevor der Blocker startet. Um jedes beliebige Skript sicher zu blockieren, markieren Sie es manuell gemäß der Anleitung oben. Die automatische Blockierung aktivieren oder deaktivieren Sie selbst in den Banner-Einstellungen Ihrer Website — der Schalter „Automatische Blockierung von Trackern“. Bei neuen Websites ist sie standardmäßig aktiviert.

Link in der Fußzeile: Cookie-Einstellungen erneut öffnen

Standardmäßig ermöglicht eine kleine schwebende Schaltfläche „Cookies“ den Besuchern, ihre Präferenzen erneut zu öffnen. Wenn Sie sie ausblenden möchten (stellen Sie das Symbol auf Ausgeblendet in den Banner-Einstellungen) und das Präferenzzentrum über einen eigenen Link öffnen — zum Beispiel „Cookie-Einstellungen“ im Footer — fügen Sie einem beliebigen Element das Attribut hinzu data-cookienovo-settings:

<a href="#" data-cookienovo-settings>Nastavenia cookies</a>

Oder öffnen Sie es programmatisch aus Ihrem eigenen JavaScript:

window.cookienovo.showConsentSettings()