Dokumentáció / Szerveroldali mérés

Szerveroldali mérés (sGTM, Meta CAPI)

A nagyobb webhelyek nem közvetlenül a böngészőből küldenek adatokat a Google-nek és a Metának, hanem saját szerveren keresztül (szerveroldali GTM, Meta Conversions API). A Cookienovo ezekhez a szerveroldali integrációkhoz is őrzi a hozzájárulást.

Szerveroldali GTM: azonnal működik

A sáv Google Consent Mode v2 jeleket küld (ad_storage, analytics_storage, ad_user_data, ad_personalization), amelyek az eseményekkel együtt a szerveroldali GTM-tárolódba is eljutnak. A Google szerveroldali címkéi így automatikusan tiszteletben tartják a látogató hozzájárulását — nincs szükség további konfigurációra.

Hozzájárulási állapot a szervered számára (Meta CAPI és más)

A Google-on kívüli integrációkhoz a szervered egyetlen hívással ellenőrizni tudja egy adott látogató hozzájárulási állapotát. A látogató azonosítója (browser_id) a böngészőben elérhető — a sáv „Consent ID”-ként jeleníti meg, te pedig a konverziós eseménnyel együtt elküldöd a backendedre.

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

Mielőtt eseményt küldenél a Meta CAPI-nak, ellenőrizd a marketing kategóriát. Hozzájárulás nélkül ne küldd el az eseményt — a szerveroldali mérésre ugyanazok a szabályok vonatkoznak, mint a böngészőbeli pixelre.

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

Jelek a böngészőben

A Google mellett a sáv automatikusan elküldi a hozzájárulást a Microsoft UET-nek (Bing Ads) és a Meta pixelnek is — fbq('consent', grant/revoke). A frontend és a szerveroldali mérés így ugyanazt az állapotot látja.

Megjegyzések

Rate limit: Percenként 600 hívás IP-nként — nagyobb forgalom esetén tárold az állapotot gyorsítótárban látogatónként.
Adatvédelem: a browser_id-t nem tároljuk olvasható formában — a lekérdezés egyirányú hashen keresztül fut.
Hozzájárulás módosítása: a látogató bármikor módosíthatja a választását; minden konverziónál ellenőrizd az állapotot, ne tárold gyorsítótárban néhány percnél tovább.