Heap Auto-Capture termékanalitika sütiegyeztetési útmutató: 2026-os kézikönyv kiadóknak
A Heap szokatlan a termékanalitikai ökoszisztémában, mert alapértelmezés szerint mindent automatikusan rögzít. Ahol a Mixpanel, az Amplitude és a PostHog a kiadótól várja az instrumentálást, a Heap mindent elfog és utólag engedi az elemzőnek definiálni az eseményeket. Ez az auto-capture modell a termék meghatározó jellemzője és az oka, amiért csapatok választják; ugyanakkor ez az oka annak is, hogy egy alapértelmezett Heap-telepítés az egyik legszélesebb viselkedési adatfelületet hordozza az összes valószínűsíthetően telepített eszköz közül. Minden kattintás, érintés, görgetés, űrlapinterakció, oldalátmenet és dühödt kattintás rögzítésre kerül egy állandó azonosítóval szemben az oldal betöltésétől számított ezredmásodperceken belül – ami azt jelenti, hogy minden egyes művelet beleegyezési kötelezettséget von maga után. A jó hír az, hogy a Heap, a Contentsquare általi felvásárlása óta, a termékanalitikai tér egyik legrészletesebb beleegyezési API-jával rendelkezik; a munka az auto-capture felületen, az identitásrétegen és a Contentsquare-integráció által hozzáadott munkamenet-visszajátszó modulon való helyes bekötésben rejlik.
Miért igényel a Heap beleegyezést – és miért terjed ez a válasz a szokásos analitikán túl
Egy alapértelmezett Heap-inicializálás az oldal első festésekor több dolgot is elvégez. Beállít egy first-party sütit a _hp2_id.{envId} alatt, amely az állandó felhasználói azonosítót tartalmazza, egy munkamenet-sütit a _hp2_ses_id.{envId} alatt a munkamenet-azonosítóval, egy mintavételi arány sütit a _hp2_props.{envId} alatt, és egy _hp2_loaded jelzőt, amely azt mutatja, hogy az SDK inicializálódott. Legenerálja az egyedi azonosítót, ha még nem létezik, rögzíti a kezdeti oldallekérést referrerrel, UTM paraméterekkel és kattintásazonosítókkal, és azonnal elkezdi rögzíteni az összes ezt követő interakciót azzal az azonosítóval szemben – kattintásokat, érintéseket, űrlapváltozásokat, útvonalváltásokat, egyéni eseményeket és, amikor a Contentsquare-integráció engedélyezve van, a teljes renderelt DOM-diff-et a munkamenet-visszajátszáshoz.
Ezek mindegyike külön beleegyezési kaput érint. Az ePrivacy-irányelv 5(3). cikke szerinti tárolási és hozzáférési műveletnek minősül a felhasználói azonosító megőrzése, és az EEA-ban, az Egyesült Királyságban, valamint az azonos szabványt átvevő jogrendszerekben előzetes, szabadon adott, konkrét, tájékoztatott és egyértelmű beleegyezést igényel. Az auto-capture eseményfolyam rögzítése a GDPR szerinti személyes adatok kezelésének minősül, mivel az azonosító, az IP-cím és a viselkedési nyom kombinációja elegendő egy személy azonosításához. A munkamenet-visszajátszás az EDPB munkamenet-visszajátszási iránymutatása alapján külön, szigorúbb kategóriába esik – a visszajátszás rögzíti a renderelt DOM-ot és minden maszkolatlan beviteli mezőt, és a generikus analitikai beleegyezéstől eltérő, explicit és részletes beleegyezést igényel. A CCPA és a CPRA ugyanazt a feldolgozást értékesítésnek vagy megosztásnak tekinti, hacsak a kiadónak nincs megfelelő szolgáltatói szerződése a Heappel – amelyet a Heap kínál, de a szerződés csak akkor lép hatályba, ha az integráció szolgáltatói módra van konfigurálva.
Mit ír a Heap a beleegyezés előtt – és mit kell elnyomni
A Heap-irányítópulttal szállított szabványos gyorsindítás közvetlenül az oldal <head> részébe telepíti a követési részletet. Ez a dokumentált módon működik, és ez a Heap-telepítések leggyakoribb megfelelőségi hibájának forrása: a részlet lefut, mielőtt a sütiértesítő megjelenít, a _hp2_ sütik ezredmásodperceken belül íródnak, és az auto-capture folyam elkezd folyni a heapanalytics.com felé, függetlenül attól, hogy a felhasználó mit dönt később. Minden európai szabályozó hatóság, amely állást foglalt erről a mintáról, ugyanúgy döntött: a beleegyezés előtt beállított sütik jogellenes, és a kiadó viseli a felelősséget.
Egy megfelelő integrációnak tehát meg kell akadályoznia a Heap-részlet betöltését mindaddig, amíg a vonatkozó beleegyezési kategóriát meg nem adták. A két, termelésben működő minta a feltételes szkriptinjekció – a részlet csak akkor adódik hozzá a DOM-hoz, miután a CMP beleegyezést jelez – és a részlet előzetes betöltése heap.load(appId, { disableTextCapture: true, secureCookie: true, autocapture: false }) formájában, halasztott bootstrap-ként, majd a heap.startAutoCapture() meghívása a beleegyezés rögzítése után. A feltételes injekciós minta tisztább, és ezt ajánlja most a Heap dokumentációja. A halasztott bootstrap minta a megfelelő választás, amikor a kiadónak stabil globális referenciára van szüksége az identitás-összevarráshoz, de nem engedheti meg, hogy az auto-capture a beleegyezés előtt tüzeljen.
A Heap által írt sütik és tárhely
A Heap-részlet az inicializáláskor a következő azonosítókat írja, amelyek mind nem alapvetők és beleegyezést igényelnek: _hp2_id.{envId} 14 hónapos lejárattal, amely a felhasználói azonosítót tartalmazza; _hp2_ses_id.{envId} 30 perces munkamenet-lejárattal; _hp2_props.{envId} a mintavételi arányhoz és tulajdonságterjesztéshez; és _hp2_loaded betöltési jelzőként. A Contentsquare-integrált munkamenet-visszajátszó modul egy memóriabeli rögzítési puffert ad hozzá, amely néhány másodpercenként kitöröl a Heap-végpontba, és esetleg külön megőrizhet egy kis visszajátszás-munkamenet-azonosítót. A beleegyezés visszavonásakor tehát mind a _hp2_ sütiket le kell járatni, mind törlési kérelmet kell küldeni a Heap GDPR API-ján keresztül a felhasználó korábbi felvételeihez és eseményfolyamához.
A Heap leképezése a beleegyezési keretrendszerekre
A Heap natívan nem implementálja az IAB TCF-et vagy az IAB globális adatvédelmi platformot – elsősorban egy first-party termékanalitikai platform, nem reklámos technológiai szállító –, de integrálódik a Google Consent Mode v2-vel a kiadói oldalon történő áthidaláson keresztül, natív opt-in és opt-out API-t biztosít, és támogat egy érzékeny tulajdonsággal való eltávolítási réteget, amely a beleegyezési állapottól függetlenül működik. Az a minta, amely kiállja a szabályozó hatóság felülvizsgálatát, minden Heap-modult külön kapuként kezel, amely egy adott CMP-jelhez van kötve.
- Az auto-capture és az alap eseményfolyam az analitikai célhoz kötődik. TCF-szakkifejezésekben ez leggyakrabban a 8-as cél (tartalom teljesítményének mérése) a 1-es céllal kombinálva (információk tárolása és/vagy elérése). A Consent Mode-ban ez az analytics_storage-ra képez le.
- A Contentsquare-integráción keresztüli munkamenet-visszajátszás egy szigorúbb, külön kapu mögött van, mert a visszajátszás rögzíti a renderelt DOM-ot és minden maszkolatlan beviteli mezőt, és az EDPB munkamenet-visszajátszási iránymutatása a generikus analitikától eltérő, explicit és részletes beleegyezést igénylő kategóriaként kezeli.
- A heap.identify() általi felhasználói azonosítás futhat névtelen munkamenet-azonosítóval jogos érdek alapján, amikor a felhasználó névtelen, de az azonosítás állandó first-party azonosítóhoz való hozzávarrása munkamenetek között ugyanolyan beleegyezést igényel, mint az analitika, mert ekkor válik az azonosító nyomon követhető felhasználói szintű adatponttá.
- A több webhelyre vagy termékre kiterjedő identitásterjesztés az identitás API-n keresztül a marketing kaput igényli, mert átlépi a termékanalitikától a felhasználói szintű marketing-attribúcióig tartó határt.
A működő integrációs minta
A referencia-telepítés négy részből áll: egy CMP, amely valós idejű beleegyezés-változás eseményt tesz elérhetővé; egy halasztott bootstrap, amely letölti a Heapet, letiltott auto-capture-rel; egy beleegyezési figyelő, amely bekapcsolja az auto-capture-t és elindítja a munkamenet-visszajátszó puffert, amikor a vonatkozó kapuk megnyílnak; és egy visszavonási útvonal, amely meghívja a heap.resetIdentity()-t, leállítja az auto-capture-t, lejáratja a _hp2_ sütiket, és törlési kérelmet küld a Heap GDPR-végpontján keresztül.
Webes implementáció
Weben a legtisztább minta a Heap-részlet feltételes betöltése – a <script> tag csak az analitikai kategória megadása után kerül be. Iratkozzon fel a CMP beleegyezés-változás eseményére. Amikor az analitikai kategória igazzá válik, injektálja a Heap-részletet secureCookie: true, disableTextCapture: false teljes auto-capture-hez, és bármilyen környezetspecifikus konfigurációval. Amikor a munkamenet-visszajátszási beleegyezés igazzá válik és a Contentsquare-integráció engedélyezve van, a visszajátszási puffer automatikusan aktiválódik. Ha bármelyik kapu visszavon, hívja meg a heap.resetIdentity()-t, majd távolítsa el a Heap script elemét, járassa le a _hp2_ sütiket a document.cookie-n keresztül, és hívja meg a GDPR-törlési API-t a felhasználói azonosítóhoz.
Érzékeny tulajdonság eltávolítása
A Heap egy eltávolítási réteggel rendelkezik, amely a beleegyezési állapottól függetlenül működik, és amelyet a kiadóknak akkor is érdemes használniuk, ha beleegyezés érkezett. A data-heap-redact-text attribútum egy beviteli mezőn elnyomja a rögzített szöveges tartalmat; a data-heap-redact-attributes attribútum elnyomja az elem attribútumait. A GDPR különleges kategóriájú szabályai és a CCPA érzékeny személyes adatok definíciója szerint minden mezőnek, amely egészségügyi információt, pénzügyi adatot, kormányzati azonosítókat, biometrikus adatokat, pontos földrajzi helyet vagy privát kommunikáció tartalmát rögzíthetné, a beleegyezési állapottól függetlenül kell használnia az eltávolítási attribútumokat. Az attribútumok az űrlap szintjén való beállítása a legbiztonságosabb minta – ez elnyomja az egész űrlapot, még akkor is, ha egy fejlesztő hozzáad egy új mezőt, amelyet elfelejt egyenként megjelölni.
Régió kiválasztása: EU kontra US adattárolás
A Heap különálló EU és US befogadási végpontokat működtet. Az EEA és az UK forgalom esetén az EU-végpont a megfelelő alapértelmezett; a befogadást, feldolgozást és tárolást az EEA-n belül tartja, és csökkenti azt a Schrems II-kockázatot, amelyet bármely US-régióbeli analitikai telepítés hordoz. A végpontot a részlet konfigurációján keresztül kell beállítani, és visszamenőlegesen nem módosítható – a meglévő adatok ott maradnak, ahol először befogadták őket. A Heap-bevezetést tervező kiadóknak ezért érdemes megerősíteni a régiót a skálázás előtt, és dokumentálni a döntést az adatvédelmi tájékoztatóban, hogy a jogalapok lánca tiszta legyen a gyűjtéstől a tárolásig.
Az integráció és az ellenőrzési nyomvonal validálása
A validálási lépés az, amit a szabályozó hatóságok ellenőriznek, és amit a kiadók leggyakrabban kihagynak. Egy helyesen integrált Heap-telepítésnek sorban négy tesztet kell átmennie. Először, egy tiszta böngésző-munkamenetnek, amelyen a banner megjelenik, de nem születik döntés, nulla kérelmet kell produkálnia a heapanalytics.com felé az SDK-fájl lekérésén túl, és nulla _hp2_ sütit a document.cookie-ban. Másodszor, az analitika elutasításának fenn kell tartania ezt az állapotot – nincs auto-capture, nincs azonosító, nincs felvétel. Harmadszor, az analitika elfogadásának elő kell állítania a várt _hp2_id sütit helyes SameSite attribútumokkal és a konfigurált régió végpontjára folyó eseményforgalommal. Negyedszer, a beleegyezés visszavonásának azonnal le kell állítania a további auto-capture-t és visszajátszást, le kell járatnia a _hp2_ sütiket, és törlési kérelmet kell indítania a Heap GDPR API-ján keresztül.
Az EDPB 2023-as sütiértesítési iránymutatása és a megújított 2026-os munkacsoport prioritásai szerinti ellenőrzési nyomvonal elvárása az, hogy a kiadó bizonyítani tudja, a Heap-projektben lévő bármely adott eseményre vonatkozóan, hogy az azt generáló felhasználó a rögzítés pillanatában érvényes beleegyezést adott. A szokásos minta az, hogy a beleegyezési verziót és az időbélyeget felhasználói tulajdonságokként kell beállítani az egyedi azonosítón keresztül, a heap.addUserProperties({ consent_version: 'v3', consent_ts: ts }) segítségével, hogy bármely egyedi esemény visszavezethető legyen egy adott beleegyezési napló bejegyzéséhez. A helyesen elkészített telepítés, párosítva az alapértelmezés szerint érzékeny mezőket elnyomó eltávolítási attribútumokkal és egy visszavonáskor aktiválódó törlési útvonallal, az, ami a Heap auto-capture modelljét egy szabályozói koncentrációs kockázatból a kiadó termékanalitikai veremének egyik legerősebb és legvédhetőbb részévé teszi.