Cookie-Einwilligung für React-Anwendungen.
Fügen Sie CookieHub mit react-cookiehub zu Ihrer React-App hinzu, halten Sie den Einwilligungsstatus bei clientseitiger Navigation konsistent und steuern Sie, wann Analyse-, Marketing- und eingebettete Dienste ausgeführt werden dürfen.
- React-Paket
- SPA-tauglicher Einwilligungsstatus
- Einwilligungsgesteuerte Skripte
Ein Einwilligungsstatus für Ihre gesamte React-App.
React-Apps laden nicht wie klassische Websites. Komponenten werden gemountet, während Besucher sich durch die App bewegen, Routen wechseln ohne vollständiges Neuladen der Seite und Skripte können dynamisch geladen werden – so kann Tracking auslösen, bevor ein Besucher eine Wahl getroffen hat, wenn die Einwilligung nicht an einer zentralen Stelle verwaltet wird.
CookieHub gibt Ihrer React-App eine zentrale Einwilligungsebene. Initialisieren Sie CookieHub mit react-cookiehub einmal im Root Ihrer App und laden Sie Analyse-, Marketing- und andere nicht notwendige Tools erst, wenn der Besucher die jeweilige Einwilligungskategorie erlaubt hat.
Skripte erst nach Einwilligung laden
Initialisieren Sie Analyse-, Marketing- oder andere nicht notwendige Tools nur, wenn die jeweilige Kategorie erlaubt ist.
SPA-taugliche Einwilligung
Initialisieren Sie CookieHub zentral und halten Sie die Einwilligung der Besucher bei clientseitigen Routenwechseln konsistent.
React-spezifische Steuerung
Nutzen Sie die React-Komponenten und Events des Pakets, statt Einwilligungsprüfungen über die ganze App zu verteilen.
Einwilligungssteuerung, entwickelt für React.
react-cookiehub ist das Paket von CookieHub für React- und Next.js-Apps. Es lädt CookieHub vom Root Ihrer App aus und bietet Komponenten und Events für alles, was auf eine Einwilligung warten soll:
- CookieHub.initialize() lädt CookieHub mit Ihrem Domain-Code
- CookieHubScript lädt ein externes oder Inline-Skript in der von Ihnen festgelegten Einwilligungskategorie
- CookieHubGA und CookieHubPixel laden Google Analytics und das Meta Pixel in den Kategorien Analyse und Marketing
- CookieHubYoutube bettet YouTube-Videos über eine youtube-nocookie-URL ein
- Mit onAllow, onRevoke und weiteren Events reagiert Ihre App, wenn sich die Einwilligung ändert
Die Paketanleitung enthält die vollständige Referenz, einschließlich der Einrichtung für den Next.js App Router und Pages Router.
Paketanleitung ansehenTools für die Cookie-Einwilligung in Ihrer React-App.
Skripte erst nach Einwilligung laden
CookieHubScript fügt ein Skript in der von Ihnen gewählten Einwilligungskategorie hinzu – etwa Analyse, Marketing oder Präferenzen –, sodass es erst ausgeführt wird, wenn der Besucher diese Kategorie erlaubt.
Stabile Einwilligung bei Routenwechseln
CookieHub wird einmal vom Root Ihrer App geladen. Clientseitige Navigation lädt die Seite nicht neu, daher bleibt die Wahl des Besuchers bei Routenwechseln wirksam.
Google-Analytics-Komponente
CookieHubGA lädt Google Analytics mit Ihrer Tracking-ID in der Kategorie Analyse und wartet so auf die Einwilligung zur Analyse.
Meta-Pixel-Komponente
CookieHubPixel lädt das Meta-(Facebook-)Pixel mit Ihrer Pixel-ID in der Kategorie Marketing und wartet so auf die Einwilligung zu Marketing.
Kontrolle über eingebettete Medien
CookieHubYoutube bettet ein YouTube-Video anhand seiner URL oder Video-ID über eine youtube-nocookie-URL ein, die keine Tracking-Cookies von YouTube setzt.
Einwilligungs-Events und API
Events wie onAllow, onRevoke und onStatusChange sowie Methoden wie hasConsented() und openSettings() lassen Ihre App ohne Neuladen der Seite auf die Einwilligung reagieren.
CookieHub in wenigen Schritten zu React hinzufügen.
Diese Schritte folgen der Paketanleitung von react-cookiehub. Sie arbeiten mit Next.js? Dort wird CookieHub clientseitig initialisiert – siehe die Hinweise unten.
- 01
Paket installieren
Fügen Sie react-cookiehub zu Ihrem React-Projekt hinzu.
npm install react-cookiehub - 02
CookieHub mit Ihrem Domain-Code initialisieren
Jede Domain, die Sie im CookieHub-Dashboard hinzufügen, erhält einen eindeutigen 8-stelligen Domain-Code. Importieren Sie CookieHub aus react-cookiehub und rufen Sie CookieHub.initialize() mit diesem Code in Ihrer Root-Komponente auf, etwa App.js, damit es für die gesamte App gilt.
CookieHub.initialize('YOUR-DOMAIN-CODE') - 03
Nicht notwendige Dienste über CookieHub laden
Fügen Sie Skripte mit CookieHubScript und ihrer Einwilligungskategorie hinzu oder nutzen Sie CookieHubGA, CookieHubPixel und CookieHubYoutube. Für andere Tracking-Pakete nutzen Sie onInitialise, um eine bestehende Einwilligung zu berücksichtigen, und onAllow, wenn eine Einwilligung neu erteilt wird.
category="analytics" - 04
Einwilligung bei Routenwechseln testen
Prüfen Sie, dass kein Tracking vor der Einwilligung ausgeführt wird, wechseln Sie dann zwischen Routen und ändern Sie Ihre Wahl im Einstellungsdialog. Setzen Sie debug: true in den Optionen, um mehr Details in der Konsole zu sehen.
debug: true
Sie nutzen den Next.js App Router?
CookieHub nutzt Browser-APIs wie window, initialisieren Sie es daher clientseitig: Erstellen Sie eine Client-Komponente, die CookieHub.initialize() in useEffect aufruft, und rendern Sie sie in Ihrem Root-Layout.
Einrichtung für den Next.js App RouterSie nutzen den Next.js Pages Router?
Rufen Sie CookieHub.initialize() in useEffect in Ihrer _app-Datei auf, damit CookieHub nicht auf dem Server ausgeführt wird. Da Next.js die Ladereihenfolge von Skripten beeinflussen kann, empfiehlt die Paketanleitung die Skript-Komponenten von CookieHub.
Einrichtung für den Next.js Pages Router
Die Einwilligung bleibt erhalten, wenn Ihre App die Route wechselt.
In einer Single-Page-App mountet React Komponenten und lädt Dienste, während Besucher navigieren – ohne vollständiges Neuladen der Seite. react-cookiehub fügt CookieHub einmal hinzu, vom Root Ihrer App aus, sodass die Einwilligungsentscheidung des Besuchers jeder Route und Komponente zur Verfügung steht.
- Ihre Root-Komponente initialisiert CookieHub
- CookieHub hält den Einwilligungsstatus des Besuchers
- Routen wechseln ohne Neuladen der Seite
- Skripte laufen nur in erlaubten Kategorien
Drittanbieter-Skripte erst nach der Einwilligung laden.
react-cookiehub deckt die Skripte ab, die Sie über seine Komponenten hinzufügen. Skripte, die Ihre App auf anderem Weg lädt, hält das Paket nicht von selbst zurück: Laden Sie sie über CookieHubScript oder kennzeichnen Sie sie für die Einwilligung. Eigene Tracking-Pakete sollten eine bestehende Einwilligung in onInitialise prüfen und bei neu erteilter Einwilligung in onAllow starten.
So funktioniert die Skript-BlockierungSkripte in Ihren Komponenten
CookieHubScript nimmt ein externes Skript (src) oder ein Inline-Skript (innerHTML) samt seiner Kategorie entgegen und führt es aus, sobald der Besucher diese Kategorie erlaubt.
Google Analytics und Meta Pixel
CookieHubGA hält Google Analytics bis zur Einwilligung zur Analyse zurück, CookieHubPixel das Meta-(Facebook-)Pixel bis zur Einwilligung zu Marketing.
Andere React-Tracking-Pakete
Pakete, die eine eigene Initialisierung brauchen, können im Event onInitialise starten oder in onAllow, sobald eine Kategorie wie Analyse erlaubt ist.
Eingebettete YouTube-Videos
CookieHubYoutube bettet ein Video anhand seiner URL oder Video-ID über eine youtube-nocookie-URL ein, mit optionaler Breite und Höhe.
Reagieren, wenn sich die Einwilligung ändert.
Ändert ein Besucher seine Wahl, muss Ihre App womöglich sofort reagieren – ein Tracking-Paket starten, eines stoppen oder die Oberfläche aktualisieren. Übergeben Sie Event-Handler an CookieHub.initialize(), um ohne Neuladen der Seite auf die Einwilligung zu reagieren:
- onInitialise wird ausgeführt, sobald CookieHub initialisiert ist
- onAllow wird ausgeführt, wenn der Besucher eine Kategorie erlaubt, etwa Analyse
- onRevoke wird ausgeführt, wenn der Besucher eine Kategorie widerruft, etwa Marketing
- onStatusChange wird ausgeführt, wenn der Besucher seinen Einwilligungsstatus aktualisiert
Mit Methoden wie hasConsented(category), hasAnswered(), openSettings(), allowAll() und denyAll() können Ihre Komponenten die Einwilligung prüfen, den Einstellungsdialog öffnen oder alle Kategorien erlauben oder ablehnen. Weitere Optionen finden Sie in der JavaScript-API von CookieHub.
JavaScript-API entdeckenFragen zu React, beantwortet.
Laden Sie sie über react-cookiehub. CookieHubScript nimmt ein externes oder Inline-Skript samt seiner Einwilligungskategorie entgegen und führt es erst aus, wenn der Besucher diese Kategorie erlaubt. Bei Tracking-Paketen, die Sie im Code starten, prüfen Sie eine bestehende Einwilligung mit hasConsented() in onInitialise und starten sie in onAllow, wenn der Besucher später einwilligt.
Ja. react-cookiehub ist an keinen bestimmten Router gebunden: Sie initialisieren CookieHub einmal in Ihrer Root-Komponente, und clientseitige Routenwechsel laden die Seite nicht neu, daher bleibt die Einwilligung des Besuchers wirksam, während er zwischen Routen wechselt. Initialisieren Sie CookieHub im Root, nicht in einzelnen Routen.
Ja. Die Komponente CookieHubGA nimmt Ihre Google-Analytics-Tracking-ID entgegen und lädt Google Analytics in der Kategorie Analyse, sodass es erst ausgeführt wird, wenn der Besucher Analyse-Cookies erlaubt.
Ja. Die Komponente CookieHubPixel nimmt Ihre Meta-(Facebook-)Pixel-ID entgegen und lädt das Pixel in der Kategorie Marketing, sodass es erst ausgeführt wird, wenn der Besucher Marketing-Cookies erlaubt.
Übergeben Sie Event-Handler, wenn Sie CookieHub initialisieren: onAllow und onRevoke erhalten die Kategorie, die der Besucher erlaubt oder widerrufen hat, und onStatusChange wird ausgeführt, wenn er seine Wahl aktualisiert. Sie können die Einwilligung auch jederzeit mit hasConsented(category) prüfen oder die JavaScript-API von CookieHub nutzen.
Im CookieHub-Dashboard. Jede Domain, die Sie hinzufügen, erhält einen eindeutigen 8-stelligen Domain-Code, der in Ihrer Domainliste angezeigt wird. Übergeben Sie ihn anstelle von YOUR-DOMAIN-CODE an CookieHub.initialize().
Ja. Die Paketanleitung von react-cookiehub behandelt sowohl den Next.js App Router als auch den Pages Router. Sie weist außerdem darauf hin, dass Next.js Probleme mit der Ladereihenfolge von Skripten verursachen kann, und empfiehlt deshalb, Tracking-Skripte mit den Skript-Komponenten von CookieHub zu laden.
Ja. CookieHub nutzt Browser-APIs wie window, daher empfiehlt die Paketdokumentation die clientseitige Initialisierung. Rufen Sie CookieHub.initialize() beim App Router in useEffect in einer Client-Komponente auf, die Sie aus Ihrem Root-Layout rendern, und beim Pages Router in useEffect in Ihrer _app-Datei.
Ja. Wenn Ihre React-App ihre Tags bereits über Google Tag Manager lädt, können Sie CookieHub statt mit react-cookiehub über GTM mit der Vorlage CookieHub CMP installieren. Nutzen Sie eine Implementierung, nicht beide.
CookieHub bietet Tools, die Betreibern von React-Apps helfen, die Einwilligungsanforderungen von Datenschutzgesetzen wie DSGVO, CCPA und LGPD zu erfüllen: ein Consent-Banner, einwilligungsgesteuertes Laden der Skripte, die Sie darüber hinzufügen, Nachweise der Einwilligungsentscheidungen und eine stets aktuelle Cookie-Erklärung.
Fügen Sie Ihrer React-App ein Einwilligungsmanagement hinzu.
Nutzen Sie die React-Integration von CookieHub, um die Einwilligung der Besucher mit den Skripten und Diensten zu verbinden, die Ihre Anwendung lädt.