Dokumentation / Serverseitige Messung

Serverseitige Messung (sGTM, Meta CAPI)

Größere Websites senden Daten nicht direkt aus dem Browser an Google und Meta, sondern über ihren eigenen Server (serverseitiges GTM, Meta Conversions API). Cookienovo überwacht die Einwilligung auch für diese serverseitigen Integrationen.

Serverseitiges GTM: funktioniert sofort

Der Banner sendet Google-Consent-Mode-v2-Signale (ad_storage, analytics_storage, ad_user_data, ad_personalization), die mit den Ereignissen auch an Ihren serverseitigen GTM-Container übermittelt werden. Die serverseitigen Google-Tags respektieren so automatisch die Einwilligung des Besuchers — keine weitere Konfiguration nötig.

Einwilligungsstatus für Ihren Server (Meta CAPI und andere)

Für Integrationen außerhalb von Google kann Ihr Server den Einwilligungsstatus eines bestimmten Besuchers mit einem einzigen Aufruf abfragen. Die Besucherkennung (browser_id) steht Ihnen im Browser zur Verfügung — der Banner zeigt sie als „Consent ID“ an, und Sie senden sie zusammen mit dem Conversion-Ereignis an Ihr Backend.

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

Bevor Sie ein Ereignis an die Meta CAPI senden, prüfen Sie die Kategorie Marketing. Ohne Einwilligung senden Sie das Ereignis nicht — die serverseitige Messung unterliegt denselben Regeln wie der Pixel im Browser.

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

Signale im Browser

Neben Google sendet der Banner die Einwilligung automatisch auch an Microsoft UET (Bing Ads) und den Meta-Pixel — fbq('consent', grant/revoke). Frontend- und serverseitige Messung sehen so denselben Status.

Notizen

Rate limit: 600 Aufrufe pro Minute und IP — bei höherem Traffic cachen Sie den Status pro Besucher.
Datenschutz: browser_id speichern wir nicht in lesbarer Form — die Abfrage läuft über einen Einweg-Hash.
Änderung der Einwilligung: der Besucher kann seine Auswahl jederzeit ändern; prüfen Sie den Status bei jeder Conversion und cachen Sie ihn nicht länger als ein paar Minuten.