Microsoft Clarity Consent Mode v2

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:

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.

/**
 * 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:

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.