Soglasje za piškotke za headless strani
Cookiezy je močan fit za headless ekipe, ki želijo API-first nadzor, prilagodljivo izrisovanje in consent model, ki ga lahko delijo čez več frontendov. V tem kontekstu `headless` opisuje tip projekta, `plain-html` pa dejanski osnovni adapter lane v Platform Core paketu. Generirane prenose poveži z registriranim produkcijskim hostname-om, da runtime verification omogoči polni način delovanja.
Zgrajeno za lastne stacke, kjer so pomembni nadzor, zmogljivost in doslednost.
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 headless rollout dejansko uporablja
Po aktivaciji dostopa preneseš `cookiezy-platform-core.zip`. Za prilagojene fronte so pomembne skupne core datoteke iz `packages/core/dist/` in `plain-html` adapter datoteke v `packages/adapters/plain-html/`. Canonical vstopna datoteka je `cookiezy-plain-adapter.js`; `headless-bootstrap.js` ostaja samo kot zastarel kompatibilnostni ovoj.
- • `packages/adapters/plain-html/cookiezy-plain-adapter.js`
- • `packages/adapters/plain-html/example.html`
- • `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`
Canonical plain adapter in core datoteke postavi v app shell
Razširi `cookiezy-platform-core.zip`, nato pa `cookiezy-plain-adapter.js` in skupne core datoteke postavi na pot, ki jo tvoja stran dejansko servira, na primer `/cookiezy/`. Spodnji primer predpostavlja, da so datoteke tam; Cookiezy trenutno ne ponuja javnega CDN-ja za te assete.
Code snippet
<link rel="stylesheet" href="/cookiezy/cookie-consent.css">
<script src="/cookiezy/cookiezy-plain-adapter.js"></script>
<script src="/cookiezy/cookie-consent.js"></script>Zaženi plain adapter z locale-om, policy URL-jem in licensing vrednostmi iz izdanega ZIP-a
Uporabi isti vzorec kot v `packages/adapters/plain-html/example.html`. Adapter zaženi, preden naložiš UI in scanner skripte, da runtime pozna locale, storage key, policy pot in licensing kontekst. V produkciji ne izpusti `license.siteKey` ali `license.verifyUrl`, sicer runtime takoj pade v `license_not_configured` restricted način.
Code snippet
<script>
window.CookiezyPlainAdapter.boot({
locale: "sl",
storageKey: "cookiezy_headless_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="/cookiezy/cookie-consent-ui.js"></script>
<script src="/cookiezy/cookie-consent-scanner.js"></script>Registriraj live hostname, povezavo do nastavitev in pregled piškotkov
Pred produkcijsko objavo registriraj vse live hostname v Cookiezy billing, da lahko runtime verification vrne `allowed: true`. Ko se skripte naložijo, helper metode plain adapterja poveži s svojim frontendom. Za footer povezavo uporabi `registerSettingsLink(document)`, na policy strani pa `mountAudit(document)`, da lahko obiskovalci pregledajo živo stanje piškotkov.
Code snippet
<script>
window.CookiezyPlainAdapter.registerSettingsLink(document);
window.CookiezyPlainAdapter.mountAudit(document);
</script>Prikaži piškotke, ki jih tvoja headless stran dejansko uporablja
Headless adapter vključuje policy-page audit mount, ki skenira trenutno sejo brskalnika in prikaže zaznane piškotke s kategorijo, ponudnikom, namenom oziroma opisom in trajanjem. Na strani s politiko piškotkov uporabi isti helper `mountAudit(document)`, da lahko obiskovalci po spremembi soglasja znova preverijo stanje.
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.
Zgrajeno za API-first consent tokove
Boljši fit za razvojno vodene ekipe, ki potrebujejo prilagodljivost, ne pa rigidnega plugin obnašanja.
Nadzor nad lastnim izrisom
Consent logiko vključi v svojo frontend arhitekturo in vizualni sistem.
Skupna consent logika
Uporabi en model soglasja čez več frontend izkušenj in locale-ov.
Audit na policy strani
Plain adapter vključuje helper metode za povezavo do nastavitev in audit mount tok.
Pripravljeno za headless rollout
Močnejša osnova za ekipe, ki ne želijo framework lock-ina ali želijo izdane pakete z runtime verification.
Pogosta vprašanja za headless postavitve
Odgovori za ekipe, ki gradijo prilagojene strani in composable fronte.
Kateri ZIP uporabim za prilagojen frontend?
Uporabi `cookiezy-platform-core.zip` in združi skupne core datoteke iz `packages/core/dist/` s plain adapter datotekami iz `packages/adapters/plain-html/`.
Kakšna je razlika med headless in plain-html?
Headless opisuje tip prilagojene frontend arhitekture. `plain-html` pa je dejanski osnovni adapter lane, s katerim v takem okolju zaženeš Cookiezy. Canonical vstopna datoteka je `cookiezy-plain-adapter.js`, referenčni vzorec pa je v `packages/adapters/plain-html/example.html`.
Kako povežem footer povezavo do nastavitev?
Ko se skripte naložijo, uporabi `window.CookiezyPlainAdapter.registerSettingsLink(document)`.
Kako prikažem pregled piškotkov na policy strani?
Na policy strani po nalaganju scanner skripte pokliči `window.CookiezyPlainAdapter.mountAudit(document)`.
Kaj se zgodi, če live hostname ni registriran ali billing ni aktiven?
Runtime mora pasti nazaj v nujni restricted način. V praksi opcijska analitika, marketing in premium obnašanje ostanejo blokirani, dokler hostname ni registriran in račun znova v dobrem stanju.