Cookiesamtykke bygget til React-applikationer.
Tilføj CookieHub til din React-app med react-cookiehub, hold samtykketilstanden ensartet under navigation på klientsiden, og styr, hvornår analyse-, marketing- og indlejrede tjenester må køre.
- React-pakke
- SPA-venlig samtykketilstand
- Samtykkestyrede scripts
Én samtykketilstand i hele din React-app.
React-apps indlæses ikke som traditionelle websites. Komponenter mountes, mens besøgende bevæger sig rundt i appen, ruter skifter uden en fuld genindlæsning af siden, og scripts kan indlæses dynamisk – så tracking kan blive udløst, før en besøgende har truffet et valg, hvis samtykke ikke håndteres ét sted.
CookieHub giver din React-app et centralt samtykkelag. Initialiser det én gang i roden af din app med react-cookiehub, og indlæs derefter analyse-, marketing- og andre ikke-nødvendige værktøjer, først når den besøgende har tilladt den relevante samtykkekategori.
Scripts indlæses først efter samtykke
Initialiser kun analyse-, marketing- eller andre ikke-nødvendige værktøjer, når den relevante kategori er tilladt.
SPA-venligt samtykke
Initialiser CookieHub centralt, og hold de besøgendes samtykke ensartet ved ruteskift på klientsiden.
React-specifikke kontroller
Brug pakkens React-komponenter og events i stedet for at sprede samtykketjek ud over hele appen.
Samtykkekontroller designet til React.
react-cookiehub er CookieHubs pakke til React- og Next.js-apps. Den indlæser CookieHub fra roden af din app og giver dig komponenter og events til alt, der skal vente på samtykke:
- CookieHub.initialize() indlæser CookieHub med din domænekode
- CookieHubScript indlæser et eksternt eller inline script i den samtykkekategori, du angiver
- CookieHubGA og CookieHubPixel indlæser Google Analytics og Meta Pixel under kategorierne analyse og marketing
- CookieHubYoutube indlejrer YouTube-videoer via en youtube-nocookie-URL
- onAllow, onRevoke og andre events lader din app reagere, når samtykket ændres
Pakkevejledningen har den fulde reference, herunder opsætning til Next.js App Router og Pages Router.
Se pakkevejledningenVærktøjer til cookiesamtykke i din React-app.
Scripts indlæses først efter samtykke
CookieHubScript tilføjer et script i den samtykkekategori, du vælger – f.eks. analyse, marketing eller præferencer – så det først kører, når den besøgende tillader kategorien.
Stabilt samtykke ved ruteskift
CookieHub indlæses én gang fra roden af din app. Navigation på klientsiden genindlæser ikke siden, så den besøgendes valg gælder fortsat, når ruterne skifter.
Google Analytics-komponent
CookieHubGA indlæser Google Analytics med dit tracking-ID under kategorien analyse, så det venter på samtykke til analyse.
Meta Pixel-komponent
CookieHubPixel indlæser Meta (Facebook) Pixel med dit pixel-ID under kategorien marketing, så den venter på samtykke til marketing.
Kontrol med indlejrede medier
CookieHubYoutube indlejrer en YouTube-video ud fra dens URL eller video-ID via en youtube-nocookie-URL, som ikke sætter YouTubes tracking-cookies.
Samtykke-events og API
Events som onAllow, onRevoke og onStatusChange og metoder som hasConsented() og openSettings() lader din app reagere på samtykke uden at genindlæse siden.
Tilføj CookieHub til React i få trin.
Trinene følger pakkevejledningen til react-cookiehub. Bygger du med Next.js? Der initialiseres CookieHub på klientsiden – se noterne nedenfor.
- 01
Installer pakken
Tilføj react-cookiehub til dit React-projekt.
npm install react-cookiehub - 02
Initialiser CookieHub med din domænekode
Hvert domæne, du tilføjer i CookieHub-dashboardet, får en unik domænekode på 8 tegn. Importér CookieHub fra react-cookiehub, og kald CookieHub.initialize() med koden i din rodkomponent, f.eks. App.js, så det gælder for hele appen.
CookieHub.initialize('YOUR-DOMAIN-CODE') - 03
Indlæs ikke-nødvendige tjenester via CookieHub
Tilføj scripts med CookieHubScript og deres samtykkekategori, eller brug CookieHubGA, CookieHubPixel og CookieHubYoutube. Til andre tracking-pakker bruger du onInitialise til at håndtere eksisterende samtykke og onAllow, når der gives nyt samtykke.
category="analytics" - 04
Test samtykket ved ruteskift
Kontrollér, at tracking ikke kører før samtykke, skift derefter mellem ruter, og ændr dit valg i indstillingsdialogen. Angiv debug: true i indstillingerne for flere detaljer i konsollen.
debug: true
Bruger du Next.js App Router?
CookieHub bruger browser-API’er som window, så initialiser det på klientsiden: Opret en klientkomponent, der kalder CookieHub.initialize() i useEffect, og render den i dit rodlayout.
Opsætning til Next.js App RouterBruger du Next.js Pages Router?
Kald CookieHub.initialize() i useEffect i din _app-fil, så CookieHub ikke kører på serveren. Da Next.js kan påvirke rækkefølgen, scripts indlæses i, anbefaler pakkevejledningen CookieHubs script-komponenter.
Opsætning til Next.js Pages Router
Bevar samtykket, når din app skifter rute.
I en single-page-app mounter React komponenter og indlæser tjenester, mens besøgende navigerer – uden en fuld genindlæsning af siden. react-cookiehub tilføjer CookieHub én gang fra roden af din app, så den besøgendes samtykkebeslutning er tilgængelig for alle ruter og komponenter.
- Din rodkomponent initialiserer CookieHub
- CookieHub holder den besøgendes samtykketilstand
- Ruter skifter uden genindlæsning af siden
- Scripts kører kun i tilladte kategorier
Indlæs tredjepartsscripts først efter samtykke.
react-cookiehub dækker de scripts, du tilføjer via dens komponenter. Scripts, som din app indlæser på anden vis, holdes ikke tilbage af pakken af sig selv: Indlæs dem via CookieHubScript, eller tag dem til samtykke. Egne tracking-pakker bør tjekke eksisterende samtykke i onInitialise og starte ved nyt samtykke i onAllow.
Sådan virker blokering af scriptsScripts i dine komponenter
CookieHubScript tager et eksternt script (src) eller et inline script (innerHTML) og den kategori, det hører til, og kører det, når den besøgende tillader kategorien.
Google Analytics og Meta Pixel
CookieHubGA holder Google Analytics tilbage indtil samtykke til analyse; CookieHubPixel holder Meta (Facebook) Pixel tilbage indtil samtykke til marketing.
Andre tracking-pakker til React
Pakker, der kræver deres egen initialisering, kan starte i eventet onInitialise eller i onAllow, når en kategori som analyse er tilladt.
Indlejrede YouTube-videoer
CookieHubYoutube indlejrer en video ud fra dens URL eller video-ID via en youtube-nocookie-URL med valgfri bredde og højde.
Reagér, når samtykket ændres.
Når en besøgende ændrer sit valg, skal din app måske reagere med det samme – starte en tracking-pakke, stoppe en eller opdatere brugerfladen. Giv event-handlere til CookieHub.initialize() for at handle på samtykke uden at genindlæse siden:
- onInitialise kører, når CookieHub er initialiseret
- onAllow kører, når den besøgende tillader en kategori, f.eks. analyse
- onRevoke kører, når den besøgende trækker en kategori tilbage, f.eks. marketing
- onStatusChange kører, når den besøgende opdaterer sin samtykketilstand
Metoder som hasConsented(category), hasAnswered(), openSettings(), allowAll() og denyAll() lader dine komponenter kontrollere samtykke, åbne indstillingsdialogen eller tillade eller afvise alle kategorier. Se CookieHubs JavaScript-API for flere muligheder.
Udforsk JavaScript-API’enSpørgsmål om React, besvaret.
Indlæs dem via react-cookiehub. CookieHubScript tager et eksternt eller inline script og den samtykkekategori, det hører til, og kører det først, når den besøgende tillader kategorien. Til tracking-pakker, som du starter i koden, tjekker du eksisterende samtykke med hasConsented() i onInitialise og starter dem i onAllow, når den besøgende giver samtykke senere.
Ja. react-cookiehub er ikke bundet til en bestemt router: Du initialiserer CookieHub én gang i din rodkomponent, og ruteskift på klientsiden genindlæser ikke siden, så den besøgendes valg gælder fortsat, når de bevæger sig mellem ruter. Initialiser det i roden frem for i enkelte ruter.
Ja. Komponenten CookieHubGA tager dit Google Analytics-tracking-ID og indlæser Google Analytics under kategorien analyse, så det ikke kører, før den besøgende tillader analysecookies.
Ja. Komponenten CookieHubPixel tager dit Meta (Facebook) Pixel-ID og indlæser pixlen under kategorien marketing, så den ikke kører, før den besøgende tillader marketingcookies.
Giv event-handlere med, når du initialiserer CookieHub: onAllow og onRevoke modtager den kategori, den besøgende har tilladt eller trukket tilbage, og onStatusChange kører, når de opdaterer deres valg. Du kan også til enhver tid kontrollere samtykket med hasConsented(category) eller bruge CookieHubs JavaScript-API.
I CookieHub-dashboardet. Hvert domæne, du tilføjer, får en unik domænekode på 8 tegn, som vises på din liste over domæner. Giv den til CookieHub.initialize() i stedet for YOUR-DOMAIN-CODE.
Ja. Pakkevejledningen til react-cookiehub dækker både Next.js App Router og Pages Router. Den nævner også, at Next.js kan give problemer med rækkefølgen, scripts indlæses i, og anbefaler derfor at indlæse tracking-scripts med CookieHubs script-komponenter.
Ja. CookieHub bruger browser-API’er som window, så pakkedokumentationen anbefaler initialisering på klientsiden. Med App Router kalder du CookieHub.initialize() i useEffect i en klientkomponent, der renderes fra dit rodlayout; med Pages Router kalder du den i useEffect i din _app-fil.
Ja. Hvis din React-app allerede indlæser sine tags via Google Tag Manager, kan du installere CookieHub via GTM med skabelonen CookieHub CMP i stedet for react-cookiehub. Brug én implementering, ikke begge.
CookieHub tilbyder værktøjer, der hjælper ejere af React-apps med at opfylde samtykkekravene i privatlivslove som GDPR, CCPA og LGPD: et samtykkebanner, samtykkestyret indlæsning af de scripts, du tilføjer via CookieHub, registrering af samtykkebeslutninger og en cookieerklæring, der holdes opdateret.
Tilføj samtykkehåndtering til din React-app.
Brug CookieHubs React-integration til at holde de besøgendes samtykke forbundet med de scripts og tjenester, din applikation indlæser.