Cookie-Banner Integration Guide

Integrieren Sie den BreakPilot Cookie-Banner in 3 Schritten auf Ihrer Website. DSGVO-konform, mit Script-Blocking und Google Consent Mode v2.

Unser Banner ist rechtlich geprueft

Der Banner erfuellt automatisch alle 8 Compliance-Checks die unser Agent prueft: Impressum-Link, DSE-Link, gleichwertige Buttons, keine vorausgewaehlten Checkboxen, Settings-Reopen, kein Dark Pattern, Google Consent Mode v2.

Schritt 1: Script-Tag einbinden

Fuegen Sie eine einzige Zeile in den <head> Ihrer Website ein:

<!-- BreakPilot Cookie-Banner -->
<script src="https://sdk.breakpilot.ai/cookie-banner.js"
        data-tenant="IHRE-TENANT-ID"
        data-language="de">
</script>

Schritt 2: Tracking-Scripts blockieren

Aendern Sie den type Ihrer Tracking-Scripts vontext/javascript zu text/plain und fuegen Sie das data-cookie-category Attribut hinzu:

<!-- VORHER (laedt sofort — DSGVO-Verstoss!): -->
<script src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"></script>

<!-- NACHHER (laedt erst nach Consent): -->
<script type="text/plain"
        data-cookie-category="statistics"
        src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX">
</script>

Schritt 3: Kategorien zuordnen

Kategorie	data-cookie-category	Beispiele
Notwendig	`necessary`	Session-Cookies, CSRF-Token
Statistik	`statistics`	Google Analytics, Matomo, Hotjar
Marketing	`marketing`	Facebook Pixel, Google Ads, LinkedIn
Funktional	`functional`	Chat-Widget, Spracheinstellung

Schritt 4: Fertig — automatische Features

Google Consent Mode v2 — automatisch integriert, keine zusaetzliche Konfiguration
Impressum + DSE Links — im Banner enthalten
Settings-Reopen — schwebendes "Cookie-Einstellungen" Icon
Gleichwertige Buttons — Akzeptieren und Ablehnen gleich gross
Server-seitige Speicherung — Consent wird revisionssicher gespeichert

API-Integration (optional)

Fuer programmatische Kontrolle:

// Consent-Status abfragen
if (window.CookieConsent.hasConsent('statistics')) {
  // Analytics-Code ausfuehren
}

// Banner erneut oeffnen
window.CookieConsent.show();

// Consent programmatisch setzen
window.CookieConsent.saveConsent({
  necessary: true,
  statistics: false,
  marketing: false,
  functional: true,
});