Liigu sisu juurde

Keel

Dokumentatsiooni menüü

Kiirjuhend

Paigalda Cookiesh minutitega tavalise HTML-i, Next.js-i või Google Tag Manageriga ning veendu, et kolmanda osapoole skriptid jäävad blokeerituks, kuni külastajad nõustuvad.

Viimati uuendatud 29. oktoober 2026

Cookiesh töötab ühe skriptimärgendiga. Laadi see enne kõiki teisi lehel olevaid märgendeid, märgi nõusolekut vajavad skriptid kategooriaga ja Cookiesh näitab igale külastajale tema piirkonnale sobivat bännerit, blokeerib need skriptid, kuni külastaja nõustub, ning salvestab valiku. Enamik saite on töös vähem kui viie minutiga.

Enne alustamist

Vajad Cookiesh kontot ja saiti. Ava töölaual Domains → Add domain, sisesta oma domeen ja kopeeri Site ID. See näeb välja selline: ck_live_8f2a91.

Cookiesh jagab kõik nelja nõusolekukategooria vahel:

Kategooria Vaikeseade Tüüpiline kasutus
necessary Alati sees Seansid, turvalisus, koormusjaotus, nõusolekuküpsis ise
preferences Väljas Keel, teema ja muud meelde jäetud seaded
analytics Väljas Toote- ja liiklusanalüütika
marketing Väljas Reklaam, taassihtimine ja sotsiaalmeedia pikslid

Käivita enne tootmisse minekut töölaual oma esimene küpsiste skannimine. Seejärel teab Cookiesh, millised skriptid ja küpsised millisesse kategooriasse kuuluvad, ning oskab sinu bänneri eelnevalt täita.

Paigaldamine HTML-iga

Lisa laadija esimese skriptina elementi <head>, et see käivituks enne kõike, mis küpsiseid seab:

<head>
  <script
    src="https://sdk.cookiesh.eu/v1/cookiesh.js"
    data-site-id="ck_live_8f2a91"
    async
  ></script>
  <!-- muud märgendid allpool -->
</head>

Seejärel muuda iga nõusolekut vajav skript tüübilt type="text/javascript" tüübiks type="text/plain" ja lisa kategooriaga data-cookiesh. Cookiesh vahetab tüübi tagasi ja käivitab skripti, kui külastaja selle kategooria lubab:

<script
  type="text/plain"
  data-cookiesh="analytics"
  src="https://analytics.example.com/script.js"
></script>

<script type="text/plain" data-cookiesh="marketing">
  // Reasisesed skriptid töötavad samamoodi.
  initAdPixel();
</script>

Ka iframe’e, näiteks manustatud videoid ja kaarte, saab blokeerida. Kasuta src asemel atribuuti data-cookiesh-src ja Cookiesh laadib need pärast nõusolekut.

Paigaldamine Next.js-iga

Paigalda React SDK:

npm install @cookiesh/react

Laadi skript oma juurpaigutuses strateegiaga beforeInteractive, et see töötaks enne teisi skripte, ja mähi rakendus komponenti CookieshProvider:

// app/layout.tsx
import Script from 'next/script';
import { CookieshProvider } from '@cookiesh/react';

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="en">
      <body>
        <Script
          src="https://sdk.cookiesh.eu/v1/cookiesh.js"
          data-site-id={process.env.NEXT_PUBLIC_COOKIESH_SITE_ID}
          strategy="beforeInteractive"
        />
        <CookieshProvider>{children}</CookieshProvider>
      </body>
    </html>
  );
}

Renderda nõusolekust sõltuv kood ainult siis, kui kategooria on lubatud. useConsent() renderdab uuesti iga kord, kui külastaja oma valikut muudab:

// app/analytics.tsx
'use client';

import Script from 'next/script';
import { useConsent } from '@cookiesh/react';

export function Analytics() {
  const { analytics } = useConsent();
  if (!analytics) return null;

  return <Script src="https://analytics.example.com/script.js" strategy="afterInteractive" />;
}

Sisselogimisega toodete puhul anna CookieshProviderile userId, et külastaja valik seadmete vahel sünkroonida.

Paigaldamine Google Tag Manageriga

Cookiesh kogukonnamall seab Google Consent Mode v2 vaikeväärtused enne mis tahes märgendi käivitumist ja uuendab neid, kui külastaja valiku teeb.

  1. Ava oma GTM-konteineris Templates → Tag templates → Search gallery ja lisa Cookiesh CMP.
  2. Loo mallist uus märgend ja kleebi sisse oma Site ID.
  3. Sea päästikuks Consent Initialization – All Pages.
  4. Vali iga piirkonna jaoks vaikimisi nõusolekuolek. EMP, Ühendkuningriigi ja Šveitsi jaoks kasuta väärtust denied.
  5. Ava iga Google’i märgendi puhul Advanced settings → Consent settings. Jäta sisseehitatud nõusolekukontrollid sisse ja nõua lisanõusolekut mitte-Google’i märgendite jaoks.
  6. Avalda konteiner.

Kui laadid gtag.js-i ilma GTM-ita, sea vaikeväärtused ise, enne Google’i märgendit:

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

  gtag('consent', 'default', {
    ad_storage: 'denied',
    ad_user_data: 'denied',
    ad_personalization: 'denied',
    analytics_storage: 'denied',
    wait_for_update: 500,
  });
</script>

Cookiesh saadab sobiva kutse gtag('consent', 'update', …) kohe, kui külastaja valiku teeb, ja igal järgneval lehevaatamisel.

Paigalduse kontrollimine

  1. Ava oma sait privaatses aknas. Bänner peaks ilmuma ja brauseri arendaja tööriistades ei tohiks veel olla analüütika- ega turundusküpsiseid.
  2. Käivita konsoolis Cookiesh.debug(). See loetleb tuvastatud piirkonna, aktiivse bänneri, iga blokeeritud skripti ja praeguse nõusolekuoleku.
  3. Nõustu ainult analüütikaga ja laadi leht uuesti. Analüütikaskriptid töötavad, kuid turundusskriptid jäävad blokeerituks.
  4. Kontrolli Google Tag Assistantis, et vahekaardil Consent oleksid vaike- ja uuendussündmused õiges järjekorras.

Järgmised sammud