Jeden skript, pár metód

Toto sú všetky metódy globálneho objektu. Na tvojom webe beží verzia 2.0.0: zistíš to, keď do konzoly prehliadača napíšeš Conseto.version.

Conseto.init()

Spustí skript a vráti promise. Zavolaj ju raz. Promise zlyhá, ak chýba clientId.

Conseto.track()

Pošle vlastnú udalosť: meno a voliteľný objekt s detailmi.

Conseto.updateConsent()

Zaznamená rozhodnutie o súhlase pre kategórie, ktoré pošleš (chýbajúce sa počítajú ako odmietnuté), uloží ho v prehliadači a povie to Google Consent Mode.

Conseto.getConsent()

Vráti uložené rozhodnutie alebo null, ak žiadne nie je.

Conseto.clearConsent()

Zmaže uložené rozhodnutie. Banner sa opýta znova pri ďalšom načítaní stránky.

Conseto.showBanner()

Ukáže banner hneď. Ak už je nejaký otvorený, nerobí nič.

Conseto.hideBanner()

Zavrie banner.

Conseto.openCookieSettings()

Otvorí nastavenia bannera, pre odkaz Nastavenia cookies.

Conseto.version

Verzia skriptu, ktorý beží.

Conseto.instance

Analytické jadro po funkcii init, pred ňou null. Je na ňom destroy().

Conseto.version; // "2.0.0": which build runs on this site

Povinné je len clientId. Čo vynecháš, vezme sa z nastavení projektu v appke, a čo vynechajú tie, má predvolenú hodnotu.

<script src="https://www.conseto.io/dist/conseto.min.js"></script>
<script>
  Conseto.init({
    clientId: 'conseto_xxx_xxx',
    language: 'sk',
    theme: 'auto',
    accentColor: '#3B82F6',
    cookiePolicyUrl: '/cookies',
    privacyPolicyUrl: '/privacy'
  });
</script>

clientId

ID tvojho projektu. Povinné.

language

Jazyk bannera ako dvojpísmenový kód. Bez neho: nastavenie projektu, potom prehliadač návštevníka.

theme

light, dark alebo auto.

layout

Ignoruje sa. Lišta je vždy okno v strede stránky: tento smer sme zvolili po skúške zo 16. až 29. 8. 2026.

accentColor

Farba tlačidla Prijať, ako hex hodnota.

autoConsent

Daj false a init banner neukáže. Potom zavoláš showBanner() sám. Kým sa návštevník, ktorý musí súhlasiť vopred, nerozhodne, neodíde žiadna udalosť.

cookiePolicyUrl

Kam vedie odkaz na zásady cookies v banneri. Predvolene /cookie-policy.

privacyPolicyUrl

Kam vedie odkaz na zásady ochrany údajov. Predvolene /privacy.

showRejectOnFirstView

Ignoruje sa. Odmietnuť všetko je na prvej obrazovke bannera vždy.

reopenButtonPosition

bottom-right (predvolené) alebo bottom-left.

onConsent

Funkcia, ktorá sa zavolá s rozhodnutím vždy, keď sa návštevník rozhodne.

categories

Vlastný zoznam kategórií cookies a cookies v nich, pre nastavenia bannera. Pokročilá voľba.

ga4

ID merania GA4. Bez neho sa použije to, ktoré je uložené v projekte.

gtm

ID kontajnera Google Tag Manager. Conseto kontajner načíta za teba.

metaPixelId

ID Meta Pixelu. Pixel sa načíta až po súhlase s marketingom.

proxyUrl

Základná adresa volaní skriptu, na ich posielanie cez tvoju doménu. Pozri Verejné endpointy.

urlPassthrough

Google Consent Mode URL passthrough. Predvolene false.

trackScrollDepth

Míľniky rolovania. Predvolene true.

trackFileDownloads

Sťahovanie súborov. Predvolene true.

trackOutboundLinks

Kliky na odkazy na iné weby. Predvolene true.

trackFormSubmissions

Odoslanie formulárov. Predvolene true.

autoTrackEcommerce

Zachytávať e-commerce udalosti zo Shopify, dátovej vrstvy a tvojho kódu. Predvolene false.

debug

Vypisuje do konzoly prehliadača, čo skript robí. Predvolene false.

Keď skript beží, tieto udalosti sa posielajú samy, pokiaľ to režim súhlasu návštevníka dovoľuje. Štyri vypínače vyššie vypnú tie, ktoré ho majú.

page_view

Každá stránka, ktorú návštevník uvidí, aj zmeny stránky cez históriu prehliadača a tlačidlo späť.

page_exit

Keď návštevník odíde zo stránky alebo skryje kartu: čas na stránke a ako ďaleko sa rolovalo.

click

Kliky na tlačidlá odoslania, odkazy na iné adresy, telefónne a e-mailové odkazy a všetko označené data-track, data-conseto-track, data-cta alebo triedou cta či btn. Udalosť berie meno z data-track alebo sa volá click.

scroll_milestone

25, 50, 75, 90 a 100 percent stránky.

file_download

Klik na odkaz na súbor, napríklad pdf, zip, doc, xls, csv, mp3 alebo mp4.

outbound_click

Klik na odkaz na iný web. E-mailové a telefónne odkazy sa tu nepočítajú.

form_submit

Odoslanie formulára: jeho id, meno, cesta, metóda a počet polí, nikdy nie to, čo sa napísalo.

Zavolaj track s menom a podľa chuti s objektom detailov. Meno si necháva písmená, číslice, podčiarkovník, pomlčku a bodku a skracuje sa na 100 znakov; všetko ostatné sa zmení na podčiarkovník.

Conseto.track('newsletter_signup', { location: 'footer' });

Namiesto kódu môžeš označiť aj prvok. data-track dá kliku meno, data-location, data-value a data-category pridajú detaily.

<a href="/pricing" data-track="pricing_click" data-location="header">
  Pricing
</a>

• Udalosť, ktorej meno začína conversion_, sa počíta ako cieľ. Pozri Ciele.
• Udalosti čakajú vo fronte, ktorá drží 500, a odosielajú sa v dávkach. Návštevníkovi, ktorý musí súhlasiť vopred, sa udalosti držia v pamäti do rozhodnutia.

Zapni autoTrackEcommerce a skript zachytí view_item, add_to_cart, remove_from_cart, begin_checkout a purchase z troch miest: z košíka Shopify, z dátovej vrstvy Googlu a z prvkov označených data-conseto-ecommerce.

<script>
  Conseto.init({ clientId: 'conseto_xxx_xxx', autoTrackEcommerce: true });
</script>

<button data-conseto-ecommerce="add_to_cart" data-product="Widget" data-price="29.99">
  Add to cart
</button>

Voliteľné, pre vývojárov s prihlásením. Tieto metódy sú na objekte, ktorý init vráti, takže skript musí byť typu module a počkať naň.

<script type="module">
  const conseto = await Conseto.init({ clientId: 'conseto_xxx_xxx' });

  conseto.setUserId('user_42');                    // opaque ID, never an e-mail
  await conseto.setUserEmail('jana@example.com');  // hashed in the browser
  conseto.setUserProperty('plan', 'business');

  conseto.clearUser(); // on logout
</script>

conseto.setUserId()

Pošle tvoje nepriehľadné ID tak, ako je. Nesmie to byť e-mailová adresa ani nič iné, čo pomenúva človeka.

conseto.setUserEmail()

Adresu orezá, zmení na malé písmená a v prehliadači z nej spraví odtlačok SHA-256. Samotná adresa z prehliadača neodíde. Vracia promise.

conseto.clearUser()

Zabudne ID aj odtlačok e-mailu. Zavolaj ju pri odhlásení.

conseto.setUserProperty()

Pripojí jednu pevnú vlastnosť: kľúč do 24 znakov, hodnotu do 36, najviac 25 kľúčov.

conseto.setUserProperties()

To isté, naraz pre celý objekt vlastností.

conseto.clearUserProperties()

Zabudne všetky vlastnosti.

Pred ďalšou inicializáciou alebo keď sa jednostránková appka odpojí, odstráň poslucháčov skriptu a jeho zásah do histórie prehliadača.

Conseto.instance?.destroy(); // removes its listeners, before a re-init or an unmount

Publikované serverové knižnice zatiaľ nie sú. Zo servera použi verejné endpointy.

• Node.js SDK
• Python SDK
• PHP SDK