Dokumentace / Server-side měření

Server-side měření (sGTM, Meta CAPI)

Větší weby neposílají data do Google a Mety přímo z prohlížeče, ale přes vlastní server (server-side GTM, Meta Conversions API). Cookienovo hlídá souhlas i pro tyto serverové integrace.

Server-side GTM: funguje hned

Lišta odesílá signály Google Consent Mode v2 (ad_storage, analytics_storage, ad_user_data, ad_personalization), které putují s událostmi i do vašeho server-side GTM kontejneru. Serverové tagy Google tak respektují souhlas návštěvníka automaticky — žádná další konfigurace není potřeba.

Stav souhlasu pro váš server (Meta CAPI a další)

Pro integrace mimo Google si váš server může stav souhlasu konkrétního návštěvníka ověřit jedním voláním. Identifikátor návštěvníka (browser_id) máte k dispozici v prohlížeči — lišta ho zobrazuje jako „Consent ID“ a vy si ho pošlete na svůj backend spolu s konverzní událostí.

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

Před odesláním eventu do Meta CAPI si ověřte kategorii marketing. Bez souhlasu event neodesílejte — serverové měření podléhá stejným pravidlům jako pixel v prohlížeč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 prohlížeči

Kromě Google lišta automaticky odesílá souhlas i do Microsoft UET (Bing Ads) a Meta pixelu — fbq('consent', grant/revoke). Frontend a server-side měření tak vidí stejný stav.

Poznámky

Rate limit: 600 volání za minutu na IP — při vyšším provozu stav cachujte pro každého návštěvníka.
Soukromí: browser_id neukládáme v čitelné podobě — dotaz běží přes jednosměrný hash.
Změna souhlasu: návštěvník může volbu kdykoli změnit; stav si ověřujte při každé konverzi, necachujte ho déle než pár minut.