# Microsoft Clarity Consent Mode v2

> A Clarity hozzájárulás-kezelése a Complianzzel: beállítás a varázslóban, kézi beillesztés, a hozzájárulási kombinációk hatása és hibakeresés.

2025. október 31-től a Clarity az EGT, az Egyesült Királyság és Svájc látogatóinál csak akkor működik teljes funkcionalitással, ha minden látogatóhoz érvényes hozzájárulási jelzést kap. A ConsentV2 a régi API helyét veszi át, és részletesebben szabályoz: az `ad_storage` és az `analytics_storage` értékénél is megadhatod, hogy a hozzájárulás megadva (granted) vagy megtagadva (denied). Amíg nem küldesz ConsentV2-hívást, a Clarity „no-consent” módban fut: korlátozott követéssel, első és harmadik féltől származó sütik nélkül.

A Complianz a varázslóban, a Clarity bekötésekor be tudja állítani ezt a hozzájárulás-kezelést, így a Clarity követése igazodik a látogató döntéséhez és a régió szabályaihoz.

## Mielőtt elkezded

Ha a Clarity WordPress-bővítményt használod, az magától beállítódik. Ha kézzel illeszted be a Clarityt, lásd lejjebb a kézi beillesztést.

Hogy a Clarity hozzájárulás előtt ne állítson be első és harmadik féltől származó sütiket:

1. Válaszd ki a Clarity-projektet.
2. Nyisd meg a **Settings → Setup** oldalt, és kapcsold ki a sütik alapértelmezett beállítását.

## Beállítás a varázslóban

1. Telepítsd és aktiváld a Complianzet, majd indítsd el a varázslót.
2. Az előző szakasz lépései után nyisd meg a **Wizard → Consent → Statistics** lépést, és válaszd: „Yes, with Clarity”. Kattints a **Mentés és folytatás** gombra.
3. A **Statistics configuration** lépésen add meg a Clarity-projekt azonosítóját, és válaszolj „Yes”-szel erre a két kérdésre: „Do you want to ask consent for statistics?” és „Do you want to use Clarity Consent Mode V2?”.
4. Mentsd el, és fejezd be a varázslót. A Complianz kezeli a sávot, rögzíti a hozzájárulást, továbbítja a jelzést a Claritynek, és a szkripteket a hozzájárulásig blokkolja (ha így állítottad be).

## Mit csinál a Consent Mode v2 a Claritynél?

Az API-hívás így néz ki:

```js
window.clarity('consentv2', {
  ad_Storage: "granted" | "denied",
  analytics_Storage: "granted" | "denied"
});
```

- Ha az `ad_Storage` és az `analytics_Storage` is „granted”, a Clarity beállíthatja sütijeit (`_clck`, `_clsk`), és követheti a látogatót oldalakon és munkameneteken át.
- A Complianz beállításában az `ad_Storage` a **Marketing** kategóriától, az `analytics_Storage` a **Statistics** kategóriától függ.
- Ha bármelyik „denied”, a Clarity no-consent módba vált: nem állít be tartós felhasználói sütit, és minden oldalmegtekintést új felhasználóként kezel.
- A régi `window.clarity('consent', true/false)` hívás elavult, a ConsentV2 az ajánlott módszer.

Miért fontos:

- **Megfelelés:** a Clarity ott is tiszteletben tartja a hozzájárulást az analitikánál és marketingnél, ahol ezt a törvény előírja.
- **Adatminőség:** a helyes jelzés megakadályozza a megtört munkamenet-összefűzést és a jelentésekben a váratlanul csupa új felhasználót.
- **Megvalósítás:** tiszta, szabványos módja a hozzájárulás kezelésének a Microsoft és az EU/UK/CH követelményei szerint.

## Kézi beillesztés

Ez a rész akkor kell, ha nem a varázslóval illeszted be a Clarityt, és nem a Clarity WordPress-bővítményét használod, vagy ha már van statisztikai eszköz a Complianzben (például GTM Consent Mode-dal vagy anélkül, Matomo, Google Analytics, bővítményes megvalósítás), és emellé szeretnéd a Clarity Consent Mode-ot is, hogy pontosabb adatot kapj.

Illeszd be az alábbi részletet a weboldal fejlécébe. A `{site_ID}` helyére a Clarity-projekted azonosítóját írd.

```js
/**
 * Microsoft Clarity Consent Mode V2 integration with Complianz
 */
function callClarity(method, params) {
	if (typeof window.clarity === 'function') {
		try {
			window.clarity(method, params);
		} catch (e) {
			console.warn('Clarity API error:', e);
		}
	}
}
(function (c, l, a, r, i, t, y) {
	c[a] = c[a] || function () { (c[a].q = c[a].q || []).push(arguments); };
	t = l.createElement(r);
	t.async = 1;
	t.src = "https://www.clarity.ms/tag/" + i;
	y = l.getElementsByTagName(r)[0];
	y.parentNode.insertBefore(t, y);
})(window, document, "clarity", "script", "{site_ID}");
function getConsentFromEvent(e) {
	var d = e && e.detail && e.detail.categories ? e.detail.categories : [];
	var categories = Array.isArray(d) ? d : [];
	return {
		analyticsAllowed: categories.indexOf('statistics') !== -1,
		adsAllowed: categories.indexOf('marketing') !== -1
	};
}
function sendClarityConsent(analyticsAllowed, adsAllowed) {
	var status = function (b) { return b ? "granted" : "denied"; };
	callClarity('consentv2', {
		analytics_Storage: status(!!analyticsAllowed),
		ad_Storage: status(!!adsAllowed)
	});
}
function eraseClarityCookies() {
	callClarity('consent', false);
}
document.addEventListener('cmplz_fire_categories', function (e) {
	var consent = getConsentFromEvent(e);
	sendClarityConsent(consent.analyticsAllowed, consent.adsAllowed);
});
document.addEventListener('cmplz_revoke', function (e) {
	var consent = getConsentFromEvent(e);
	sendClarityConsent(consent.analyticsAllowed, consent.adsAllowed);
	if (!consent.analyticsAllowed && !consent.adsAllowed) {
		eraseClarityCookies();
	}
});
```

Elhelyezheted közvetlenül a sablon `header.php` fájljában (gyermeksablonnal ajánlott), vagy egy olyan bővítménnyel, mint a Header Footer Code Manager. A hozzájárulás a kategóriák szerint működik.

**Miért a fejlécbe?** A Claritynek a lehető legkorábban kell betöltődnie. Lábléc esetén a szkript lemaradhat a kezdeti oldaleseményekről, vagy késhet a mérés.

## Hibakeresés

Futtasd a böngésző konzoljában az alábbi kódot, és nézd meg, hogy a hozzájárulási állapotok helyesen változnak-e:

```js
clarity('metadata', (d, upgrade, consent) => {
  console.log('consentStatus:', consent);
}, false, true, true);
```

A Clarity két fő sütit használ:

- `_clck`: tartós süti, anonim felhasználóazonosítót és beállításokat tárol az oldalhoz. Ez alapján ismeri fel ugyanazt a látogatót több oldalmegtekintésen és munkameneten át.
- `_clsk`: munkamenet-süti, az aktuális látogatás eseményeit csoportosítja. Nem arra való, hogy a felhasználó azonosságát munkamenetek között megőrizze.

**Teljes hozzájárulásnál** (`ad_Storage: "granted"`, `analytics_Storage: "granted"`):

- a `_clck` beáll, és ugyanazt az értéket tartja, amíg a látogató az oldalon jár vagy később visszatér;
- a `_clsk` a szokásos módon munkamenetenként működik;
- a Clarity megbízhatóan összefűzi a munkameneteket, és felismeri a visszatérő látogatókat.

**Hozzájárulás nélkül** (mindkét érték „denied”):

- a `_clck` nincs beállítva, vagy üres értékű, attól függően, hogy a látogató elsőre utasította-e el a sávot, vagy később módosította a döntését;
- a `_clsk` ugyanígy nincs beállítva vagy üres;
- minden oldalmegtekintés „új felhasználóként” jelenhet meg a Clarity jelentéseiben, ez ebben a módban várt viselkedés.

## Gyakori hozzájárulási kombinációk

A példák azt mutatják, mit választ a látogató a Complianz sávban, és az hogyan jelenik meg a Claritynél.

### 1. Még nincs döntés (első látogatás)

Mielőtt a sávot elfogadják vagy elutasítják, a Complianz biztonságos alapértékekkel indítja a Clarityt:

```
ad_Storage:        'denied'
analytics_Storage: 'denied'
```

A Clarity gyakorlatilag no-consent módban fut: a `_clck` és a `_clsk` nincs beállítva, nincs tartós felhasználóazonosítás, és csak a szükséges korlátozott oldalszintű adat keletkezik.

### 2. Minden hozzájárulás elutasítva

Ha a látogató a statisztikát és a marketinget is elutasítja, az alapértékek ugyanezek (`denied`). Várt viselkedés:

- a `_clck` és a `_clsk` nincs beállítva;
- minden oldalmegtekintés „új felhasználó”, és bár sütik nincsenek, a Clarity a futó szkripten át megfelelő, süti nélküli módon kommunikál.

Ez a viselkedés szabályos és szándékos.

### 3. Marketing elutasítva, Statistics megadva

Gyakori eset: `ad_Storage: 'denied'`, `analytics_Storage: 'granted'`. A sávban ez Marketing = elutasítva, Statistics = megadva. A Clarity használhatja az analitikai sütiket (például `_clck`, `_clsk`), de az adatot nem használhatja hirdetési vagy remarketing célra.

- A Clarity sütik beállnak, és együtt tartják a munkameneteket.
- A látogató oldalakon és munkameneteken át ugyanaz a felhasználó marad.
- Az adat nem kerül hirdetési célú felhasználásra, mert az `ad_Storage` megtagadott.

### 4. Marketing és Statistics is megadva

Teljes hozzájárulás: `ad_Storage: 'granted'`, `analytics_Storage: 'granted'`.

- A `_clck` létrejön, és az oldalmegtekintések és visszatérő látogatások között stabil marad (az eltávolításig vagy lejáratig).
- A `_clsk` az aktuális munkamenetet kezeli.
- A Clarity követheti a visszatérő látogatókat, és összefüggő munkameneteket építhet.

Ha ebben az esetben a `_clck` folyamatosan változik, az általában azt jelzi, hogy a Clarity nem a helyes ConsentV2-jelzést kapja, vagy egy másik szkript túl agresszíven törli a sütiket.