# Cookie Script

> A Cookie Script együttműködése a bővítménnyel: felismerés, kategóriák leképezése, ajánlott beállítások és hibaelhárítás.

A Cookie Script a technikai pontszám szerint a második legjobb CMP. A bővítmény magától felismeri, az ingyenes és a Pro változatban is, akár a Cookie Script WordPress-bővítményt, akár a cookie-script.com fiókból származó szkriptet használod. Kapcsold be a [kifejezett hozzájárulási módot](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/hozzajarulas-attekintes/), és tartsd a bővítményt frissen.

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

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

1. A `CookieScriptConsent` süti. A Cookie Script már az első oldalmegtekintésnél megírja, a látogató döntése előtt, a Google Consent Mode leképezésének tárolásához. Ilyenkor a süti még nem tartalmaz döntést. A bővítmény csak akkor olvassa döntésként, ha elfogadási vagy elutasítási műveletet, illetve kategórialistát hordoz (ugyanezt a szabályt használja a Cookie Script is). Addig a konzolra ezt írja: `Cookie Script cookie detected, but the visitor hasn't made a choice yet. Ignoring it.`, és minden kategóriát tiltva tart.
2. Három esemény a `document` objektumon: `CookieScriptAccept`, `CookieScriptAcceptAll` és `CookieScriptReject`. A bővítmény mindháromra figyel, és a döntést ugyanazon az oldalon, újratöltés nélkül alkalmazza.

A kategóriák leképezése:

| Cookie Script kategória | A bővítmény kategóriája |
|---|---|
| strictly necessary | necessary (mindig engedélyezett) |
| `functionality` | preferences |
| `performance` | statistics |
| `targeting` | marketing |

Az a kategória, amelyet a látogató nem hagyott jóvá, tiltott. A bővítmény sosem engedélyez alapból Cookie Script kategóriát.

**Telepítési mód.** A süti és az események a Cookie Script saját kódjától származnak, így a bolti integráció működik, akár a WordPress-bővítmény, akár a cookie-script.com fiókból másolt kódrészlet szállítja.

**Admin kártya.** A **Consent Management Platforms** kártya a Cookie Scriptet csak akkor listázza, ha a WordPress-bővítmény aktív. Az oldalról betöltött szkriptnél „None detected on this site” szerepel, miközben az integráció működik. A kártya csak tájékoztat.

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

1. Frissítsd a bővítményt a legfrissebb verzióra: a régebbi verziók a Cookie Script döntés előtti sütijét teljes hozzájárulásként olvasták.
2. Kapcsold be az **Enable Explicit Consent Mode** kapcsolót a **WooCommerce → Pixel Manager → Consent** fülön, hogy a bővítmény a Cookie Scriptben hozott döntést kövesse, ne a látogató válasza előtt süsse el a pixeleket.
3. A Google Consent Mode-ot egy helyen futtasd. Ajánlott a Google Consent Mode v2-t a Pixel Managerben bekapcsolni, a Cookie Script saját Google Consent Mode beállítását pedig kikapcsolva hagyni. A bővítmény az alapértékeket megtagadottra állítja, a döntés után elküldi a frissítést, és beállítja a `url_passthrough` és az `ads_data_redaction` értékét. Két eszköz, amely alapértelmezett hozzájárulási blokkot ad ki ugyanazon az oldalon, egymással versengene.
4. A korlátozott régiók mezőt hagyd üresen, hacsak szándékosan nem akarsz implicit követést bizonyos régiókon kívül.
5. Az **Always send server-side events** (**Server-Side → General**) maradjon kikapcsolva, hacsak nem döntöttél úgy, hogy a banner válaszától függetlenül küldesz szerveroldali eseményeket. Ez megfelelőségi döntés, nem követési javítás.

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

1. Nyisd meg a boltot privát ablakban, WordPressből kijelentkezve.
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 ezt látod:

```text
Pixel Manager: Cookie Script cookie detected, but the visitor hasn't made a choice yet. Ignoring it.
Pixel Manager: Consent mode: explicit. Initial defaults: ...
```

Bekapcsolt Google Consent Mode mellett a Google kérései `gcs=G100` értéket hordoznak.

4. Kattints az **Accept all** gombra. A bővítmény kiírja: `Updated consent state (source: cmp)`, betölti a jóváhagyott pixeleket ugyanazon az oldalon, a Google kérései pedig `gcs=G111` értékre váltanak. A következő oldalbetöltésnél:

```text
Pixel Manager: Cookie Script CMP consent detected
Pixel Manager: CMP consent applied from: Cookie Script
```

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

## Hibaelhárítás

**A Google a banner megválaszolása előtt `gcs=G111` jelet kap.** A bővítmény régebbi verzióiban a Cookie Script döntés előtti sütijét teljes hozzájárulásként olvasták: kifejezett módban ez „döntött” állapotot állított be, betöltött minden pixelt, és a Google Consent Mode frissítést megtagadottról megadottra váltotta minden interakció nélkül. A tünet friss munkamenetben, érintetlen banner mellett `gcs=G111` a Google kéréseiben, vagy minden megadottra állított `consent update` az adatrétegben közvetlenül az oldalbetöltés után. Frissítsd a bővítményt: a javítás a Cookie Script saját szabályát alkalmazza, a süti csak elfogadási vagy elutasítási művelettel, illetve kategórialistával számít.

**A GA4 nem mutat vásárlást, bár a Google Ads rögzít konverziót.** Ha a vásárló a Cookie Scriptben elutasítja a statisztikai kategóriát, a bővítmény elnyomja a rendelés szerveroldali GA4 vásárlását. Ha be van állítva GA4 Measurement Protocol titok, az a szerveroldali esemény a bolt egyetlen GA4 vásárlási csatornája, így a vásárló GA4 munkamenetet és Google Ads konverziót ad, de GA4 tranzakciót nem. Ez szándékos. A hatás méréséhez egy napig hagyd a naplózót Info szinten (**Pixel Manager → Support → Logger**), és számold meg a `Consent denied (statistics)` sorokat a rendelésszámhoz képest. A **Server-Side → General** oldal **Always send server-side events** beállítása ezt felülbírálja, de ez megfelelőségi döntés.

**Aki egyszer elutasított, hosszabb ideig elutasított marad, mint a banner szándéka.** A Cookie Script a döntés után maga is küld egy `gtag('consent', 'update')` hívást. A bővítmény jelenleg ezt a Google Consent Mode frissítést helyi döntésként rögzíti, ami az elutasítást a Cookie Script saját sütijének lejárta vagy törlése után is életben tarthatja. Az **Accept all** gomb a banneren azonnal törli. A változtatás folyamatban van, hogy a CMP tulajdonában lévő döntéseket a bővítmény ne tárolja.

**Elfogadás után nem töltődnek be a pixelek.** Először a szkriptoptimalizálást nézd. A JavaScriptet késleltető vagy halasztó bővítmények a Pixel Managert a Cookie Script eseményei előtt tölthetik be, és a gyorsítótár-bővítmények „Remove Query Strings” opciói frissítés után régi csomagot szolgálhatnak ki. Ilyenkor a konzol `Consent module failed to load - falling back to deny-by-default` sort ír, ami szándékos. Kapcsold ki az opciót, ürítsd a gyorsítótárat, és zárd ki a Pixel Managert a JavaScript-késleltetésből ([Kompatibilitás és gyorsítótár](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/kompatibilitas/)).

## Mikor fordulj a támogatáshoz?

Küldd el az áruházad URL-jét, a **Pixel Manager → Support** oldal hibakereső adatait, azt hogy a Cookie Script bővítményként vagy szkriptként fut-e és be van-e kapcsolva a Google Consent Mode-ja, az aktív gyorsítótár-, szkriptoptimalizáló és címkekezelő bővítményeket, és 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 Cookie Script?** Igen, támogatott, a felismeréshez nem kell beállítás.
- **A cookie-script.com szkriptjét használom, nem a bővítményt. Felismeri?** Igen, ugyanazt a sütit írja és ugyanazokat az eseményeket váltja ki. Csak a tájékoztató admin kártya nem látja.
- **A Google Consent Mode-ot a Cookie Scriptben vagy a Pixel Managerben kapcsoljam be?** A Pixel Managerben, csak egy helyen.
- **Miért írja a konzol, hogy a látogató még nem döntött, pedig van Cookie Script süti?** Mert a Cookie Script a sütit a döntés előtt megírja. A bővítmény elfogadási vagy elutasítási műveletre, illetve kategórialistára vár.
- **Pro funkció a Cookie Script támogatás?** Nem, minden CMP-integráció az ingyenes változatban is benne van.