FitConsent CMP Dokumentation
Vollständige Installations- und Konfigurationsanleitung für FitConsent CMP. Cookie-Consent-Banner einrichten, Google Consent Mode V2 und Microsoft UET konfigurieren und DSGVO, CCPA sowie über 15 globale Datenschutzvorschriften einhalten.
Einführung
Willkommen zur Dokumentation der FitConsent Consent Management Plattform (CMP). Diese Anleitung deckt alles ab, was Sie benötigen, um FitConsent zu installieren, zu konfigurieren und optimal zu nutzen — vom ersten Script-Tag bis zur erweiterten Verarbeitung von Einwilligungsdaten.
Was ist eine Consent Management Plattform (CMP)?
Eine Consent Management Plattform (CMP) ist ein Tool, das Websites hilft, die Einwilligung der Nutzer zur Datenverarbeitung rechtlich einzuholen und zu verwalten — eine Anforderung nach Datenschutzgesetzen wie der DSGVO in Europa und dem CCPA/CPRA in Kalifornien. Es ist die Technologie hinter den Cookie-Bannern, die Sie auf Websites weltweit sehen.
FitConsent geht über ein einfaches Banner hinaus. Es bietet die Werkzeuge, um gesetzlich konform zu bleiben und das Vertrauen der Nutzer zu stärken, indem die Einwilligungserfahrung optimiert wird. Unser Service umfasst vollständige, automatische Unterstützung für Google Consent Mode V2 und Microsoft UET Consent Mode.
Wichtigste Funktionen
Automatische Integration von Google Consent Mode V2 und Microsoft UET Consent Mode
Unterstützung von 16 globalen Datenschutz-Rahmenwerken: DSGVO, CCPA, TCF, ePrivacy, UCPA, VCDPA, CTDPA, LGPD, PIPEDA, APPI, PDPA, APA-NZPA, FADP, POPIA und mehr
Über 100 Sprachen mit automatischer Spracherkennung
KI-gestützter Banner-Optimierer (Pro+ Pläne)
Speicherdeklaration (Cookie-Tabelle) für Datenschutzseiten
Schwebende Auslöser-Schaltfläche für Einwilligungsaktualisierungen
Echtzeit-Vorschau im Dashboard
Integriertes Diagnosewerkzeug zur Installationsüberprüfung
Installation & Einrichtung
Die Integration von FitConsent ist darauf ausgelegt, schnell und unkompliziert zu sein. Wählen Sie die Methode, die am besten zu Ihrer Website-Plattform passt.
Voraussetzungen
Stellen Sie sicher, dass Sie Folgendes haben:
Ein FitConsent-Konto erstellt und Ihre Website im Dashboard registriert
Ihre eindeutige Website-ID (auf der Konfigurationsseite Ihrer Website)
Entschieden, welches Datenschutz-Rahmenwerk für Ihre Zielgruppe gilt
Direkteinbettung
Für Standard-HTML-Websites kopieren Sie den folgenden Code und fügen ihn so hoch wie möglich im <head>-Bereich ein — vor allen Google Analytics-, Google Ads- oder Microsoft UET-Tags.
<!-- FitConsent CMP: Standard-Einwilligungen VOR allen anderen Scripts festlegen -->
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
window.uetq = window.uetq || [];
// Standard-Einwilligung: verweigert bis zur Nutzerinteraktion
gtag('consent', 'default', {
'ad_storage': 'denied',
'ad_user_data': 'denied',
'ad_personalization': 'denied',
'analytics_storage': 'denied'
});
window.uetq.push('consent', 'default', { 'ad_storage': 'denied' });
</script>
<!-- Laden Sie hier Ihre anderen Scripts (Google Analytics, UET usw.) -->
<!-- FitConsent Banner: aktualisiert die Einwilligung basierend auf Nutzerinteraktion -->
<script async defer src="https://app.fitconsent.com/api/banner?websiteId=IHRE_WEBSITE_ID"></script>Ersetzen Sie IHRE_WEBSITE_ID durch Ihre tatsächliche Website-ID aus dem Dashboard. Dieses Script muss vor jedem Tag erscheinen, der Cookies liest oder setzt.
Google Tag Manager (Empfohlen)
Die Verwendung des offiziellen FitConsent GTM Community-Templates ist die empfohlene Installationsmethode. Es verwaltet korrekt die Standard-Einwilligungen und integriert sich in GTMs Einwilligungsübersicht.
Schritt 1: Einwilligungsübersicht aktivieren
1. Klicken Sie in Ihrem GTM-Arbeitsbereich auf den Tab "Verwaltung".
2. Klicken Sie unter "Container" auf "Container-Einstellungen".
3. Aktivieren Sie "Einwilligungsübersicht aktivieren" und klicken Sie auf "Speichern".
Schritt 2: FitConsent-Template hinzufügen
1. Gehen Sie zu "Templates" > "Tag-Templates" > "Galerie durchsuchen".
2. Suchen Sie nach "FitConsent" und klicken Sie auf "Zum Arbeitsbereich hinzufügen".
3. Bestätigen Sie die Berechtigungsabfrage.
Schritt 3: "Google Consent Default"-Tag erstellen
1. Gehen Sie zu "Tags" > "Neu", benennen Sie ihn "FitConsent – Standard-Einwilligung".
2. Wählen Sie "FitConsent" als Tag-Typ.
3. Wählen Sie im Dropdown "Tag-Typ" die Option "Google Consent Default".
4. Geben Sie Ihre Website-ID in das Feld "FitConsent Website ID" ein.
5. Setzen Sie den Auslöser auf "Einwilligungsinitialisierung – Alle Seiten".
6. Speichern Sie den Tag.
Schritt 4: "Banner-Loader"-Tag erstellen
1. Erstellen Sie einen neuen Tag namens "FitConsent – Banner-Loader".
2. Wählen Sie "FitConsent" als Tag-Typ (Standard: "FitConsent Banner Loader").
3. Geben Sie Ihre Website-ID ein und setzen Sie den Auslöser auf "Einwilligungsinitialisierung – Alle Seiten".
4. Speichern Sie den Tag.
Schritt 5: Google-Tag konfigurieren
Falls Sie bereits einen Google-Tag (GA4) haben: Tag bearbeiten > "Erweiterte Einstellungen" > "Einwilligungseinstellungen" > "Keine zusätzliche Einwilligung erforderlich" auswählen.
Schritt 6: Drittanbieter-Scripts verwalten
Für Scripts wie Microsoft Clarity oder Meta Pixel: Tag bearbeiten > "Erweiterte Einstellungen" > "Einwilligungseinstellungen" > "Zusätzliche Einwilligung für Tag-Auslösung erforderlich" > analytics_storage oder ad_storage hinzufügen.
Klicken Sie auf "Senden" und "Veröffentlichen" Ihren GTM-Container.
WordPress-Plugin
FitConsent ist als offizielles Plugin auf WordPress.org verfügbar. Es bietet automatische Kompatibilität mit der WP Consent API, dem Standard für die Google Site Kit-Integration.
Installation über das WordPress-Dashboard
1. Gehen Sie zu "Plugins" > "Installieren".
2. Suchen Sie nach "FitConsent CMP" und klicken Sie auf "Jetzt installieren", dann "Aktivieren".
Konfiguration nach der Installation
1. Gehen Sie zu "Einstellungen" > "FitConsent".
2. Geben Sie Ihre FitConsent-Website-ID ein.
3. Klicken Sie auf "Änderungen speichern".
Wenn Sie Google Site Kit verwenden, aktivieren Sie den "Einwilligungsmodus" in dessen Einstellungen. FitConsent kommuniziert automatisch über die WP Consent API mit Site Kit.
Andere Plattformen
FitConsent funktioniert mit jeder Plattform, die benutzerdefiniertes HTML oder JavaScript erlaubt (Shopify, Drupal, Webflow usw.). Verwenden Sie bevorzugt die GTM-Integration, andernfalls die Direkteinbettungsmethode.
Banner konfigurieren
Die gesamte Konfiguration wird über das FitConsent-Dashboard verwaltet. Öffnen Sie die Konfigurationsseite Ihrer Website, um auf alle Einstellungen zuzugreifen. Änderungen werden im rechten Panel in Echtzeit vorschaut.
Allgemeine Einstellungen
Domain: Die Domain Ihrer Website (z.B. example.com).
Google Analytics Mess-ID: Geben Sie Ihre GA4-Mess-ID ein (z.B. G-XXXXXXXXXX).
Rahmenwerk: Wählen Sie das Datenschutz-Rahmenwerk für Ihre Besucher.
| Rahmenwerk | Geeignet für | Region |
|---|---|---|
| Auto | Wendet DSGVO oder CCPA automatisch je nach Besucherstandort an | Global |
| DSGVO | EU-Datenschutz-Grundverordnung | Europäische Union / EWR |
| CCPA | California Consumer Privacy Act | Kalifornien, USA |
| ePrivacy | EU-ePrivacy-Richtlinie (Cookie-Gesetz) | Europäische Union |
| TCF | IAB Transparenz- und Einwilligungs-Rahmenwerk | Verlage & Werbenetzwerke |
| UCPA | Utah Consumer Privacy Act | Utah, USA |
| VCDPA | Virginia Consumer Data Protection Act | Virginia, USA |
| CTDPA | Connecticut Data Privacy Act | Connecticut, USA |
| LGPD | Brasilianisches Datenschutzgesetz | Brasilien |
| PIPEDA | Kanadisches Datenschutzgesetz | Kanada |
| APPI | Japanisches Gesetz zum Schutz personenbezogener Daten | Japan |
| PDPA | Thailändisches Datenschutzgesetz | Thailand |
| APA-NZPA | Australische & Neuseeländische Datenschutzgesetze | Australien / Neuseeland |
| FADP | Schweizer Bundesgesetz über den Datenschutz | Schweiz |
| POPIA | Südafrikanisches Datenschutzgesetz | Südafrika |
| Keine | Kein automatisches Rahmenwerk — vollständige manuelle Kontrolle | Beliebig |
Für Websites mit internationalem Publikum wählen Sie "Auto". FitConsent zeigt automatisch die DSGVO-Banner für EU-Besucher und CCPA-Banner für Besucher aus Kalifornien.
Geo-Targeting: Wählen Sie, wer das Banner sieht:
Keine — Alle Besucher sehen das Banner
DSGVO — Nur Besucher aus EU/EWR-Ländern sehen das Banner
Zusätzliche Domains
Verfügbar für die Pläne Pro Large und Business. Mit zusätzlichen Domains können Sie dasselbe Banner auf bis zu 5 weiteren Domains laden — nützlich für Staging-Umgebungen, regionale Domains oder Multi-Brand-Setups.
So fügen Sie eine zusätzliche Domain hinzu:
1. Öffnen Sie die Konfigurationsseite Ihrer Website im Dashboard.
2. Gehen Sie zur Registerkarte Allgemeine Einstellungen.
3. Scrollen Sie zur Karte Zusätzliche Domains.
4. Klicken Sie auf Domain hinzufügen und geben Sie den reinen Hostnamen ein (z. B. staging.example.com oder meinemarke.de) — ohne https://-Präfix oder abschließenden Schrägstrich.
5. Wiederholen Sie dies für bis zu 5 Domains und speichern Sie dann Ihre Konfiguration.
Wenn der Bereich Zusätzliche Domains trotz eines Pro Large- oder Business-Plans gesperrt erscheint, wenden Sie sich an den Support — Ihr Abonnement wurde möglicherweise noch nicht korrekt auf diese Website angewendet.
Einwilligungsmodus
Erweiterter Modus (Empfohlen)
Google-Tags laden sofort, arbeiten aber mit eingeschränkter Datenerfassung, bis die Einwilligung erteilt wird.
Vor der Einwilligung: Tags senden anonyme "cookielose Pings" — keine identifizierenden Cookies werden gesetzt.
Nach der Einwilligung: Vollständige Datenerfassung basierend auf den Nutzerauswahlen.
Hauptvorteil: Ermöglicht Googles Konversionsmodellierung zur Wiederherstellung verlorener Attributionsdaten.
Basismodus (Striktes Blockieren)
Alle Tracking-Scripts werden vollständig blockiert, bis der Nutzer aktiv einwilligt.
<!-- Blockiertes Script für den Basismodus -->
<script
type="text/plain"
data-cookieconsent="analytics"
async
src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXX">
</script>Kategorie-Zuordnung:
analytics → Google Analytics (GA4), Microsoft Clarity
marketing → Google Ads, Meta Pixel, LinkedIn
functional → Chatbots, Personalisierungstools
| Funktion | Basismodus | Erweiterter Modus |
|---|---|---|
| Google-Tags | Blockiert bis Einwilligung | Laden sofort (eingeschränkt) |
| Daten vor Einwilligung | Keine Daten | Cookielose Pings (Modellierung) |
| Datenschutzniveau | Strengstes | DSGVO / DMA-konform |
| Konversionsmodellierung | Nicht verfügbar | Verfügbar |
Erscheinungsbild
Layout & Animation
Typ: Banner (horizontale Leiste) oder Dialog (zentrierte Überlagerung)
Position: Unten, Oben, Unten-Links, Unten-Rechts, Oben-Links, Oben-Rechts, Mitte
Animationsstil: Spring (federnd), Slide (gleitend), Fade (Überblendung), Keine
Randakzent: Keine, Oben, Links (farbiger Streifen), Verlauf
Typografie
Schriftart: Inter, DM Sans, Plus Jakarta Sans, Nunito, Outfit, Lato, Poppins, Raleway, Merriweather, Playfair Display, Source Code Pro
Titelausrichtung: Links, Mitte, Rechts
Form & Tiefe
Randradius: Keine, SM, MD, LG, XL, 2XL
Schaltflächen-Randradius: Keine, SM, MD, LG, XL, Vollständig
Erhöhung (Schatten): Keine, SM, MD, LG, XL
Farben
Jedes Farbfeld unterstützt unabhängig hellen Modus und dunklen Modus:
Textfarbe, Titelfarbe, Hintergrundfarbe
Schaltflächenfarbe, Schaltflächen-Textfarbe, Schaltflächen-Randfarbe
Trennlinienfarbe, Aktive Tab-Farbe, Inaktive Tab-Farbe
Logo & Hintergrundbild
Logo-URL: Zeigen Sie Ihr Unternehmenslogo auf dem Banner an.
Hintergrundbild: Separate Bilder für Desktop Hell, Desktop Dunkel, Mobil Hell und Mobil Dunkel.
Inhalt & Sprachen
Bearbeitbare Textfelder:
Banner-Überschrift
Banner-Nachricht (unterstützt Markdown: fett, *kursiv*, [Link](url))
"Alle akzeptieren" Schaltflächenbezeichnung
"Ablehnen" Schaltflächenbezeichnung
"Einstellungen verwalten" Schaltflächenbezeichnung
Titel und Beschreibung des Einstellungs-Modals
"Einstellungen speichern" Schaltflächenbezeichnung
Tab-Bezeichnungen für Einwilligung, Einstellungen, Speicherdeklaration
Verhaltenseinstellungen
Schaltflächen
Ablehnungsschaltfläche aktivieren: "Ablehnen"-Option anzeigen oder ausblenden.
Verwaltungsschaltfläche aktivieren: "Einstellungen verwalten"-Option anzeigen oder ausblenden.
Einwilligungskategorien
Notwendig (immer aktiv): Grundlegende Cookies für den Betrieb der Website
Analyse: Website-Analyse und Leistungsmessung
Marketing: Werbung und Remarketing
Funktional: Personalisierung und erweiterte Funktionalität
Schwebende Auslöser-Schaltfläche
Aktivieren: Schwebende Auslöser-Schaltfläche ein- oder ausschalten.
Position: Unten-Links oder Unten-Rechts.
Farben: Hintergrundfarbe und Symbolfarbe für hell und dunkel.
CCPA-spezifische Einstellungen
"Nicht verkaufen"-Link: URL zu Ihrer "Meine persönlichen Daten nicht verkaufen"-Seite.
"Nutzung einschränken"-Link: URL zu Ihrer entsprechenden Seite.
Datenverkauf: Zeigt an, ob Ihre Website personenbezogene Daten verkauft oder teilt.
KI-gestützter Optimierer
Verfügbar in Pro+ Plänen. Der KI-Optimierer analysiert den Inhalt, das Branding und die Zielgruppe Ihrer Website und schlägt optimale Farbkombinationen, Banner-Texte und Layout-Verbesserungen vor.
Speicherdeklaration
FitConsent kann eine automatisch aktualisierte Tabelle aller Cookies und Speicherelemente Ihrer Website anzeigen. Ideal für Datenschutzseiten.
Standard HTML
<div id="fitconsent-declaration"></div>
<script async defer src="https://app.fitconsent.com/api/declaration?websiteId=IHRE_WEBSITE_ID"></script>React & Next.js
Um Hydratisierungsfehler zu vermeiden, laden Sie das Script client-seitig mit einem useEffect-Hook.
'use client';
import { useEffect } from 'react';
type Props = {
websiteId: string;
};
export function StorageDeclarationEmbed({ websiteId }: Props) {
useEffect(() => {
const script = document.createElement('script');
script.src = `https://app.fitconsent.com/api/declaration.js?websiteId=${websiteId}`;
script.async = true;
script.defer = true;
const container = document.getElementById('fitconsent-declaration');
if (container) {
container.appendChild(script);
}
return () => {
if (container && container.contains(script)) {
container.removeChild(script);
}
};
}, [websiteId]);
return <div id="fitconsent-declaration"></div>;
}Dieser Ansatz stellt sicher, dass das Script sicher client-seitig geladen wird, ohne Konflikte mit dem React-Rendering-Lebenszyklus.
Erweiterte Nutzung
Einwilligungsdaten auf Ihrer Website verwenden
Nach der Nutzerinteraktion speichert FitConsent die Einwilligungen in einem Cookie namens fitconsent_given.
Cookie-Struktur
{
"choices": {
"necessary": true,
"analytics": true,
"marketing": false
},
"geo": {
"country": "DE",
"state": null
}
}choices: Ein Objekt, in dem jeder Schlüssel eine Einwilligungskategorie ist und der Wert true (akzeptiert) oder false (abgelehnt) ist.
geo: Enthält den geografischen Standort des Nutzers zum Zeitpunkt der Einwilligung.
Einwilligung client-seitig lesen
function getFitConsentChoices() {
const cookie = document.cookie
.split('; ')
.find(row => row.startsWith('fitconsent_given='));
if (!cookie) return null;
try {
return JSON.parse(decodeURIComponent(cookie.split('=')[1]));
} catch {
return null;
}
}
const consent = getFitConsentChoices();
if (consent?.choices?.analytics) {
// Analytics-Script initialisieren
}Automatische Spracherkennung
Das FitConsent-Banner erkennt automatisch die bevorzugte Sprache des Nutzers:
1. Das lang-Attribut des <html>-Tags (z.B. <html lang="de">). Dies ist die zuverlässigste Methode.
2. Die navigator.language-Einstellung des Browsers.
3. Fallback auf Englisch (en) oder die erste Sprache in Ihrer konfigurierten Liste.
Diagnosewerkzeug
Verwenden Sie das integrierte Diagnosewerkzeug in Ihrer FitConsent-Konfigurationsseite, um die Installation zu überprüfen. Das Werkzeug prüft: Banner-Script-Erkennung, Einwilligungsmodus-Status, Google-Tag-Integration und gibt konkrete Empfehlungen bei Problemen.
Migration: Erweiterter → Basismodus
1. Ändern Sie Ihre FitConsent-Konfiguration auf "basic".
2. Entfernen Sie den "Consent Default"-Scriptblock aus Ihrem <head>.
3. Fügen Sie type="text/plain" und data-cookieconsent="..." zu allen Tracking-Script-Tags hinzu.
4. Löschen Sie Browser-Cookies und testen Sie erneut.
Nach dem Wechsel zum Basismodus verlieren Sie alle Daten vor der Einwilligung, einschließlich anonymer Modellierungsdaten. Dies kann nicht rückwirkend wiederhergestellt werden.
Ready to simplify your compliance?
Implement a reliable Consent Management Platform (CMP) today and ensure you stay compliant with all global regulations.
Start Your Free Trial