Consent Management Plattform CMP dokumentation

Auf dieser Seite

Einleitung
Installation & Einrichtung
Konfigurieren Sie Ihr Banner
Cookie-Erklärung
Fortgeschrittene Nutzung

Hier finden Sie alles, was Sie für den Einstieg in die FitConsent Consent Management Plattform CMP benötigen, von der Installation bis zur erweiterten Nutzung.

Einleitung

Willkommen bei der FitConsent-Dokumentation Consent Management Plattform.

Was ist eine Consent Management Plattform (CMP)?

Eine Consent Management Plattform CMP ist ein Tool, das Websites dabei hilft, die Einwilligung der Nutzer zur Datenverarbeitung rechtmäßig einzuholen und zu verwalten – eine Anforderung von Datenschutzgesetzen wie der DSGVO in Europa und dem CCPA/CPRA in Kalifornien. Sie ist die Technologie hinter den „Cookie-Bannern“, die Sie auf vielen Websites sehen.

FitConsent ist mehr als nur ein Banner. Es gibt Ihnen die Werkzeuge an die Hand, um nicht nur gesetzeskonform zu sein, sondern auch die Benutzererfahrung zu optimieren, Vertrauen aufzubauen und die Zustimmungsraten zu verbessern. Unser Dienst beinhaltet volle, automatische Unterstützung für Google Consent Mode V2 und Microsoft UET Consent Mode, um sicherzustellen, dass Ihre Analyse- und Marketing-Tags ihr Verhalten basierend auf der Nutzereinwilligung anpassen – Eine detaillierte Implementierung findet sich in Googles Leitfaden zum Einrichten des Einwilligungsmodus auf Websites. Diese Anpassungsfähigkeit ist entscheidend für datengetriebenes Marketing in einer Welt, in der Datenschutz oberste Priorität hat.

Installation & Einrichtung

Die Integration von FitConsent ist schnell und einfach gestaltet. Sie müssen nur ein einziges Skript-Snippet im <head>-Bereich Ihrer Website hinzufügen. Dieses Skript kümmert sich um alles, von der Anzeige des Banners bis zur Verwaltung der Standardwerte für den Google- und Microsoft-Zustimmungsmodus.

Wichtige Voraussetzung: Consent Mode

Unser Skript richtet automatisch die notwendigen Standardeinstellungen für Google Consent Mode v2 und Microsoft UET Consent Mode ein. Dies ist entscheidend, damit Dienste wie Google Analytics und Microsoft Advertising datenschutzkonform funktionieren. Stellen Sie sicher, dass Sie dieses Skript so hoch wie möglich im <head>-Tag Ihrer Website platzieren, bevor alle anderen Skripte folgen, die Cookies verwenden könnten.

Direkte Einbettung

Für die direkte Installation kopieren Sie das folgende Codesnippet und fügen Sie es in den <head>-Abschnitt des HTML Ihrer Website ein. Es ist entscheidend, dass es so hoch wie möglich platziert wird, bevor andere Skripte, die Cookies setzen könnten (wie Google Analytics oder Microsoft UET), geladen werden.

<!-- FitConsent Banner Script -->
<script>
  // Define dataLayer and the gtag helper.
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}

  // Initialize Microsoft UET queue
  window.uetq = window.uetq || [];

  // Set default consent states for Google and Microsoft.
  // This MUST run before any other scripts using cookies.
  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>

<!-- Load your other scripts (e.g., Google Analytics, Microsoft UET) here -->
<!-- ... -->

<!-- Load FitConsent Banner to update consent based on user interaction -->
<script async defer src="https://app.fitconsent.com/api/banner?websiteId=YOUR_WEBSITE_ID"></script>
<!-- End FitConsent Banner Script -->

Google Tag Manager (Empfohlen)

Die Verwendung unserer Google Tag Manager (GTM) Community-Vorlage ist der empfohlene Weg, um FitConsent zu installieren. Sie verwaltet den Google Consent Mode v2 korrekt und stellt sicher, dass Tags basierend auf der Nutzereinwilligung ausgelöst werden.

Schritt 1: Consent Overview aktivieren (einmalige Einrichtung)

1. Klicken Sie in Ihrem GTM-Arbeitsbereich auf den Tab „Admin“.
2. Klicken Sie unter der Spalte „Container“ auf „Containereinstellungen“.
3. Aktivieren Sie im Abschnitt „Zusätzliche Einstellungen“ das Kontrollkästchen „Consent Overview aktivieren“.
4. Klicken Sie oben rechts auf „Speichern“.

Schritt 2: FitConsent-Vorlage hinzufügen

1. Gehen Sie in der linken Seitenleiste zum Abschnitt „Vorlagen“.
2. Klicken Sie im Feld „Tag-Vorlagen“ auf „Aus der Galerie suchen“.
3. Suchen Sie nach „FitConsent“ und klicken Sie auf „Zum Arbeitsbereich hinzufügen“.
4. Bestätigen Sie die Berechtigungen, um die Vorlage hinzuzufügen.

Schritt 3: Einen „Google Consent Default“-Tag erstellen

1. Gehen Sie zu „Tags“ und klicken Sie auf „Neu“.
2. Benennen Sie den Tag „FitConsent – Consent Default“.
3. Klicken Sie auf „Tag-Konfiguration“ und wählen Sie „FitConsent“ aus der Liste.
4. Wählen Sie im Dropdown-Menü „Tag-Typ“ die Option „Google Consent Default“. Dies legt die Standardeinstellungen für Google und Microsoft fest.
5. Fügen Sie im Feld „FitConsent Website ID“ Ihre eindeutige Website-ID aus Ihrem Dashboard ein.
6. Wählen Sie als Trigger die integrierte Option „Consent Initialization – All Pages“. Dies ist entscheidend.
7. Speichern Sie den Tag.

Schritt 4: Den „FitConsent Banner Loader“-Tag erstellen

1. Erstellen Sie einen weiteren „Neuen“ Tag. Benennen Sie ihn „FitConsent – Banner Loader“.
2. Klicken Sie auf „Tag-Konfiguration“ und wählen Sie erneut „FitConsent“.
3. Der „Tag-Typ“ sollte standardmäßig „FitConsent Banner Loader“ sein.
4. Fügen Sie im Feld „FitConsent Website ID“ Ihre eindeutige Website-ID aus Ihrem Dashboard ein.
5. Wählen Sie auch hier als Trigger „Consent Initialization – All Pages“.
6. Speichern Sie den Tag.

Schritt 5: Ihren Google-Tag konfigurieren

Der letzte Schritt besteht darin, sicherzustellen, dass Ihr Haupt-Google-Tag (der, der Daten an Google Analytics sendet) ordnungsgemäß basierend auf der Nutzereinwilligung ausgelöst wird.

A) Wenn Sie bereits einen Google-Tag (z. B. „G-XXXXXXXXXX“) in Ihrem Container haben:

1. Klicken Sie auf Ihren Google-Tag, um ihn zu bearbeiten.
2. Gehen Sie zu „Erweiterte Einstellungen“ > „Consent-Einstellungen“.
3. Stellen Sie sicher, dass „Keine zusätzliche Einwilligung erforderlich“ ausgewählt ist. Die FitConsent-Vorlage kümmert sich um die Einwilligungssignale für Sie.
4. Speichern Sie die Änderungen an Ihrem Tag.

B) Wenn Sie noch keinen Google-Tag haben:

1. Klicken Sie auf „Tags“ > „Neu“.
2. Benennen Sie den Tag „Google Tag – GA4“ oder ähnlich.
3. Wählen Sie für die „Tag-Konfiguration“ „Google-Tag“.
4. Geben Sie Ihre GA4-Mess-ID in das Feld „Tag-ID“ ein (z. B. „G-XXXXXXXXXX“).
5. Wählen Sie als „Trigger“ „Initialization – All Pages“.
6. Gehen Sie zu „Erweiterte Einstellungen“ > „Consent-Einstellungen“ und stellen Sie sicher, dass „Keine zusätzliche Einwilligung erforderlich“ ausgewählt ist.
7. Speichern Sie den Tag.

Schritt 6: Andere Skripte verwalten (z. B. Microsoft Clarity, Facebook Pixel)

Die Integration von FitConsent mit dem Google Consent Mode V2 ermöglicht es Ihnen, jedes Drittanbieter-Skript über GTM zu verwalten. So würden Sie einen Tag wie Microsoft Clarity einrichten:

1. Tag hinzufügen: Fügen Sie Ihren Drittanbieter-Tag zu GTM hinzu (entweder über eine Community-Vorlage oder als benutzerdefinierter HTML-Tag).
2. Consent-Einstellungen konfigurieren: Bearbeiten Sie den Tag, gehen Sie zu „Erweiterte Einstellungen“ > „Consent-Einstellungen“.
3. Einwilligungsprüfung hinzufügen: Wählen Sie „Zusätzliche Einwilligung erforderlich, damit der Tag ausgelöst wird“. Eine Tabelle wird angezeigt.
4. Einwilligungstyp wählen: Klicken Sie auf „Erforderliche Einwilligung hinzufügen“ und wählen Sie den entsprechenden Einwilligungstyp. Für ein Analysetool wie Clarity würden Sie analytics_storage wählen. Für ein Marketing-Skript wie ein Facebook Pixel oder einen Microsoft UET-Tag könnten Sie sowohl ad_storage als auch analytics_storage hinzufügen.
5. Trigger festlegen: Legen Sie den Tag-Trigger so fest, dass er bei Ihrem standardmäßigen Seitenansicht-Ereignis ausgelöst wird (z. B. „Initialization – All Pages“ oder ein benutzerdefiniertes „Page View“-Ereignis).

Jetzt prüft GTM automatisch den von FitConsent bereitgestellten Einwilligungsstatus. Der Microsoft Clarity-Tag wird nur ausgelöst, nachdem der Nutzer der Kategorie „Analytics“ in Ihrem Einwilligungsbanner zugestimmt hat, und ein UET-Tag wird nur ausgelöst, wenn „Marketing“ akzeptiert wird.

Klicken Sie abschließend auf „Senden“ und „Veröffentlichen“ Sie Ihren GTM-Container, um die Änderungen zu übernehmen.

FitConsent CMP WordPress Plugin

Integriert FitConsent mit WordPress und der WP Consent API für nahtlose Kompatibilität mit Google Site Kit.

Herunterladen von WordPress.org

FitConsent ist eine leistungsstarke und dennoch einfache Consent Management Platform (CMP), die Ihnen hilft, Datenschutzbestimmungen wie die DSGVO und den CCPA einzuhalten. Dieses Plugin macht es unglaublich einfach, das FitConsent-Banner zu Ihrer WordPress-Website hinzuzufügen. Am wichtigsten ist, dass es eine automatische und sofortige Kompatibilität mit der WP Consent API bietet, die der Standard ist, der von Google Site Kit verwendet wird.

Durch die Verwendung dieses Plugins können Sie den Zustimmungsmodus von Google Site Kit aktivieren und sicher sein, dass die Einwilligungsentscheidungen Ihrer Benutzer respektiert werden, was eine rechtskonforme und effektive Analyse und Anzeigenverfolgung ermöglicht.

Hauptfunktionen

Einfache Einrichtung: Geben Sie einfach Ihre FitConsent-Website-ID ein und das Plugin erledigt den Rest.
Bereit für Google Site Kit: Funktioniert nahtlos mit dem Zustimmungsmodus von Google Site Kit durch die Integration mit der WP Consent API.
Leichtgewichtig: Das Plugin ist schlank und belastet Ihre Website nicht unnötig.
Standardisierte Kommunikation: Stellt sicher, dass die Einwilligungssignale korrekt zwischen Ihrem Einwilligungsbanner und anderen Plugins übermittelt werden.

Installationsanleitung

Methode 1: Installation über das WordPress-Dashboard

Melden Sie sich bei Ihrem WordPress-Dashboard an.
Navigieren Sie zu Plugins > Neu hinzufügen.
Geben Sie in die Suchleiste „FitConsent CMP“ ein und drücken Sie die Eingabetaste.
Suchen Sie das Plugin „FitConsent CMP“ in den Suchergebnissen und klicken Sie auf Jetzt installieren.
Klicken Sie nach der Installation auf Aktivieren.

Methode 2: Manuelle Installation via FTP

Laden Sie das FitConsent CMP-Plugin von der offiziellen Quelle herunter.
Entpacken Sie die heruntergeladene Datei, um den Ordner fitconsent-cmp zu extrahieren.
Verbinden Sie sich mit dem Server Ihrer Website mithilfe eines FTP-Clients (z. B. FileZilla).
Navigieren Sie zum Verzeichnis /wp-content/plugins/.
Laden Sie den gesamten Ordner fitconsent-cmp in dieses Verzeichnis hoch.
Gehen Sie zurück zu Ihrem WordPress-Dashboard, navigieren Sie zu Plugins > Installierte Plugins und klicken Sie bei „FitConsent CMP“ auf Aktivieren.

Konfiguration nach der Installation

Gehen Sie in Ihrem WordPress-Dashboard zu Einstellungen > FitConsent.
Finden Sie Ihre FitConsent-Website-ID in Ihrem FitConsent-Dashboard.
Geben Sie diese ID in das dafür vorgesehene Feld ein und klicken Sie auf Änderungen speichern.

Integration mit Google Site Kit (falls zutreffend)

Wenn Sie das Google Site Kit-Plugin verwenden, gehen Sie zu dessen Einstellungen.
Stellen Sie sicher, dass die Option Zustimmungsmodus aktiviert ist.

Andere Plattformen (CMS)

Sie können FitConsent mit jeder Website oder jedem Content Management System (CMS) wie WordPress oder Shopify verwenden, das es Ihnen ermöglicht, benutzerdefinierten HTML- oder JavaScript-Code hinzuzufügen. Wir empfehlen Ihnen dringend, die Google Tag Manager-Integration zu verwenden, falls verfügbar, und den oben genannten GTM-Anweisungen zu folgen. Andernfalls können Sie die Methode der „Direkten Einbettung“ verwenden.

Consent Management Plattform: Konfigurieren Sie Ihr Banner

Passen Sie das Aussehen, den Inhalt und das Verhalten des Banners über Ihr Dashboard an.

Allgemeine Einstellungen

Framework: Wählen Sie die wichtigste Datenschutzbestimmung, die Sie einhalten müssen (z. B. DSGVO, CCPA). Diese Wahl passt das Standardverhalten des Banners und die verfügbaren Optionen an, um sich an die Anforderungen dieses Frameworks anzupassen.

Hier ist die Übersetzung der FitConsent CMP Benutzerdokumentation ins Deutsche (DE).

Konfiguration des Einwilligungsmodus

Dieses Handbuch erklärt, wie Sie die FitConsent Consent Management Platform (CMP) für Ihre Website konfigurieren. FitConsent bietet zwei unterschiedliche Konfigurationsmodi – Erweitert (Advanced) und Basis (Basic) – die Ihnen die Flexibilität geben, die Anforderungen an Marketingdaten mit einer strikten Einhaltung des Datenschutzes in Einklang zu bringen.

1. Auswahl Ihres Konfigurationsmodus

Bevor Sie mit der Installation beginnen, entscheiden Sie, welcher Modus am besten zu Ihrem Unternehmen und Ihren regulatorischen Anforderungen passt.

Erweiterter Modus (Empfohlen)

Ideal für: Datengetriebenes Marketing, Google Ads-Optimierung und Google Analytics 4 (GA4).

Im Erweiterten Modus werden Google-Tags sofort geladen, halten sich aber strikt an die Datenschutzsignale.

Vor der Einwilligung: Tags werden geladen, senden jedoch „Cookieless Pings“ (anonyme Signale) mit verweigerter Einwilligung. Es werden keine Cookies gesetzt.
Nach der Einwilligung: Die Tags werden auf vollständige Datenerfassungsfunktionen aktualisiert.
Vorteil: Ermöglicht Googles Conversion Modeling (Konversionsmodellierung), wodurch verlorene Daten für die Attribution wiederhergestellt werden, selbst wenn Nutzer Cookies ablehnen.

Basis-Modus (Strikter Datenschutz)

Ideal für: Sehr strenge Datenschutzrichtlinien oder Gerichtsbarkeiten, die null Datenübertragung vor der Einwilligung erfordern.

Im Basis-Modus sind alle Google-Tags komplett blockiert, bis der Nutzer aktiv seine Zustimmung erteilt.

Vor der Einwilligung: Es werden keine Google-Tags ausgeführt. Es werden keine Daten an Google-Server gesendet.
Kompromiss: Sie verlieren alle Daten von Nutzern, die keine Einwilligung erteilen, einschließlich anonymer Modellierungsdaten.

2. Einrichtung des Erweiterten Modus (Standard)

Dies ist die Standardkonfiguration für FitConsent. Sie erfordert keine Änderungen an Ihren bestehenden Google-Tags.

Schritt 1: Einstellungen konfigurieren

Stellen Sie sicher, dass Ihre FitConsent-Konfiguration auf ‚advanced‘ eingestellt ist.

Schritt 2: Einbettungscode installieren

Kopieren Sie den Einbettungscode für den Erweiterten Modus aus Ihrem FitConsent-Dashboard. Er muss vor Ihren Google-Tags im <head> Ihrer Website platziert werden.

(Bild der HTML-Codestruktur, die das FitConsent-Skript vor dem Google Analytics-Skript zeigt)

HTML

<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}

  // Setzt die Einwilligungs-Standardwerte, BEVOR die Tags geladen werden
  gtag('consent', 'default', {
    'ad_storage': 'denied',
    'ad_user_data': 'denied',
    'ad_personalization': 'denied',
    'analytics_storage': 'denied'
  });
</script>

<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'G-XXXXXXX');
</script>

<script async defer src="https://app.fitconsent.com/api/banner?websiteId=IHRE_WEBSITE_ID"></script>

Schritt 3: Überprüfung

Laden Sie Ihre Website in einem privaten/Inkognito-Fenster.
Öffnen Sie die Entwicklertools (F12) > Registerkarte Netzwerk (Network).
Sie sollten sofort Anfragen an Google Analytics (collect?v=2...) sehen, noch bevor Sie auf „Akzeptieren“ klicken.
Überprüfen Sie die Nutzlast der Anfrage auf gcs=. Es sollte die verweigerte Einwilligung anzeigen (z. B. G100).

3. Einrichtung des Basis-Modus (Strenges Blockieren)

Diese Konfiguration verhindert, dass Google-Tags ausgelöst werden, bis die Einwilligung erteilt wird. Dies erfordert eine manuelle Änderung Ihrer Google-Tag-Skripte.

Schritt 1: Einstellungen konfigurieren

Ändern Sie Ihre FitConsent-Konfiguration auf ‚basic‘.

Schritt 2: Einbettungscode installieren

Verwenden Sie den Einbettungscode für den Basis-Modus. Beachten Sie, dass dieser nicht das Skript für die Standard-Einwilligungssignale enthält, das im Erweiterten Modus zu finden ist.

HTML

<script async defer src="https://app.fitconsent.com/api/banner?websiteId=IHRE_WEBSITE_ID"></script>

Schritt 3: Ihre Google-Tags blockieren

Sie müssen Ihre Google Analytics- oder Tag Manager-Skripte manuell ändern, um zu verhindern, dass sie automatisch ausgeführt werden.

Ändern Sie type="text/javascript" (oder Standard) in type="text/plain".
Fügen Sie das Attribut data-cookieconsent hinzu, das der Tag-Kategorie entspricht (z. B. „analytics“ oder „marketing“).

Vorher (Standard Google Tag):

HTML

<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXX"></script>

Nachher (Blockiertes Google Tag):

HTML

<script 
  type="text/plain" 
  data-cookieconsent="analytics"
  async 
  src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXX">
</script>

Anleitung zur Kategorienzuordnung:

data-cookieconsent="analytics" → Verwenden Sie dies für Google Analytics (GA4)
data-cookieconsent="marketing" → Verwenden Sie dies für Google Ads, Facebook Pixel, LinkedIn Insight
data-cookieconsent="functional" → Verwenden Sie dies für Chatbots oder Personalisierungstools

Schritt 4: Überprüfung

Löschen Sie die Cookies Ihres Browsers und laden Sie die Seite neu.
Öffnen Sie die Entwicklertools > Registerkarte Netzwerk (Network).
Stellen Sie sicher, dass keine Google Analytics-Anfragen erscheinen.
Klicken Sie auf „Akzeptieren“ im Banner.
Überprüfen Sie, ob das Google Analytics-Skript jetzt geladen wird und die Anfrage in der Registerkarte Netzwerk erscheint.

4. Fehlerbehebung und Tests

Verwenden Sie den Debug-Parameter, um Ihre Installation zu überprüfen.

Fügen Sie ?fitconsent_debug=true zu Ihrer URL hinzu (z. B. https://ihreseite.de?fitconsent_debug=true).

Im Erweiterten Modus: Die Konsole sollte bestätigen: ✅ „Consent defaults loaded before Google tags.“ (Einwilligungs-Standardwerte wurden vor den Google-Tags geladen.)
Im Basis-Modus: Die Konsole verfolgt, wann blockierte Skripte nach Erteilung der Einwilligung entsperrt werden.

Migrationshinweis

Wenn Sie vom Erweiterten in den Basis-Modus wechseln:

Aktualisieren Sie Ihre Konfigurationseinstellung.
Entfernen Sie den Skriptblock „Consent Default“ aus Ihrem Code.
Fügen Sie type="text/plain" manuell zu allen Ihren Tracking-Tags hinzu.
Löschen Sie Ihre Cookies und testen Sie.

Vergleichstabelle

Funktion	Basis-Modus	Erweiterter Modus
Google Tags	Blockiert bis zur Einwilligung	Sofort geladen (eingeschränkt)
Daten vor Einwilligung	Keine Datenerfassung	Cookieless Pings (Modellierung)
Datenschutzniveau	Am strengsten	Ausgewogen (GDPR/DMA-konform)
Implementierung	Erfordert manuelle Tag-Änderungen	Einfaches Kopieren und Einfügen
Konversionsmodellierung	❌ Nicht verfügbar	✅ Verfügbar

Geotargeting (Premium): Wählen Sie, ob das Banner nur Besuchern aus bestimmten Regionen, wie z. B. der EU, angezeigt werden soll.

Layout: Wählen Sie zwischen einem schwebenden Banner (an verschiedenen Positionen auf dem Bildschirm) oder einem zentrierten Dialog, der Ihren Inhalt überlagert.

Consent Management Plattform Allgemeine Einstellungen

Erscheinungsbild

Passen Sie die Farben, Schriftarten und die Höhenlage (Schatten) an, damit sie perfekt zum Aussehen und Gefühl Ihrer Marke passen.

Logo und Hintergrundbild: Sie können dem Banner auch das Logo Ihres Unternehmens oder sogar ein Hintergrundbild hinzufügen, um ein vollumfängliches Markenerlebnis zu schaffen.

Consent Management Plattform Erscheinungsbild

Inhalt & Sprachen

Bearbeiten Sie den gesamten Text des Banners und des Präferenz-Modals. FitConsent unterstützt mehrere Sprachen, sodass Sie allen Ihren Nutzern eine native Erfahrung bieten können. Grundlegendes Markdown wird in den Haupttextfeldern unterstützt.

KI-gestützte Optimierung

Nutzen Sie unseren KI-gestützten Optimierer für Vorschläge zu Farben, Text und Layouts, die nachweislich die Zustimmungsraten basierend auf dem Inhalt Ihrer Website und Ihrer Zielgruppe erhöhen.

FitConsent kann eine detaillierte, sich automatisch aktualisierende Liste der Cookies und anderer Speicherlemente anzeigen, die Ihre Website verwendet. Dies wird oft auf einer Datenschutz-Seite platziert, um Ihren Nutzern volle Transparenz zu bieten.

Die Erklärung einbetten

Um die Cookie-Erklärung anzuzeigen, müssen Sie ein einfaches <div>-Element zu der Seite hinzufügen, auf der die Tabelle erscheinen soll, und dann unser Erklärungs-Skript einfügen. Das genaue Codesnippet für Ihre Website finden Sie auf dem Tab „Cookie-Erklärung“ Ihrer Website-Einstellungsseite.

Standard-HTML-Websites

Für Standard-HTML-Websites oder Websites, die mit einem CMS wie WordPress (ohne Headless-React-Frontend) erstellt wurden, können Sie das folgende Snippet direkt in das HTML Ihrer Seite einfügen.

Das Skript findet automatisch das <div> mit der ID fitconsent-declaration und fügt die Cookie-Tabelle dort ein.

<div id="fitconsent-declaration"></div>
<script async defer src="https://app.fitconsent.com/api/declaration?websiteId={websiteId}"></script>

React- und Next.js-Websites

Um „Hydration-Fehler“ in React-basierten Frameworks wie Next.js zu vermeiden, ist es entscheidend, dass das Erklärungs-Skript die Seite nicht vor dem Ende des initialen Renderings von React auf der Client-Seite ändert.

Der empfohlene Weg, dies zu erreichen, ist die Erstellung einer dedizierten Client-Komponente, die das Skript mithilfe eines useEffect-Hooks lädt.

Eine Client-Komponente erstellen

Erstellen Sie eine neue Komponentendatei, zum Beispiel StorageDeclarationEmbed.tsx. Stellen Sie sicher, dass Sie die Direktive "use client"; am Anfang einfügen.

'use client';

import { useEffect } from 'react';

type StorageDeclarationEmbedProps = {
  websiteId: string;
};

export function StorageDeclarationEmbed({ websiteId }: StorageDeclarationEmbedProps) {
  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 () => {
      // Clean up the script when the component unmounts
      if (container && container.contains(script)) {
        container.removeChild(script);
      }
    };
  }, [websiteId]);

  return <div id="fitconsent-declaration"></div>;
}

2. Die Komponente auf Ihrer Seite verwenden

Sie können diese Komponente nun auf jeder Seite importieren und verwenden, z. B. auf Ihrer Datenschutz-Seite.

import { StorageDeclarationEmbed } from '@/components/StorageDeclarationEmbed'; // Adjust the import path

export default function PrivacyPolicyPage() {
  return (
    <div>
      <h1>Datenschutzrichtlinie</h1>
      {/* ... other content ... */}

      <h3>Speichererklärung</h3>
      <p>
        Zur vollständigen Transparenz finden Sie unten eine Liste der spezifischen Cookies und
        anderer Speicherlemente, die unser Dienst möglicherweise in Ihrem Browser platziert.
      </p>
      <StorageDeclarationEmbed websiteId="YOUR_WEBSITE_ID" />

      {/* ... other content ... */}
    </div>
  );
}

Dieser Ansatz stellt sicher, dass das Skript sicher auf der Client-Seite geladen und ausgeführt wird, um Konflikte mit dem React-Rendering-Lebenszyklus zu vermeiden.

Consent Management Plattform: Fortgeschrittene Nutzung

Nutzen Sie die Einwilligungsdaten und verstehen Sie das Banner-Verhalten.

Einwilligungsdaten auf Ihrer Website verwenden

Nachdem ein Nutzer mit dem Banner interagiert hat, speichert FitConsent seine Entscheidungen und Geolokalisierungsdaten in einem Cookie namens fitconsent_given. Sie können dieses Cookie auf der Client- oder Server-Seite lesen, um die Benutzererfahrung anzupassen.

Cookie-Struktur

Das Cookie enthält ein JSON-Objekt mit zwei Hauptschlüsseln: choices und geo.

choices: Ein Objekt, bei dem die Schlüssel die Einwilligungskategorien sind (z. B. marketing, analytics) und die Werte true oder false sind.

geo: Ein Objekt, das die geografischen Informationen des Nutzers (z. B. Ländercode, Bundesland) zum Zeitpunkt der Einwilligung enthält.

{
  "choices": {
    "marketing": true,
    "analytics": true
  },
  "geo": {
    "country": "US",
    "state": "CA"
  }
}

Beispiel: Eine Komponente basierend auf der Einwilligung anzeigen

So könnten Sie ein spezielles Werbebanner nur Nutzern in Kalifornien anzeigen, die in Marketing-Cookies eingewilligt haben.

import { useState, useEffect } from 'react';

function PromotedFeatures() {
  const [show, setShow] = useState(false);

  useEffect(() => {
    const cookie = document.cookie
      .split('; ')
      .find(row => row.startsWith('fitconsent_given='));

    if (cookie) {
      try {
        const consent = JSON.parse(decodeURIComponent(cookie.split('=')[1]));
        // Example: Check if the user is in California and consented to marketing
        if (consent?.geo?.state === 'California' && consent?.choices?.marketing) {
          setShow(true);
        }
      } catch (e) {
        console.error('Error parsing FitConsent cookie', e);
      }
    }
  }, []);

  if (!show) {
    return null;
  }

  return (
    // Your component for users who consented to marketing
    <div>Special Promotion for California!</div>
  );
}

Automatische Spracherkennung

Das FitConsent-Banner erkennt automatisch die bevorzugte Sprache des Benutzers und zeigt die entsprechende Übersetzung an, wenn Sie eine bereitgestellt haben. Dieser Prozess folgt einer spezifischen Reihenfolge:

1. Es prüft zuerst das lang-Attribut auf dem HTML-Tag Ihrer Website (z. B. <html lang=“de“>). Dies ist die zuverlässigste Methode.
2. Wenn das lang-Attribut nicht vorhanden ist, wird die Spracheinstellung des Benutzer-Browsers (navigator.language) verwendet.
3. Wenn keine der oben genannten Optionen mit den von Ihnen konfigurierten Sprachen übereinstimmt, wird auf Englisch (en) oder die erste Sprache in Ihrer ausgewählten Liste zurückgegriffen.

Best Practices

Für die besten Ergebnisse auf mehrsprachigen Websites stellen Sie sicher, dass das <html>-Tag Ihrer Seite korrekt die aktuelle Sprache widerspiegelt, die dem Benutzer angezeigt wird.

FitConsent CMP-Dokumentation

Auf dieser Seite

Einleitung

Was ist eine Consent Management Plattform (CMP)?

Installation & Einrichtung

Wichtige Voraussetzung: Consent Mode

Direkte Einbettung

Google Tag Manager (Empfohlen)

Schritt 1: Consent Overview aktivieren (einmalige Einrichtung)

Schritt 2: FitConsent-Vorlage hinzufügen

Schritt 3: Einen „Google Consent Default“-Tag erstellen

Schritt 4: Den „FitConsent Banner Loader“-Tag erstellen

Schritt 5: Ihren Google-Tag konfigurieren

A) Wenn Sie bereits einen Google-Tag (z. B. „G-XXXXXXXXXX“) in Ihrem Container haben:

B) Wenn Sie noch keinen Google-Tag haben:

Schritt 6: Andere Skripte verwalten (z. B. Microsoft Clarity, Facebook Pixel)

FitConsent CMP WordPress Plugin

Hauptfunktionen

Installationsanleitung

Methode 1: Installation über das WordPress-Dashboard

Methode 2: Manuelle Installation via FTP

Konfiguration nach der Installation

Integration mit Google Site Kit (falls zutreffend)

Andere Plattformen (CMS)

Consent Management Plattform: Konfigurieren Sie Ihr Banner

Allgemeine Einstellungen

1. Auswahl Ihres Konfigurationsmodus

Erweiterter Modus (Empfohlen)

Basis-Modus (Strikter Datenschutz)

2. Einrichtung des Erweiterten Modus (Standard)

3. Einrichtung des Basis-Modus (Strenges Blockieren)

4. Fehlerbehebung und Tests

Migrationshinweis

Vergleichstabelle

Erscheinungsbild

Inhalt & Sprachen

KI-gestützte Optimierung

Consent Management Plattform: Cookie-Erklärung

Die Erklärung einbetten

Standard-HTML-Websites

React- und Next.js-Websites

Consent Management Plattform: Fortgeschrittene Nutzung

Einwilligungsdaten auf Ihrer Website verwenden

Cookie-Struktur

Beispiel: Eine Komponente basierend auf der Einwilligung anzeigen

Automatische Spracherkennung

Best Practices