# Complianz

> A Complianz együttműködése a bővítménnyel: felismerés, melyik beállítás melyik oldalra tartozik, ellenőrzés és hibaelhárítás.

A Complianz az ügyfelek körében a legelterjedtebb CMP, és a technikai pontszám szerinti élmezőnybe tartozik. A bővítmény magától felismeri, az ingyenes és a Pro változatban is, kategóriaalapú hozzájárulással (ez a Complianz alapértelmezése). A szállítóalapú hozzájárulás nem támogatott.

Röviden: a Google Consent Mode-ot csak a Pixel Managerben futtasd, ne engedd, hogy a Complianz maga adjon hozzá vagy blokkoljon Google-címkéket, 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 Complianzt?

A felismerés a látogató böngészőjében fut, a Complianz sütijeire és eseményeire épül:

1. Kategóriánként egy süti: `cmplz_statistics`, `cmplz_marketing`, `cmplz_preferences` és `cmplz_functional` (a régióalapú beállításokhoz a Complianz `cmplz_rt_` változatai is). A Complianz akkor írja őket, amikor a látogató dönt. Opt-in hozzájárulási típusnál csak a kifejezett `allow` számít hozzájárulásnak, opt-out típusnál a nem beállított kategória is, pontosan úgy, ahogy a Complianz maga kezeli.
2. A `cmplz_fire_categories` esemény a `document` objektumon. A bővítmény figyeli, és a választást ugyanazon az oldalon, újratöltés nélkül alkalmazza.
3. A WP Consent API. A Complianz minden kategóriát a WP Consent API-n át is továbbít, ha az a bővítmény telepítve van. A Pixel Manager erre is feliratkozik, és ezeket is olvassa.

A Complianz kategóriái egy az egyben képeződnek le: functional → necessary, preferences, statistics, marketing. A Complianz statistics-anonymous kategóriáját a bővítmény nem képezi le, figyelmen kívül hagyja.

**A banner állapota nem döntés.** A Complianz akkor is ír banner-állapot sütit, ha csak újra meg akarja mutatni a bannert (például a sütiszabályzat felülvizsgálata után, vagy a „hozzájárulás kezelése” kattintására), és ilyenkor a kategóriasütiket törli. A kategóriasütik nélküli banner-állapotot a bővítmény figyelmen kívül hagyja, a naplóban ezzel: `Complianz cookie detected, but the visitor hasn't answered the banner yet. Ignoring it.`

**Telepítési mód.** A Complianz WordPress-bővítmény, ingyenes vagy prémium. A Pixel Manager mindkét kiadást felismeri a szerveren, és a `pmwDataLayer` konfigurációs szkriptjét felveszi a Complianz szkript-engedélyezőlistájára, hogy a Complianz blokkolója békén hagyja.

**Admin kártya.** A kártya listázza a Complianzt, ha a bővítmény aktív. 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: tartalmaz egy Complianz-specifikus hozzájárulási javítást.
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, és a Google Consent Mode `granted` értéket olvas, mielőtt a látogató elfogadna.
3. Kapcsold be a Google Consent Mode v2-t a Pixel Managerben, standard beállításokkal. A Google Consent Mode csak a Pixel Managerbe tartozik. Ha a Complianz is kiad egy saját Consent Mode szkriptet, két alapértelmezett hozzájárulási blokk versenget az oldalon, ezért a Complianz oldalán kapcsold ki a Consent Mode-ot.
4. Ne engedd, hogy a Complianz állítsa be a Google-t. A Complianz „Do you want Complianz to add Google Analytics to your website?” kérdésére válaszolj „No”-val. A Google Analytics és a Google Ads címkéket a Pixel Manager kezeli, különben a Google Analytics kétszer kerül fel.
5. Maradj a Complianz kategóriaalapú hozzájárulásánál (alapértelmezett). A szállítóalapú (szolgáltatásonkénti) hozzájárulás nem támogatott.
6. A Complianz Safe Mode legyen kikapcsolva. A Safe Mode hibakeresési kapcsoló, amely a Complianz összes integrációját, a banner blokkolását is kikapcsolja. Nem tartós beállítás.
7. Soha ne vedd fel a Pixel Managert vagy a `googletagmanager.com` címet a Complianz Script Center blokkolási listájára. A követőszkriptek blokkolását és feloldását a bővítmény maga végzi, a Complianz által továbbított hozzájárulás alapján.
8. 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.
9. 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 (lásd lent a csak szerveroldali Meta-eseményeket).

## 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 `Consent mode: explicit` sort látsz, minden nem alapvető kategória tiltva. Bekapcsolt Google Consent Mode mellett az adatrétegben egy `consent default` bejegyzés is van, minden jellel `denied` értéken.
4. Kattints az elfogadásra a Complianz bannerén. A bővítmény kiírja: `Updated consent state (source: cmp)`, betölti a jóváhagyott pixeleket ugyanazon az oldalon, az adatréteg pedig `consent update` bejegyzést kap a megadott jelekkel. A következő oldalbetöltésnél:

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

5. A `pmw.consent.categories.get()` kiírja az aktuális állapotot. Az adatrétegben a hozzájárulási parancsokat ezzel listázhatod: `window.dataLayer.filter(e => e && e[0] === 'consent')`.

## Hibaelhárítás

**A Google Tag Assistant „Consent not configured” vagy „CMP may be blocking tags” üzenetet ad.** A Complianz blokkolója a visszatartott szkripteket `type="text/plain"` típusra írja át a hozzájárulásig. Ha a `gtag.js` vagy a bővítmény konfigurációs szkriptje ezt a jelölést viseli, a Complianz olyan címkét blokkol, amelyet a Pixel Managernek kell vezérelnie, és a Tag Assistant nem lát alapértelmezett hozzájárulási jeleket. Keresd az oldal forrásában a `type="text/plain"` szöveget. Ha egy Pixel Manager- vagy `googletagmanager.com`-szkript meg van jelölve, vedd ki a Complianz Script Center blokkolási listájából, kapcsold ki a Complianz saját Google Analytics- és Consent Mode-beállítását, és a Safe Mode legyen kikapcsolva. Aztán töltsd be az oldalt `?pmwloggeron` mellett: a bővítmény kiírja a hozzájárulási döntést és a `Loading Google gtag.js from ...` sort.

**A hozzájárulás megadottnak látszik, mielőtt elfogadnám a bannert.** A kifejezett mód ki van kapcsolva. Implicit módban a bővítmény alapból engedélyez, és csak a kilépésre reagál. Kapcsold be a kifejezett módot: a banner elfogadása előtt a Google Consent Mode `denied`, elfogadás után `granted` lesz.

**A pixelek betöltődnek, bár a látogató elutasított.** A bővítmény régebbi verzióiban ezt két dolog okozhatta Complianzos boltnál:

- A bővítmény minden hozzájárulási állapotot lejárat nélkül a böngészőben tárolt `_pmw_persistent_data` kulcs alatt mentett, és a következő oldalbetöltésnél ezt olvasta a Complianz megkérdezése előtt. Egy megadott állapot rögzítése után a későbbi látogatások akkor is ebből indultak, ha nem volt Complianz kategóriasüti.
- A Complianz-olvasó a hiányzó kategóriasütit hozzájárulásnak vette, így a döntés nélküli banner-állapot süti minden pixelt feloldott.

Frissítsd a bővítményt: a CMP-től átvett hozzájárulást már nem tárolja, a régi rekordokat magától törli, és opt-in esetén csak a kifejezett `allow` számít. A frissítés utáni legelső oldalbetöltés még egyszer elsülhet. Teszt böngésző kézi takarításához futtasd a konzolban: `localStorage.removeItem('_pmw_persistent_data')`. A régi viselkedés jelzése a `CMP consent applied from: PMW cookie/storage` sor.

**A Meta jóval több szerveroldali eseményt jelent, mint böngészőt.** Opt-in bannernél és bekapcsolt „Always send server-side events” mellett a böngészőpixel sosem tölt be az elutasító látogatóknak, a szerveroldali esemény mégis elmegy. A böngészői és a szerveroldali események aránya ekkor lényegében az elfogadási arány, nem elveszett követés. Ha az „Always send server-side events” kikapcsolod, a szerveroldali szám a hozzájáruló látogatókra csökken. Ez adat- és megfelelőségi kompromisszum, nem javítás.

**A konzol „Consent module failed to load - falling back to deny-by-default” sort ír.** Frissítés után régi bővítménycsomagot szolgál ki valami, leggyakrabban egy gyorsítótár-bővítmény bekapcsolt „Remove Query Strings” opcióval és hosszú élettartamú élgyorsítótárral. A tartalék működés szándékos: megbízható hozzájárulási modul nélkül a bővítmény semmit nem süt el. Kapcsold ki az opciót, ürítsd az összes 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/)).

**A Complianz sütiszkennere Pixel Manager-bejegyzéseket listáz.** A Complianz sütiadatbázisa felveheti a bővítmény tárolókulcsait, és megkérhet a besorolásukra. Ezek ártalmatlanok, kettő közülük böngészőtár, nem süti, és semmilyen kategóriabeállítást nem kell módosítani.

## Mikor fordulj a támogatáshoz?

Küldd el az áruházad URL-jét, a **WooCommerce → Pixel Manager → Support** oldal hibakereső adatait, a Complianz kiadását és verzióját, és hogy be van-e kapcsolva a Safe Mode, a Complianz Google Analytics-integrációja vagy a 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, privát ablakban, a banner elfogadása előtt és után.

## Gyakori kérdések

- **Kompatibilis a Complianz?** Igen, kategóriaalapú hozzájárulással (alapértelmezett). A szállítóalapú nem támogatott.
- **A Google Consent Mode-ot a Pixel Managerben vagy a Complianzban kapcsoljam be?** A Pixel Managerben. A Complianz oldalán kapcsold ki.
- **„Yes”-t válaszoljak a „Do you want Complianz to add Google Analytics to your website?” kérdésre?** Nem, a Google Analyticset a bővítmény adja hozzá és kezeli.
- **Ki kell kapcsolni a Complianz szkriptblokkolását a Pixel Manager szkriptjeire?** Nem, a bővítmény magától felveszi a saját konfigurációs szkriptjét a Complianz engedélyezőlistájára. Csak magad ne vedd fel a Pixel Managert vagy a `googletagmanager.com` címet a blokkolási listára.
- **A kifejezett mód a szállítói szkriptek betöltését akadályozza meg, vagy csak az eseményeket?** A szkriptek betöltését. A Google és a Microsoft címkék kivételek: Consent Mode alatt betöltődnek, és süti nélküli jelzéseket küldenek a hozzájárulásig, a Consent Mode működése szerint.
- **Pro funkció a Complianz támogatás?** Nem, minden CMP-integráció az ingyenes változatban is benne van.