Dokumentacija nazadnje dopolnjena 27. maj 2026
Soglasje za piškotke za Shopify
Cookiezy daje Shopify ekipam čistejši način za upravljanje soglasja z dejanskim theme app extension paketom. Storefront vstopna točka je `cookie-consent-shopify-loader.js`, ki naloži skupni consent runtime, UI, scanner in opcijski Shopify bridge za customer privacy. Pri večjih rolloutih se lahko paketni tok poveže tudi z vgrajenim Shopify admin okoljem za onboarding, billing in podporo.
Praktična Shopify consent plast za trgovce, ecommerce ekipe in agencije.
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 Shopify ZIP
Po aktivaciji dostopa preneseš `cookiezy-platform-core.zip`. Za Shopify uporabiš theme app extension bundle iz `packages/adapters/shopify/theme-app-extension/`. Extension je storefront runtime plast, opcijski embedded app scaffold pa je ločena admin in billing površina za naprednejše rollout scenarije.
- • `assets/cookie-consent-shopify-loader.js`
- • `assets/cookie-consent.js`
- • `assets/cookie-consent-ui.js`
- • `assets/cookie-consent-scanner.js`
- • `assets/cookie-consent.css`
- • `assets/shopify-customer-privacy-bridge.js`
- • `blocks/cookiezy-embed.liquid`
- • `shopify.extension.toml`
Prenesi theme app extension datoteke v Shopify app ali store package
Razširi `cookiezy-platform-core.zip` in prenesi celotno vsebino Shopify extensiona iz `packages/adapters/shopify/theme-app-extension/` v svoj Shopify app ali extension workspace. Imena assetov ohrani nespremenjena, ker jih embed blok uporablja neposredno.
- • Ohrani `cookie-consent-shopify-loader.js` kot glavno storefront vstopno točko
- • Vključi `shopify-customer-privacy-bridge.js`, če želiš poravnati Shopify privacy dogodke s Cookiezy
- • Ne preimenuj Liquid bloka ali asset datotek
V theme editorju omogoči Cookiezy embed blok
Objavi theme app extension in v Shopify theme customizerju omogoči `cookiezy-embed`. Blok vbrizga stylesheet, `window.CookiezyConfig`, licensing polja, vezana na račun, in vstopno točko `cookie-consent-shopify-loader.js`.
Code snippet
{{ 'cookie-consent.css' | asset_url | stylesheet_tag }}
<script>
window.CookiezyConfig = {
locale: "sl",
policyUrl: "/sl/politika-piskotkov",
shopify: {
assets: {
coreUrl: "{{ 'cookie-consent.js' | asset_url }}",
uiUrl: "{{ 'cookie-consent-ui.js' | asset_url }}",
scannerUrl: "{{ 'cookie-consent-scanner.js' | asset_url }}",
bridgeUrl: "{{ 'shopify-customer-privacy-bridge.js' | asset_url }}"
}
}
};
</script>
<script defer src="{{ 'cookie-consent-shopify-loader.js' | asset_url }}"></script>Pred posegom v živo temo najprej uporabi development store
Najčistejša prva rollout pot je Shopify development store skupaj z extension-only appom. Tako lahko pred objavo preveriš theme app extension, Theme Editor polja in storefront vedenje.
- • V Partner Dashboardu ustvari Shopify development store.
- • Za prvi storefront smoke test ustvari extension-only app.
- • Generiraj theme app extension in vanj kopiraj Cookiezy Shopify datoteke.
- • V Theme Editorju potrdi, da blok prikaže Cookie policy URL, Cookiezy Site Key, License verification URL, Billing / portal URL, Banner layout in Theme CSS class.
Registriraj produkcijsko domeno in preveri obnašanje soglasja
Pred objavo registriraj live storefront hostname v Cookiezy billing, da lahko runtime verification vrne `allowed: true`. Nato v Shopify theme preview preveri banner na vstopni strani, kolekciji, produktu in košarici. Potrdi, da opcijsko sledenje ostane blokirano do soglasja in da policy stran pravilno prikaže audit.
- • Preveri domačo stran, produktno stran in košarico v čisti seji
- • Registriraj točen storefront hostname, na katerem testiraš, ne glede na to, ali gre za `myshopify.com` ali custom domeno
- • Potrdi, da se banner naloži prek embed bloka brez ročnega urejanja `theme.liquid`
- • Preveri, da analitika in marketing čakata na soglasje
- • Odpri `/sl/politika-piskotkov` in po vsaki spremembi soglasja ponovno preveri pregled piškotkov
Prikaži piškotke, aktivne na tvojem Shopify storefrontu
Cookiezy lahko na policy strani doda audit, ki skenira živo storefront sejo in prikaže zaznane piškotke s kategorijo, ponudnikom, namenom oziroma opisom in trajanjem. Tako imajo trgovci in obiskovalci jasnejši vpogled v to, kaj ostane aktivno po spremembi analitičnega ali marketinškega 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, ki ustrezajo ecommerce toku
Zasnovano za Shopify trgovine, ki jim veliko pomenijo UX, skladnost in hitrost storefronta.
Pripravljeno za theme app extension
Paket vključuje dejanski Shopify embed blok namesto generične copy-paste skripte.
Storefront-safe UI
Čistejša banner izkušnja, ki se lepše vključi v sodobne ecommerce postavitve.
Marketing, usklajen s soglasjem
Zmanjšaj tveganje, da se opcijska analitika ali marketing naložita prezgodaj.
Shopify privacy bridge
Uporabi vključeni bridge asset, ko želiš, da Cookiezy in Shopify privacy signalizacija ostaneta usklajena.
Admin rollout pot
Storefront extension lahko povežeš z opcijskim embedded Shopify admin okoljem za onboarding, billing in podporna stanja.
Pogosta vprašanja za Shopify
Najpogostejša vprašanja Shopify ekip, ki ocenjujejo consent platformo.
Katera datoteka dejansko naloži Cookiezy na storefrontu?
Storefront vstopna točka je `cookie-consent-shopify-loader.js`. Ta naloži skupni runtime, UI, scanner in opcijski Shopify bridge.
Ali moram ročno urejati `theme.liquid`?
Ne pri paketiranem adapter toku. Predvidena pot je objava theme app extensiona in omogočanje bloka `cookiezy-embed` v theme editorju.
Čemu služi Shopify customer privacy bridge?
Datoteka `shopify-customer-privacy-bridge.js` pomaga poravnati Cookiezy s Shopify customer privacy plastjo, ko želiš, da dogodki ostanejo usklajeni.
Ali lahko obiskovalci pozneje ponovno odprejo nastavitve soglasja?
Da. Cookiezy podpira trajno pot za ponovno odpiranje nastavitev, da lahko obiskovalci pozneje spremenijo izbiro.
Kaj se zgodi, če billing ni aktiven ali trgovinska domena ni dovoljena?
Storefront runtime mora pasti nazaj v nujni restricted način. Opcijska analitika, marketing in premium obnašanje ostanejo blokirani, dokler trgovina ni znova v dobrem stanju in runtime verification ne vrne `allowed: true`.
Zakaj se restricted mode na Shopifyju lahko še vedno pojavi?
Najpogostejši razlogi so manjkajoče vrednosti `siteKey`, `verifyUrl` ali `billingUrl` v `window.CookiezyConfig` oziroma neskladje med registriranim Cookiezy hostname-om in storefront hostname-om, ki ga dejansko testiraš.