# Cookiebot

> A Cookiebot együttműködése a bővítménnyel: felismerés, ajánlott beállítások, ellenőrzés és hibaelhárítás.

A Cookiebot a technikai pontszám szerint a legjobb CMP. A bővítmény magától felismeri, az ingyenes és a Pro változatban is. Telepítsd a Cookiebot WordPress-bővítményt („Cookiebot by Usercentrics”), kapcsold be a bővítményben a [kifejezett hozzájárulási módot](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/hozzajarulas-attekintes/), és a Google Consent Mode-ot bízd a Pixel Managerre. Más beállítás nem kell.

Ha a Cookiebot saját Google Consent Mode kapcsolója mentéskor magától kikapcsol, az a Pixel Manager dolga (lásd lent).

## Hogyan ismeri fel a bővítmény a Cookiebotot?

A felismerés a látogató böngészőjében fut, két dologra épül:

1. A `CookieConsent` süti. A Cookiebot akkor írja, amikor a látogató dönt. A négy kategóriát (`necessary`, `preferences`, `statistics`, `marketing`) tartalmazza, ezek megegyeznek a bővítmény kategóriáival, így nincs szükség leképezésre. A bővítmény minden oldalbetöltésnél olvassa.
2. A `CookiebotOnAccept` esemény. A Cookiebot a `window` objektumon váltja ki elfogadáskor. A bővítmény figyeli, és ugyanazon az oldalon, újratöltés nélkül betölti a jóváhagyott pixeleket.

**Telepítési mód.** A WordPress-bővítményt ajánlott használni a Cookiebot-szkript kézi beillesztése helyett, mert ha a bővítmény aktív, a Pixel Manager a saját beágyazott konfigurációs szkriptjeit `data-cookieconsent="ignore"` és `data-uc-allowed="true"` jelöléssel látja el, hogy a Cookiebot automatikus szkriptblokkolója ne nyúljon hozzájuk. Kézzel beillesztett szkriptnél a bővítmény a szerveren nem tudja, hogy a Cookiebot jelen van, ezek a jelölések nem kerülnek rá, és a blokkoló blokkolhatja a konfigurációt. Ha mégis bővítmény nélkül futtatod, használd a Cookiebot kézi blokkolási módját.

**Admin kártya.** A **Consent Management Platforms** kártya listázza a Cookiebotot, ha a WordPress-bővítmény aktív. A kártya csak tájékoztat.

## Ajánlott beállítás

1. Telepítsd a Cookiebot WordPress-bővítményt, és hagyd, hogy ő jelenítse meg a bannert.
2. Kapcsold be az **Enable Explicit Consent Mode** kapcsolót a **WooCommerce → Pixel Manager → Consent** fülön. Nélküle a bővítmény implicit módban fut, a látogató válasza előtt elsüti a pixeleket, és a Google Ads figyelmeztethet („consent not managed properly”, „scripts loaded prior to consent”).
3. A Google Consent Mode v2-t a Pixel Managerben kapcsold be, ne a Cookiebotban. A bővítmény maga indítja a Consent Mode-ot, kifejezett módban az alapértékeket megtagadottra állítja, és a döntés után elküldi a frissítést. Ha a Google Consent Mode be van kapcsolva a bővítményben, az a Cookiebot saját Consent Mode opcióját is kikapcsolja, hogy ne versengjen két alapértelmezett blokk az oldalon.
4. Ne illeszd be a Cookiebot Google Consent Mode kódrészletét (a `gtag('consent', 'default', ...)` blokkot, illetve a `url_passthrough` és `ads_data_redaction` beállításait). A bővítmény ezeket már kiadja, külön hozzáadva ismétlődő vagy ellentmondó jelek keletkeznek. Más `url_passthrough` viselkedéshez használd a bővítmény [szűrőjét](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/hozzajarulas-google/).
5. A korlátozott régiók mezőnél értsd a következményt. Üresen a kifejezett mód minden látogatóra érvényes. Ha régiókat sorolsz fel, a rajtuk kívüli látogatókat implicit módban követi, nekik kell a Cookiebotban aktívan elutasítaniuk. Ez a leggyakoribb oka annak, hogy egy teszt „hozzájárulás nélkül is követ”.
6. Az **Always send server-side events** (**Server-Side → General**) maradjon kikapcsolva, hacsak szándékosan nem akarsz szerveroldali eseményeket küldeni a banner válaszától függetlenül.

## Az integráció ellenőrzése

1. Nyisd meg a boltot privát ablakban, WordPressből kijelentkezve (az adminisztrátorokat alapból nem követi).
2. Fűzd az URL végére a `?pmwloggeron` paramétert, és nyisd meg a böngésző konzolját.
3. A banner megválaszolása előtt `Consent mode: explicit` sort látsz, minden nem alapvető kategória tiltva. `Cookiebot CMP consent detected` sor még nincs, mert a Cookiebot csak a döntéskor írja a sütit.
4. Kattints az **Allow all** gombra. A bővítmény kiírja: `Updated consent state (source: cmp)`, és ugyanazon az oldalon betölti a jóváhagyott pixeleket. A következő oldalbetöltésnél ez látszik:

```text
Pixel Manager: Cookiebot CMP consent detected
Pixel Manager: CMP consent applied from: Cookiebot
```

5. A konzolban a `pmw.consent.categories.get()` kiírja az aktuális állapotot.

**Régióhoz kötött banner tesztelése.** Ha a Cookiebot csak bizonyos régiókban mutat bannert, és máshonnan tesztelsz, fűzd az URL-hez a Cookiebot saját teszt-paraméterét, például `?uc_cmp_country=IT`. Különben implicit módban tesztelsz.

## Hibaelhárítás

**A Cookiebot Google Consent Mode kapcsolója kikapcsol mentéskor.** Várt működés: ha a Pixel Managerben be van kapcsolva a Google Consent Mode, a bővítmény kikapcsolja a Cookiebot opcióját, hogy csak egy alapértelmezett hozzájárulási blokk legyen az oldalon. Hagyd kikapcsolva.

**A Google Ads „scripts loaded prior to consent” vagy „consent not managed properly” figyelmeztet.** Mindkettő akkor jelenik meg, ha a Google Consent Mode be van kapcsolva, de a kifejezett mód nincs. Ebben az esetben a bővítmény alap Consent Mode-ban fut: a címkék korlátozottan töltődnek be a hozzájárulás előtt. Ez megfelelő, de kiváltja a Google diagnosztikáját. Kapcsold be a kifejezett módot: ekkor a bővítmény minden Google alapértéket megtagadottra állít, mielőtt bármely címke lefutna, és a figyelmeztetések eltűnnek.

**Követés történik, pedig elutasítottam a Cookiebotban.** Ellenőrizd sorrendben:

1. Korlátozott régiók: ha be vannak állítva, és kívülről tesztelsz, számodra a követés implicit. Teszteld egy felsorolt régióból (VPN), vagy ürítsd a mezőt.
2. Korábbi tárolt döntés: teszteld friss privát ablakban. Ha a konzol `CMP consent applied from: PMW cookie/storage` sort ír a `Cookiebot` helyett, a bővítmény egy régebbi mentett döntése él. A bővítmény legfrissebb verziói már nem tárolják a CMP-től átvett döntést, és törlik a régi rekordokat. Régebbi verziónál egyszer futtasd a konzolban: `localStorage.removeItem('_pmw_persistent_data')`.
3. A süti törlése nem elutasítás: a `CookieConsent` süti törlése a fejlesztői eszközökben nem vált ki Cookiebot-eseményt, így a bővítmény a következő oldalbetöltésig a legutóbbi ismert állapotot tartja. Mindig a bannerrel utasíts el.

**A kosárba tétel vagy egy űrlap hibás, ha a hozzájárulás meg van tagadva.** Ez a `url_passthrough` hatása ([Google Consent Mode](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/hozzajarulas-google/)), a Cookiebothoz nincs köze. Csak ez a leggyakrabban jelen lévő CMP.

**A Hotjar vagy más eszköz betöltődik, de nem rögzít semmit.** Kapcsold be a kifejezett módot, hogy az eszköz csak hozzájárulás után töltődjön be, és győződj meg róla, hogy a Cookiebot saját Consent Mode-ja ki van kapcsolva. Amit a CMP a betöltés után blokkol, az üres munkamenetet ad.

## Mikor fordulj a támogatáshoz?

Küldd el az áruházad URL-jét, a **WooCommerce → Pixel Manager → Support** oldal hibakereső adatait, azt hogy a Cookiebot bővítményként vagy kézzel beillesztett szkriptként fut-e (automatikus vagy kézi blokkolással), a korlátozott régiók beállítását és az országot, ahonnan teszteltél, az aktív gyorsítótár-, szkriptoptimalizáló és címkekezelő bővítményeket, valamint a böngészőkonzol képernyőképét `?pmwloggeron` mellett, a banner elfogadása előtt és után.

## Gyakori kérdések

- **Kompatibilis a Cookiebot?** Igen, támogatott, a legjobb pontszámú CMP, és felismeréséhez nem kell beállítás.
- **A Google Consent Mode-ot a Cookiebotban vagy a Pixel Managerben kapcsoljam be?** A Pixel Managerben. A bővítmény a Cookiebot opcióját magától kikapcsolja.
- **Kell a Cookiebot WordPress-bővítménye, ha magam illesztem be a szkriptet?** Ajánlott, mert ez jelzi a szervernek, hogy a Cookiebot jelen van, ami a konfigurációs szkriptek védelméhez kell.
- **Miért látok követést elfogadás előtt?** Valószínűleg a korlátozott régiókon kívülről teszteltél, vagy a kifejezett mód ki van kapcsolva.
- **Pro funkció a Cookiebot támogatás?** Nem, minden CMP-integráció az ingyenes változatban is benne van.