Ghid de integrare a consimțământului pentru cookie-uri în analiza produselor Heap Auto-Capture: Manualul 2026 pentru editori
Heap este neobișnuit în ecosistemul analizei produselor datorită a ceea ce face implicit. Acolo unde Mixpanel, Amplitude și PostHog cer editorului să instrumenteze evenimentele importante, Heap capturează totul automat și permite analistului să definească evenimentele retroactiv din fluxul capturat. Acel model de captare automată este caracteristica definitorie a produsului și motivul pentru care echipele îl aleg; este, de asemenea, motivul pentru care o implementare implicită Heap poartă una dintre cele mai largi suprafețe de date comportamentale ale oricărui instrument pe care un editor îl poate instala. Fiecare clic, atingere, derulare, interacțiune cu formularul, tranziție de pagină și clic de frustrare este captat față de un identificator persistent în milisecunde de la încărcarea paginii — ceea ce înseamnă că fiecare dintre aceste operațiuni generează o obligație de consimțământ. Vestea bună este că Heap, de la achiziționarea sa de către Contentsquare, vine cu unul dintre cele mai granulare API-uri de consimțământ din spațiul analizei produselor; munca constă în conectarea corectă a acestuia pe suprafața de captare automată, stratul de identitate și modulul de reluare a sesiunii pe care îl adaugă integrarea Contentsquare.
De ce Heap necesită consimțământ — și de ce răspunsul este mai larg decât analiza tipică
O inițializare implicită Heap face mai multe lucruri la prima redare a paginii. Setează un cookie de primă parte sub _hp2_id.{envId} care conține identificatorul persistent al utilizatorului, un cookie de sesiune sub _hp2_ses_id.{envId} cu identificatorul sesiunii, un cookie pentru rata de eșantionare sub _hp2_props.{envId} și un marcator _hp2_loaded care indică faptul că SDK-ul a fost inițializat. Generează identificatorul distinct dacă nu există deja, capturează vizualizarea inițială a paginii cu referrer, parametrii UTM și identificatorii de clic și începe imediat să înregistreze fiecare interacțiune ulterioară față de acel identificator — clicuri, atingeri, modificări ale formularului, schimbări de rută, evenimente personalizate și, când integrarea Contentsquare este activată, diferența completă a DOM-ului redat pentru reluarea sesiunii.
Fiecare dintre aceste activități angajează o poartă de consimțământ separată. Persistența identificatorului utilizatorului este o operațiune de stocare și acces în temeiul Articolului 5(3) din Directiva ePrivacy și necesită consimțământ prealabil, liber exprimat, specific, informat și neechivoc în întregul SEE, Regatul Unit și orice jurisdicție care a adoptat același standard. Capturarea fluxului de evenimente de captare automată reprezintă prelucrare de date cu caracter personal în temeiul GDPR, deoarece combinația de identificator, adresă IP și urmă comportamentală este suficientă pentru a individualiza o persoană. Reluarea sesiunii se încadrează într-o categorie separată și mai strictă conform ghidurilor EDPB privind reluarea sesiunilor — reluarea captează DOM-ul redat și orice câmpuri de introducere nemascat și necesită consimțământ explicit și granular care să fie distinct de consimțământul generic pentru analiză. CCPA și CPRA tratează aceeași prelucrare drept vânzare sau partajare, dacă editorul nu are contractul relevant cu Heap ca furnizor de servicii — pe care Heap îl oferă, dar contractul intră în vigoare numai când integrarea este configurată pentru modul furnizor de servicii.
Ce scrie Heap înainte de consimțământ — și ce trebuie suprimat
Startul rapid standard livrat cu tabloul de bord Heap instalează fragmentul de urmărire direct în <head>-ul paginii. Aceasta funcționează conform documentației și este sursa celei mai frecvente eșecuri de conformitate în implementările Heap: fragmentul rulează înainte ca banner-ul de cookie-uri să fie redat, cookie-urile _hp2_ sunt scrise în milisecunde și fluxul de captare automată începe să curgă spre heapanalytics.com indiferent de ce decide utilizatorul mai târziu. Fiecare autoritate de reglementare europeană care s-a pronunțat asupra acestui tipar a decis la fel: cookie-urile setate înainte de consimțământ sunt ilegale, iar editorul poartă răspunderea.
O integrare conformă trebuie, prin urmare, să împiedice încărcarea fragmentului Heap până când categoria de consimțământ relevantă a fost acordată. Cele două tipare care funcționează în producție sunt injecția condiționată de script — fragmentul este adăugat în DOM numai după ce CMP semnalează consimțământul — și preîncărcarea fragmentului cu heap.load(appId, { disableTextCapture: true, secureCookie: true, autocapture: false }) ca bootstrap amânat și apoi apelarea heap.startAutoCapture() odată ce consimțământul este înregistrat. Tiparul injecției condiționate este mai curat și cel pe care documentația Heap îl recomandă acum. Tiparul bootstrap-ului amânat este alegerea potrivită atunci când editorul are nevoie de o referință globală stabilă pentru legarea identității, dar nu poate permite activarea capturării automate înainte de consimțământ.
Cookie-urile și stocarea pe care le scrie Heap
Fragmentul Heap scrie următorii identificatori la inițializare, toți non-esențiali și necesitând consimțământ: _hp2_id.{envId} cu o expirare de 14 luni care conține identificatorul utilizatorului, _hp2_ses_id.{envId} cu o expirare a sesiunii de 30 de minute, _hp2_props.{envId} pentru rata de eșantionare și propagarea proprietăților și _hp2_loaded ca marker de încărcare. Modulul de reluare a sesiunii integrat cu Contentsquare adaugă un buffer de înregistrare în memorie care se golește la endpoint-ul Heap la câteva secunde și poate păstra separat un mic identificator de sesiune de reluare. Retragerea consimțământului trebuie, prin urmare, atât să expire cookie-urile _hp2_, cât și să semnaleze o cerere de ștergere prin API-ul GDPR al Heap pentru înregistrările anterioare ale utilizatorului și fluxul de evenimente.
Maparea Heap pe cadrele de consimțământ
Heap nu implementează nativ IAB TCF sau Platforma Globală de Confidențialitate IAB — este o platformă de analiză a produselor de primă parte, nu un furnizor de tehnologie publicitară — dar se integrează cu Google Consent Mode v2 prin punți pe partea editorului, expune un API nativ de opt-in și opt-out și suportă un strat de redactare a proprietăților sensibile care funcționează indiferent de starea consimțământului. Tiparul care supraviețuiește revizuirii unui regulator tratează fiecare modul Heap ca pe o poartă separată legată de un semnal CMP specific.
- Captarea automată și fluxul de evenimente principale sunt legate de scopul analitică. În termenii TCF, acesta este cel mai frecvent scopul 8 (măsurarea performanței conținutului) combinat cu scopul 1 (stocarea și/sau accesarea informațiilor). Pentru Consent Mode, acesta se mapează la analytics_storage.
- Reluarea sesiunii prin integrarea Contentsquare se află în spatele unei porți mai stricte și separate, deoarece reluarea captează DOM-ul redat și orice câmpuri de introducere nemascat, iar ghidurile EDPB privind reluarea sesiunilor o tratează ca pe o categorie care necesită consimțământ explicit și granular distinct de analiza generică.
- Identificarea utilizatorului prin heap.identify() poate rula cu un identificator de sesiune efemer pe baza interesului legitim când utilizatorul este anonim, dar legarea identificării de un identificator persistent de primă parte între sesiuni necesită același consimțământ ca analiza, deoarece atunci identificatorul devine un punct de date la nivel de utilizator care poate fi urmărit.
- Propagarea identității între site-uri sau între produse prin API-ul de identitate necesită poarta de marketing, deoarece depășește limita de la analiza produselor la atribuirea de marketing la nivel de utilizator.
Tiparul de integrare care funcționează
Implementarea de referință are patru părți: un CMP care expune un eveniment de schimbare a consimțământului în timp real, un bootstrap amânat care încarcă Heap cu captarea automată dezactivată, un ascultător de consimțământ care activează captarea automată și pornește buffer-ul de reluare a sesiunii când se deschid porțile relevante și o cale de retragere care apelează heap.resetIdentity(), oprește captarea automată, expiră cookie-urile _hp2_ și trimite o cerere de ștergere prin endpoint-ul GDPR al Heap.
Implementare web
Pe web, cel mai curat tipar este să se încarce fragmentul Heap condiționat — eticheta <script> este injectată numai după ce categoria de analiză a fost acordată. Abonați-vă la evenimentul de schimbare a consimțământului al CMP-ului. Când categoria de analiză face tranziția la true, injectați fragmentul Heap cu secureCookie: true, disableTextCapture: false pentru captarea automată completă și orice configurație specifică mediului. Când consimțământul pentru reluarea sesiunii face tranziția la true și integrarea Contentsquare este activată, buffer-ul de reluare se activează automat. Când orice poartă este retrasă, apelați heap.resetIdentity() urmat de eliminarea elementului de script Heap, expirați cookie-urile _hp2_ prin document.cookie și invocați API-ul de ștergere GDPR pentru identificatorul utilizatorului.
Redactarea proprietăților sensibile
Heap vine cu un strat de redactare care funcționează indiferent de starea consimțământului și pe care editorii ar trebui să îl folosească chiar și atunci când consimțământul a fost acordat. Atributul data-heap-redact-text pe un câmp de formular suprimă conținutul text capturat; atributul data-heap-redact-attributes suprimă atributele elementului. Conform regulilor privind categoriile speciale din GDPR și definiției informațiilor personale sensibile din CCPA, orice câmp care ar putea capta informații de sănătate, detalii financiare, identificatori guvernamentali, date biometrice, geolocalizare precisă sau conținutul comunicărilor private trebuie să utilizeze atributele de redactare indiferent de starea consimțământului utilizatorului. Setarea atributelor la nivelul formularului este cel mai sigur tipar — suprimă întregul formular chiar și atunci când un dezvoltator adaugă un câmp nou pe care uită să îl marcheze individual.
Selecția regiunii: rezidența datelor în UE față de SUA
Heap operează endpoint-uri de ingestie separate pentru UE și SUA. Pentru traficul din SEE și Regatul Unit, endpoint-ul UE este valoarea implicită corectă; menține ingestia, prelucrarea și stocarea în interiorul SEE și reduce expunerea la Schrems II pe care o poartă orice implementare de analiză din regiunea SUA. Endpoint-ul este setat prin configurarea fragmentului și nu poate fi modificat retroactiv — datele existente rămân unde au fost ingerate prima dată. Pentru editorii care planifică o lansare Heap, merită, prin urmare, să confirme regiunea înainte de scalare și să documenteze alegerea în nota de confidențialitate, astfel încât lanțul temeiului juridic să fie clar de la colectare până la stocare.
Validarea integrării și a traseului de audit
Pasul de validare este ceea ce verifică autoritățile de reglementare și ceea ce editorii omit cel mai adesea. O implementare Heap corect integrată trebuie să treacă patru teste în secvență. În primul rând, o sesiune de browser curată cu banner-ul afișat, dar fără nicio alegere făcută, trebuie să producă zero cereri la heapanalytics.com în afara recuperării fișierului SDK și zero cookie-uri _hp2_ în document.cookie. În al doilea rând, refuzul analizei trebuie să mențină această stare — nicio captare automată, niciun identificator, nicio înregistrare. În al treilea rând, acceptarea analizei trebuie să producă cookie-ul _hp2_id așteptat cu atributele SameSite corecte și traficul de evenimente care curge spre endpoint-ul regiunii configurate. În al patrulea rând, retragerea consimțământului trebuie să oprească imediat captarea automată și reluarea suplimentare, să expire cookie-urile _hp2_ și să declanșeze o cerere de ștergere prin API-ul GDPR al Heap.
Așteptarea privind traseul de audit în temeiul ghidurilor EDPB din 2023 privind banner-urile de cookie-uri și prioritățile reînnoite ale grupului de lucru din 2026 este că editorul poate demonstra, pentru orice eveniment dat din proiectul Heap, că utilizatorul care l-a generat acordase consimțământ valabil la momentul capturării. Tiparul standard este de a seta versiunea consimțământului și marca de timp ca proprietăți ale utilizatorului pe ID-ul distinct prin heap.addUserProperties({ consent_version: 'v3', consent_ts: ts }), astfel încât orice eveniment individual să poată fi urmărit înapoi la o intrare specifică din jurnalul de consimțământ. O implementare corect asigurată, combinată cu atribute de redactare care suprimă câmpurile sensibile în mod implicit și o cale de ștergere care se activează la retragere, este ceea ce transformă modelul de captare automată al Heap dintr-un risc de concentrare de reglementare în una dintre cele mai puternice și mai apărabile părți ale stivei de analiză a produselor unui editor.