Soglasje za piškotke za Next.js
Cookiezy daje Next.js ekipam sodobno consent plast, ki ustreza App Router projektom, strežniško izrisanim stranem in lokaliziranim marketinškim stranem. Paketirani Next.js tok uporablja iste `plain-html` adapter datoteke iz `cookiezy-platform-core.zip`, vendar jih integrira prek Next-specifičnega root layout vzorca in se za polni runtime način opira na registrirane hostname-e.
Zgrajeno za Next.js ekipe, ki jim veliko pomenijo zmogljivost, consent stanje in kakovost implementacije.
Predogled bannerja za piškotke
Lahko. Hitro. Privzeto jasno.
Soglasje za piškotke. Brez zapletov.
Lahka rešitev za soglasje, ki ohrani stran hitro in podatke uporabne.
Kaj vključuje Next.js paket
Po aktivaciji dostopa preneseš `cookiezy-platform-core.zip`. Za Next.js uporabiš iste `plain-html` adapter datoteke iz `packages/adapters/plain-html/` in skupne core datoteke iz `packages/core/dist/`. Canonical vstopna datoteka adapterja je `cookiezy-plain-adapter.js`.
- • `packages/adapters/plain-html/cookiezy-plain-adapter.js`
- • `packages/core/dist/cookie-consent.js`
- • `packages/core/dist/cookie-consent-ui.js`
- • `packages/core/dist/cookie-consent-scanner.js`
- • `packages/core/dist/cookie-consent.css`
- • `packages/adapters/plain-html/example.html` kot referenčni integracijski vzorec
Canonical adapter datoteke kopiraj v Next.js public mapo
Razširi `cookiezy-platform-core.zip` in `cookiezy-plain-adapter.js` skupaj s skupnimi core datotekami postavi v `public/`, da se lahko naložijo iz root layouta čez vse poti in locale-e.
Code snippet
public/cookiezy-plain-adapter.js
public/cookie-consent.js
public/cookie-consent-ui.js
public/cookie-consent-scanner.js
public/cookie-consent.cssCookiezy naloži in zaženi iz app/layout.tsx
V root layout dodaj CSS in skripte, nato pa plain adapter zaženi z locale-om, policy potjo in izdanimi licensing vrednostmi. Tako consent plast ostane dostopna na vseh App Router straneh. Pomembno: adapter zaženi pred nalaganjem `cookie-consent.js`, ker core runtime licenco preveri takoj ob loadu. Če `license.siteKey` ali `license.verifyUrl` manjkata, ali če se core skripta zažene pred `CookiezyPlainAdapter.boot(...)`, runtime ostane v `license_not_configured` restricted načinu.
Code snippet
<link rel="stylesheet" href="/cookie-consent.css" />
<script src="/cookiezy-plain-adapter.js"></script>
<script>
window.CookiezyPlainAdapter.boot({
locale: "sl",
storageKey: "cookiezy_next_v1",
policyUrl: "/sl/politika-piskotkov",
theme: { layout: "bottom-right", themeClass: "" },
license: {
siteKey: "ck_live_replace_me",
verifyUrl: "https://cookiezy.com/api/licensing/verify",
billingUrl: "https://cookiezy.com/sl/billing"
},
texts: {}
});
</script>
<script src="/cookie-consent.js"></script>
<script src="/cookie-consent-ui.js"></script>
<script src="/cookie-consent-scanner.js"></script>Registriraj live hostname, settings link in policy audit
Pred objavo registriraj vse live hostname v Cookiezy billing, da runtime verification vrne `allowed: true`. Ko se skripte naložijo, registriraj footer povezavo do nastavitev in na policy strani pripni cookie audit. Nato v čisti seji preveri domačo stran, cenik in vsaj eno lokalizirano pot.
Code snippet
window.CookiezyPlainAdapter.registerSettingsLink(document);
if (window.location.pathname === '/sl/politika-piskotkov') {
window.CookiezyPlainAdapter.mountAudit(document);
}
const consent = window.Cookiezy?.getConsent();
if (consent?.analytics) {
startAnalytics();
}Na Next.js policy strani dodaj živ pregled piškotkov
Cookiezy lahko na implementirani strani skenira trenutno sejo brskalnika in prikaže zaznane piškotke s kategorijo, ponudnikom, namenom oziroma opisom in trajanjem. V Next.js audit pripni samo na policy poti, da stran jasno pokaže, kaj se spremeni po sprejemu, zavrnitvi ali posodobitvi soglasja.
Pregled aktivnih piškotkov v tej seji brskalnika
Ta pregled prebere piškotke, ki so trenutno vidni na domeni v tvojem brskalniku, in znane piškotke preslika v kategorije in namene. Po spremembi nastavitev piškotkov lahko pregled znova zaženeš.
Kako Cookiezy upravlja piškotke na tej strani
Nujni piškotki ostanejo aktivni, da spletna stran, prijava in nastavitve piškotkov delujejo pravilno. Opcijske kategorije lahko obiskovalec vključi ali izključi v nastavitvah piškotkov Cookiezy.
Ta pregled odraža trenutno sejo brskalnika in trenutno stanje soglasja za piškotke na tej napravi.
Kategorije piškotkov na strani
Nujni piškotki
Potrebni za varnost, usmerjanje, prijavo in shranjevanje same izbire glede piškotkov.
Analitični piškotki
Uporabljeni za razumevanje obiska in uporabe strani, če je obiskovalec dovolil analitične piškotke.
Marketinški piškotki
Namenjeni so oglaševanju, ponovnemu nagovarjanju in spremljanju kampanj, če so oglaševalski piškotki dovoljeni.
Consent funkcionalnosti za sodobne Next.js strani
Boljši fit za ekipe, ki uporabljajo App Router, lokalizirane poti in strani, občutljive na zmogljivost.
Prijazno do App Routerja
Praktična consent plast za sodobne Next.js strukture in route-driven izkušnje.
Podpora za lokalizirane poti
Dobro deluje z locale-based URL strukturami in routingom do policy strani.
Audit na policy strani
Pregled piškotkov pripni na policy stran z istimi plain adapter helperji kot pri prilagojenih frontendih.
Lahkoten runtime
Za performance-conscious strani boljši fit kot težja banner orodja.
Pogosta vprašanja za Next.js
Uporabni odgovori za ekipe, ki ocenjujejo upravljanje soglasja v Next.js.
Kateri ZIP uporabim za Next.js?
Uporabi `cookiezy-platform-core.zip` in poveži plain adapter datoteke iz `packages/adapters/plain-html/` skupaj s skupnimi core datotekami v `packages/core/dist/`.
Kje naj v Next.js naložim Cookiezy?
Naloži ga iz root app layouta, da je consent plast dostopna čez vse poti in locale-e, `CookiezyPlainAdapter.boot(...)` pa naj se izvede pred `cookie-consent.js`.
Kakšna je razlika med Next.js in headless tukaj?
Next.js je framework-specifičen integracijski tok. Headless opisuje bolj generično prilagojeno frontend arhitekturo. Obe poti trenutno uporabljata iste osnovne `plain-html` adapter datoteke, vendar mora Next.js slediti root layout in route-aware vzorcu iz Next.js vodiča.
Ali Cookiezy podpira lokalizirane Next.js strani?
Da. Dobro se ujame z locale-based routingom, tudi kadar se policy strani razlikujejo po jeziku.
Kako prikažem pregled piškotkov na policy strani?
Na policy poti po nalaganju scanner skripte pokliči `window.CookiezyPlainAdapter.mountAudit(document)`.
Kaj se zgodi, če billing ni aktiven ali hostname ni registriran?
Next.js runtime mora pasti nazaj v nujni restricted način. Opcijska analitika, marketing in premium runtime obnašanje ostanejo blokirani, dokler račun ni aktiven in hostname dovoljen.