Dokumentácia / Server-side meranie

Server-side meranie (sGTM, Meta CAPI)

Väčšie weby neposielajú dáta do Googlu a Mety priamo z prehliadača, ale cez vlastný server (server-side GTM, Meta Conversions API). Cookienovo stráži súhlas aj pre tieto serverové integrácie.

Server-side GTM: funguje hneď

Lišta posiela Google Consent Mode v2 signály (ad_storage, analytics_storage, ad_user_data, ad_personalization), ktoré cestujú s udalosťami aj do vášho server-side GTM kontajnera. Serverové tagy Googlu tak rešpektujú súhlas návštevníka automaticky — žiadna ďalšia konfigurácia nie je potrebná.

Stav súhlasu pre váš server (Meta CAPI a iné)

Pre integrácie mimo Googlu si váš server vie stav súhlasu konkrétneho návštevníka overiť jedným volaním. Identifikátor návštevníka (browser_id) máte k dispozícii v prehliadači — lišta ho zobrazuje ako „Consent ID“ a vy si ho pošlete na svoj backend spolu s konverznou udalosťou.

GET https://cookienovo.com/api/consents/state?browser_id=BROWSER_ID
site-token: VÁŠ_SITE_TOKEN

→ 200 {
  "data": {
    "decision": "accept_all",            // accept_all | partial | reject_all
    "categories": {
      "marketing": true, "analytics": true,
      "functional": true, "statistical": false, "other": false
    },
    "config_version": "4cd038cbc4de4230", // verzia lišty pri rozhodnutí
    "decided_at": "2026-07-20T21:02:11Z"
  }
}
→ 200 { "data": null }                    // návštevník ešte nerozhodol = bez súhlasu

Meta Conversions API

Pred odoslaním eventu do Meta CAPI si overte kategóriu marketing. Bez súhlasu event neposielajte — serverové meranie podlieha rovnakým pravidlám ako pixel v prehliadači.

state = cookienovo_consent(browser_id)          # volanie vyššie
if state && state.categories.marketing:
    meta_capi.send(event)                        # súhlas udelený
else:
    pass                                         # bez súhlasu sa event neposiela

Signály v prehliadači

Okrem Googlu lišta automaticky posiela súhlas aj do Microsoft UET (Bing Ads) a Meta pixelu — fbq('consent', grant/revoke). Frontend a server-side meranie tak vidia rovnaký stav.

Poznámky

Rate limit: 600 volaní za minútu na IP — pri vyššej prevádzke stav cachujte per návštevník.
Súkromie: browser_id neukladáme v čitateľnej podobe — dopyt beží cez jednosmerný hash.
Zmena súhlasu: návštevník môže voľbu kedykoľvek zmeniť; stav si overujte pri každej konverzii, necachujte ho dlhšie než pár minút.