Jeden skript, pár metod

Tohle jsou všechny metody globálního objektu. Která verze skriptu běží na tvém webu, zjistíš, když do konzole prohlížeče napíšeš Conseto.version.

Conseto.init()

Spustí skript a vrátí promise. Zavolej ji jednou. Promise selže, pokud chybí clientId.

Conseto.track()

Pošle vlastní událost: název a volitelný objekt s detaily.

Conseto.updateConsent()

Zaznamená rozhodnutí o souhlasu pro kategorie, které pošleš (chybějící se počítají jako odmítnuté), uloží ho v prohlížeči a dá to vědět Google Consent Mode.

Conseto.getConsent()

Vrátí uložené rozhodnutí, nebo null, pokud žádné není.

Conseto.clearConsent()

Smaže uložené rozhodnutí. Banner se zeptá znovu při dalším načtení stránky.

Conseto.showBanner()

Ukáže banner hned. Pokud už je nějaký otevřený, nedělá nic.

Conseto.hideBanner()

Zavře banner.

Conseto.openCookieSettings()

Otevře nastavení banneru, pro odkaz Nastavení cookies.

Conseto.version

Verze skriptu, který běží.

Conseto.instance

Analytické jádro po funkci init, před ní null. Je na něm destroy().

Conseto.version; // which build runs on this site, for example "2.2.1"

Povinné je jen clientId. Co vynecháš, vezme se z nastavení projektu v aplikaci, a co chybí i tam, má výchozí 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 tvého projektu. Povinné.

language

Jazyk banneru jako dvoupísmenný kód. Bez něj: nastavení projektu, potom prohlížeč návštěvníka.

theme

light, dark nebo auto.

layout

Ignoruje se. Lišta je vždy okno uprostřed stránky: tento směr jsme zvolili po testu od 16. do 29. 8. 2026.

accentColor

Barva tlačítka Přijmout jako hex hodnota.

autoConsent

Dej false a init banner neukáže. Potom zavoláš showBanner() sám. Dokud se návštěvník, který musí souhlasit předem, nerozhodne, neodejde žádná událost.

cookiePolicyUrl

Kam vede odkaz na zásady cookies v banneru. Výchozí je /cookie-policy.

privacyPolicyUrl

Kam vede odkaz na zásady ochrany údajů. Výchozí je /privacy.

showRejectOnFirstView

Ignoruje se. Tlačítko „Jen nezbytné“ je na první obrazovce banneru vždy.

reopenButtonPosition

bottom-right (výchozí) nebo bottom-left.

onConsent

Funkce, která se zavolá s rozhodnutím vždy, když se návštěvník rozhodne.

categories

Vlastní seznam kategorií cookies a cookies v nich, pro nastavení banneru. Pokročilá možnost.

ga4

ID měření GA4. Bez něj se použije to, které je uložené v projektu.

gtm

ID kontejneru Google Tag Manager. Conseto kontejner načte za tebe.

metaPixelId

ID Meta Pixelu. Pixel se načte až po souhlasu s marketingem.

proxyUrl

Základní adresa volání skriptu, pro jejich posílání přes tvou doménu. Viz Veřejné endpointy.

urlPassthrough

Google Consent Mode URL passthrough. Výchozí je false.

trackScrollDepth

Milníky rolování. Výchozí je true.

trackFileDownloads

Stahování souborů. Výchozí je true.

trackOutboundLinks

Kliky na odkazy na jiné weby. Výchozí je true.

trackFormSubmissions

Odeslání formulářů. Výchozí je true.

autoTrackEcommerce

Zachytávat e-commerce události ze Shopify, datové vrstvy a tvého kódu. Výchozí je false.

debug

Vypisuje do konzole prohlížeče, co skript dělá. Výchozí je false.

Když skript běží, tyto události se posílají samy, pokud to režim souhlasu návštěvníka dovoluje. Čtyři vypínače výše vypnou ty, které ho mají.

page_view

Každá stránka, kterou návštěvník uvidí, i změny stránky přes historii prohlížeče a tlačítko zpět.

page_exit

Když návštěvník odejde ze stránky nebo skryje kartu: čas na stránce a jak daleko se rolovalo.

click

Kliky na tlačítka odeslání, odkazy na jiné adresy, telefonní a e-mailové odkazy a vše označené data-track, data-conseto-track, data-cta nebo třídou cta či btn. Událost bere název z data-track, nebo se jmenuje click.

scroll_milestone

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

file_download

Klik na odkaz na soubor, například pdf, zip, doc, xls, csv, mp3 nebo mp4.

outbound_click

Klik na odkaz na jiný web. E-mailové a telefonní odkazy se tu nepočítají.

form_submit

Odeslání formuláře: jeho id, název, cesta, metoda a počet polí, nikdy ne to, co se napsalo.

Zavolej track s názvem a podle libosti i s objektem detailů. Název si ponechává písmena, číslice, podtržítko, pomlčku a tečku a zkracuje se na 100 znaků; vše ostatní se změní na podtržítko.

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

Místo kódu můžeš označit i prvek. data-track dá kliku název, data-location, data-value a data-category přidají detaily.

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

• Událost, jejíž název začíná conversion_, se počítá jako cíl. Viz Cíle.
• Události čekají ve frontě, která drží 500, a odesílají se v dávkách. Návštěvníkovi, který musí souhlasit předem, se události drží v paměti do rozhodnutí.

Zapni autoTrackEcommerce a skript zachytí view_item, add_to_cart, remove_from_cart, begin_checkout a purchase ze tří míst: z košíku Shopify, z datové vrstvy Googlu a z prvků 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>

Volitelné, pro vývojáře s přihlášením. Tyto metody jsou na objektu, který init vrátí, takže skript musí být typu module a počkat na něj.

<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 tvé neprůhledné ID tak, jak je. Nesmí to být e-mailová adresa ani nic jiného, co pojmenovává člověka.

conseto.setUserEmail()

Adresu ořízne, změní na malá písmena a v prohlížeči z ní udělá otisk SHA-256. Samotná adresa z prohlížeče neodejde. Vrací promise.

conseto.clearUser()

Zapomene ID i otisk e-mailu. Zavolej ji při odhlášení.

conseto.setUserProperty()

Připojí jednu pevnou vlastnost: klíč do 24 znaků, hodnotu do 36, nejvýše 25 klíčů.

conseto.setUserProperties()

To samé, najednou pro celý objekt vlastností.

conseto.clearUserProperties()

Zapomene všechny vlastnosti.

Před další inicializací, nebo když se jednostránková aplikace odpojí, odstraň posluchače skriptu a jeho zásah do historie prohlížeče.

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

Publikované serverové knihovny zatím nejsou. Ze serveru použij veřejné endpointy.

• Node.js SDK
• Python SDK
• PHP SDK