# Integrációk

> Szolgáltatások, bővítmények és a szkriptközpont: a külső szkriptek blokkolása hozzájárulásig, plusz a Google Consent Mode.

A **Complianz → Integrations** oldalon három fül van: **Services**, **Plugins** és **Script Center**. Ezek mondják meg, mit blokkoljon a Complianz a hozzájárulás megadásáig.

A bekapcsolt szolgáltatások és bővítmények a webhelyed nyilvános felületén blokkolva lesznek, amíg a látogató hozzá nem járul (opt-in régióban), illetve a hozzájárulás visszavonása után (opt-out régióban). Ahol lehet, egy helyőrző jelenik meg a blokkolt tartalom helyén. A helyőrzőt kikapcsolhatod vagy a saját igényeid szerint állíthatod ([Eszközök](https://hub.hellowp.io/hu/plugins/complianz-gdpr-premium/eszkozok/), **Placeholders**).

## Services

A varázslóban megjelölt harmadik féltől származó szolgáltatások és közösségi média listája. Ha a varázslóban jelezted, hogy nem használsz ilyeneket, ezen a lapon egy figyelmeztetés látszik, és a **Szolgáltatások megtekintése** gombbal listázhatod őket.

## Plugins

A Complianz felismeri a webhelyen aktív, vele integrálható bővítményeket, és ezeket itt kapcsolhatod be. A legtöbb bővítmény alapértelmezés szerint működik. Ha egyetlen integrálható bővítmény sincs aktív, a lap **Nem található aktív bővítmény az integrációk listájában.** üzenetet mutat.

Ha másik Google Tag Manager vagy analitikai bővítményt használsz (például GTM4WP vagy MonsterInsights), és nem találod a Consent Mode beállításait a varázslóban, kapcsold ki az ilyen bővítménnyel való integrációt itt. Ezután a GTM és a Consent Mode a varázslóban állítható be (**Wizard → Consent → Statistics** és **Statistics configuration**).

## Script Center

A szkriptközpont harmadik féltől származó szkriptek és iframe-ek hozzáadására és blokkolására való a hozzájárulásig vagy a hozzájárulás visszavonásáig, például Hotjarhoz vagy beágyazott videókhoz. Három lista van:

- **Harmadik féltől származó szkript hozzáadása**: új szkript felvétele;
- **Szkript, iframe vagy bővítmény blokkolása**: blokkolt elem felvétele;
- **Szkript, iframe vagy bővítmény felvétele az engedélyezési listára**: kivétel a blokkolás alól.

Mindegyik lista **Új hozzáadása** gombbal bővíthető. Saját integrációt fejlesztők is készíthetnek, például MU-pluginként a szkriptközpont adataival.

## WP Consent API

A Complianz együttműködik a WP Consent API bővítménnyel, amely a hozzájárulási kategóriák egységes átadását végzi a bővítmények között. Ha telepítve van egy olyan bővítmény, amely támogatja a WP Consent API-t, elég a WP Consent API-t is telepíteni, a hozzájárulást a Complianz kezeli.

Működése: a Complianz először megállapítja, hogy a látogató opt-in vagy opt-out régióból érkezik, és ezt átadja az API-nak. Opt-in régióban a bővítmények „denied” (megtagadva), opt-out régióban „allow” (engedélyezve) állapotot kapnak. A látogató döntésekor a Complianz frissíti az állapotot, így a figyelő bővítmények értesülnek a változásról.

Az API főleg az első féltől származó süti- és követési műveleteket (például egy bővítmény PHP-ból állított sütijét) fedi le. A harmadik féltől származó szkripteket (például beágyazott Facebook-iframe) továbbra is a Complianz blokkoló funkciója kezeli.

Ha a WP Consent API aktív, az a **Preferences** kategóriát is megjeleníti a sávon.

### Mit csinál a WP Consent API?

A WP Consent API egy bővítmény, amely egységesíti az elfogadott hozzájárulási kategóriák átadását a bővítmények között. Szükség van hozzá egy sütisáv-bővítményre és legalább egy másik bővítményre, amely támogatja az API-t. Így minden támogató bővítmény ugyanazokkal a módszerekkel olvashatja és jegyezheti a hozzájárulási kategóriát, a hozzájárulás-kezelő és a többi bővítmény együtt tud működni, és javul a megfelelés az adatvédelmi törvényeknek. Az API a WordPress magjába szánt javaslatból indult ki (a Complianz és a Cookiebot javaslata, 2020 áprilisától).

### Milyen problémát old meg?

- Egy hozzájárulás-kezelő blokkolni tud harmadik féltől származó szolgáltatást (Facebook, Google Maps, Twitter), de ha egy WordPress-bővítmény PHP-sütit helyez el, azt nem tudja megakadályozni.
- Egyes bővítmények a követőkódot kliensoldalon, JavaScript-fájlokba építik, amelyek blokkolva elrontják az oldalt.
- Ha egy ilyen bővítmény JavaScriptjét kicsinyítik, az URL felismerhetetlenné válik, és az automatikus blokkoló nem észleli.
- A blokkolásos módszerhez az összes követő URL-típus listája kell. Egy általános API, amelyhez a bővítmények igazodnak, sokat segít a megfeleléshez.

### Megakadályozza-e a harmadik felek követését?

Elsősorban a megfelelő első féltől származó sütikre és a WordPress-bővítmények követésére szól. Ha egy ilyen bővítmény például Facebookot indít, az API segít. Ha beágyazol egy Facebook-iframe-et, blokkoló eszköz kell, amely eleve letiltja az iframe-et vagy a szkripteket. A harmadik féltől származó szkripteket a hozzájárulás-kezelő blokkolója kezeli.

### Hogyan működik?

Két jelző dönti el együtt, hogy egy kategóriához (például „marketing”) van-e hozzájárulás:

1. a régió szerinti hozzájárulási típus (`consent_type`): opt-in, opt-out vagy más típus;
2. a látogató döntése: nincs megadva, engedélyezve (`allow`) vagy megtagadva (`deny`).

A `consent_type` függvény a `wp_get_consent_type` szűrőt csomagolja. Ha nincs hozzájárulás-kezelő bővítmény, amely beállítaná, `false` értéket ad, és ekkor minden kategória `true`, vagyis minden kategóriában elhelyezhetők sütik. Opt-in típusnál egy kategória csak akkor `true`, ha a látogató döntése `allow`. Opt-out típusnál akkor `true`, ha a döntés nincs megadva vagy `allow`.

Kliensoldalon a hozzájárulás-kezelő dinamikusan módosíthatja a típust és beállíthat sütikategóriákat. Egy bővítmény horoggal (hook) figyelheti a változásokat vagy ellenőrizheti egy kategória értékét. A kategóriák és a legtöbb elem szűrővel bővíthető.

A WP Consent API-val integrált bővítmények például: Google Site Kit, WooCommerce, AFL UTM Tracker, Pixel Manager for WooCommerce, AddToAny.

## Google Consent Mode

A Consent Mode a Google-címkék viselkedését igazítja a látogató hozzájárulásához. A beállítást a **Wizard → Consent → Statistics** és **Statistics configuration** lépéseknél végzed.

### Google-címkék beállítása

1. Add meg, hogy Google Analyticset vagy Google Tag Managert használsz.
2. Kapcsold be a Consent Mode-ot, és add meg a GA4-címke azonosítóját. A Complianz állítja be az alapértelmezett hozzájárulási állapotot, és frissíti, ahogy a látogató dönt.
3. A Consent Mode bekapcsolásához legalább egy Google-címkét használnod kell a statisztikai kategóriában. A további címkék (vesszővel elválasztva) a **Statistics** és **Marketing** kategóriák között oszlanak meg.

| Kérdés vagy paraméter | Jelentése |
| --- | --- |
| **Do you want to block all Google Tags before consent?** | Alapérték: **No** (haladó mód): a címkék az oldal betöltésekor elindulnak, és a hozzájárulási állapot szerint süti nélkül mérnek, de kapcsolódnak a Google szervereihez. **Yes** esetén a Consent Mode csak a hozzájárulás után működik (alap, nem hibrid mód). |
| `url_passthrough` | Ha a hirdetési kattintásból érkező látogatónál az `ad_storage` megtagadott, a hirdetési információ URL-paraméterként marad meg, így a konverziómérés pontosabb marad. |
| `ads_data_redaction` | Ha igaz és az `ad_storage` megtagadott, a Google Ads és Floodlight címkék a hirdetési azonosítókat kitakarják, és a kéréseket sütimentes domainen küldik. |

### Google Tag Manager

Jelöld a **Wizard → Consent → Statistics** lépésnél a „Yes, with Google Tag Manager” választ, add meg a GTM konténerazonosítót, és állítsd be a Consent Mode kérdéseit. A Complianz GTM-sablonnal dolgozik, amelyet a konténerbe importálhatsz.

### Site Kit

Google Site Kit használatakor csak a haladó Consent Mode használható, vagyis a Google-címkék közvetlenül betöltődnek, és a követés a hozzájárulási állapot szerint működik. A **Wizard → Statistics** lépésnél jelezd, hogy Google Analyticset vagy Tag Managert használsz.

### A Consent Mode ellenőrzése

A működést a böngészőben ellenőrizd, mert az analitikai felület nem mutatja meg.

1. Nyisd meg a webhelyet inkognitó ablakban, és a sávon még ne adj hozzájárulást.
2. A böngésző konzoljában ellenőrizd a dataLayer hozzájárulási állapotait. Hozzájárulás előtt csak a `security_storage` és a `functionality_storage` lehet megadva (granted).
3. Kattints az **Accept** gombra, és ellenőrizd újra. Most minden állapotnak megadottnak kell lennie.
4. A hálózat fülön szűrj a `collect?v=` kifejezésre, és nézd meg a `gcs` paramétert:

| Érték | `ad_storage` | `analytics_storage` | Állapot |
| --- | --- | --- | --- |
| G100 | megtagadva | megtagadva | Alapállapot (funkcionális, preferenciák): süti nélküli mérés. |
| G110 | megadva | megtagadva | Marketing: hirdetési sütik, nincs statisztikai süti. |
| G101 | megtagadva | megadva | Statisztika: analitikai sütik, nincs hirdetési süti. |
| G111 | megadva | megadva | Statisztika és marketing. |

A `G111` tehát teljes hozzájárulást jelent.

#### A `gcd` paraméter értelmezése

Aktív Consent Mode esetén a Google Ads és a Google Analytics a kéréseikhez automatikusan egy `gcd` paramétert fűz. Ez a négy Consent Mode jelzés (`ad_storage`, `analytics_storage`, `ad_user_data`, `ad_personalization`) állapotát kódolja két időpontra: az alapértelmezett állapotra az oldal betöltésekor, és a frissített állapotra, miután a látogató döntött a sávon.

A szerkezet: `&gcd=XY[ad_storage]Y[analytics_storage]Y[ad_user_data]Y[ad_personalization]Z`. Az `X` nyitó azonosító (többnyire 1), az `Y` elválasztó (gyakran 1 vagy 3), a `Z` záró jel (gyakran 5). Ezek webhelyenként kissé eltérhetnek, a hozzájárulás olvasását nem érintik: a négy jelzéshez tartozó betű számít. Egy betű az alapértelmezett és a frissített állapotot egyszerre adja meg:

| Betű | Alapérték | Frissítés | Jelentése |
| --- | --- | --- | --- |
| l | nincs beállítva | nincs beállítva | A Consent Mode-ot nem észlelte. |
| p | megtagadva | nincs beállítva | Az alapérték elment, frissítés még nem érkezett. |
| q | megtagadva | megtagadva | Az alapérték elment, a látogató elutasította. |
| t | megadva | nincs beállítva | Az alapérték elment, frissítés még nem érkezett. |
| r | megtagadva | megadva | Az alapérték elment, a látogató elfogadta. |
| m | nincs beállítva | megtagadva | Alapérték nem ment, a látogató elutasította. |
| n | nincs beállítva | megadva | Alapérték nem ment, a látogató elfogadta. |
| u | megadva | megtagadva | Az alapérték elment, a látogató később elutasította. |
| v | megadva | megadva | Az alapérték elment, a látogató elfogadta. |

Például a `&gcd=13r3r3r3r5` azt jelenti, hogy mind a négy jelzés alapból megtagadott volt, majd a látogató hozzájárulása után megadott lett. A `&gcd=13l3l3l2l2` azt mutatja, hogy a Consent Mode egyáltalán nem volt aktív.

A paramétert a böngésző fejlesztői eszközeiben találod: **Network** fül, szűrés a `collect?v=` kifejezésre (Google Analytics) vagy a megfelelő Google Ads-kérésre, majd a kérés lekérdezési karakterlánca.

#### Hibakeresés a Tag Assistanttal

A Google Consent Mode hibakeresésére a Google Tag Assistant is használható (a Google hibakeresési útmutatója szerint a **Consent** fülön látszanak az állapotok). A Tag Assistant használatát lásd: [Consent Mode Google Site Kittel](https://hub.hellowp.io/hu/plugins/complianz-gdpr-premium/analitika-consent-mode-site-kit/).

#### Egyéb beállítási módok

- A Site Kit és a Google Analytics, illetve Tag Manager Consent Mode v2-kompatibilis beállításának lépéseit a [Consent Mode Google Site Kittel](https://hub.hellowp.io/hu/plugins/complianz-gdpr-premium/analitika-consent-mode-site-kit/) fejezet írja le.
- A Google Tag Gatewayjel működő webhelyek késői hozzájárulási jelzéséről a [Google Tag Gateway](https://hub.hellowp.io/hu/plugins/complianz-gdpr-premium/analitika-consent-mode-google-tag-gateway/) fejezetben olvashatsz.
- A Consent Mode működéséről és a Tag Manager beállításáról az [általános Consent Mode fejezet](https://hub.hellowp.io/hu/plugins/complianz-gdpr-premium/analitika-consent-mode-google-consent-mode/) szól.
- Ha ismersz másik, külön beállítás nélkül működő megvalósítást vagy bővítményt, jelezd a Complianz támogatásának, hogy bekerülhessen.