Guia d'integració del consentiment de galetes per a analítica de producte amb captura automàtica de Heap: Manual 2026 per a editors
Heap és inusual en l'ecosistema d'analítica de producte a causa del que fa per defecte. Mentre que Mixpanel, Amplitude i PostHog demanen a l'editor que instrumenti els esdeveniments importants, Heap ho captura tot automàticament i deixa que l'analista defineixi els esdeveniments retroactivament a partir del flux capturat. Aquest model de captura automàtica és la característica definitòria del producte i la raó per la qual els equips l'escullen; també és la raó per la qual un desplegament de Heap per defecte porta una de les superfícies de dades de comportament més àmplies de qualsevol eina que un editor probablement instal·larà. Cada clic, toc, desplaçament, interacció amb formularis, transició de pàgina i clic enfadat es captura contra un identificador persistent en mil·lisegons de la càrrega de la pàgina — el que significa que cadascuna d'aquestes operacions genera una obligació de consentiment. La bona notícia és que Heap, des de la seva adquisició per Contentsquare, incorpora una de les API de consentiment més granulars de l'espai d'analítica de producte; la feina és connectar-la correctament a través de la superfície de captura automàtica, la capa d'identitat i el mòdul de reproducció de sessió que afegeix la integració de Contentsquare.
Per què Heap requereix consentiment — i per què la resposta és més àmplia que l'analítica típica
Una inicialització de Heap per defecte fa diverses coses en el primer dibuix de la pàgina. Estableix una galeta de primera part sota _hp2_id.{envId} que conté l'identificador d'usuari persistent, una galeta de sessió sota _hp2_ses_id.{envId} amb l'identificador de sessió, una galeta de taxa de mostreig sota _hp2_props.{envId} i un marcador _hp2_loaded que indica que el SDK s'ha inicialitzat. Genera l'identificador distinct si no existeix, captura la visualització de pàgina inicial amb el referent, els paràmetres UTM i els identificadors de clic, i comença immediatament a registrar cada interacció posterior contra aquest identificador — clics, tocs, canvis de formulari, canvis de ruta, esdeveniments personalitzats i, quan la integració de Contentsquare està habilitada, la diferència completa del DOM renderitzat per a la reproducció de sessió.
Cadascuna d'aquestes activitats genera una porta de consentiment separada. La persistència de l'identificador d'usuari és una operació d'emmagatzematge i accés sota Article 5(3) de la Directiva ePrivacy i requereix consentiment previ, lliurement donat, específic, informat i inequívoc a l'EEA, al Regne Unit i a qualsevol jurisdicció que hagi importat el mateix estàndard. La captura del flux d'esdeveniments de captura automàtica és processament de dades personals sota el GDPR perquè la combinació d'identificador, adreça IP i traça de comportament és suficient per individualitzar una persona. La reproducció de sessió cau en una categoria separada i més estricta sota les directrius del EDPB sobre reproducció de sessió — la reproducció captura el DOM renderitzat i qualsevol camp d'entrada sense màscara i requereix un consentiment explícit i granular que és diferent del consentiment genèric d'analítica. CCPA i CPRA tracten el mateix processament com a venda o compartició, llevat que l'editor tingui el contracte de proveïdor de serveis rellevant amb Heap — que Heap ofereix, però el contracte només entra en vigor quan la integració es configura per al mode de proveïdor de serveis.
Què escriu Heap abans del consentiment — i què s'ha de suprimir
L'inici ràpid estàndard que inclou el tauler de Heap instal·la el fragment de seguiment directament al <head> de la pàgina. Això funciona tal com s'ha documentat i és la font del fracàs de compliment més comú en els desplegaments de Heap: el fragment s'executa abans que el bàner de galetes s'hagi renderitzat, les galetes _hp2_ s'escriuen en mil·lisegons i el flux de captura automàtica comença a fluir cap a heapanalytics.com independentment del que l'usuari decideixi més tard. Tot regulador europeu que s'ha pronunciat sobre aquest patró ha resolt de la mateixa manera: les galetes establertes abans del consentiment són il·legals i l'editor porta la responsabilitat.
Una integració compliant ha d'impedir, per tant, que el fragment de Heap es carregui fins que s'hagi concedit la categoria de consentiment rellevant. Els dos patrons que funcionen en producció són la injecció de scripts condicional — el fragment s'afegeix al DOM només després que el CMP senyali el consentiment — i la precàrrega del fragment amb heap.load(appId, { disableTextCapture: true, secureCookie: true, autocapture: false }) com a arrencada diferida i després cridar heap.startAutoCapture() una vegada registrat el consentiment. El patró d'injecció condicional és més net i el que la documentació de Heap ara recomana. El patró d'arrencada diferida és la tria adequada quan l'editor necessita una referència global estable per al cosit d'identitat però no pot permetre que la captura automàtica s'activi abans del consentiment.
Les galetes i l'emmagatzematge que escriu Heap
El fragment de Heap escriu els identificadors següents en la inicialització, tots els quals no són essencials i requereixen consentiment: _hp2_id.{envId} amb una caducitat de 14 mesos que conté l'identificador d'usuari, _hp2_ses_id.{envId} amb una caducitat de sessió de 30 minuts, _hp2_props.{envId} per a la taxa de mostreig i la propagació de propietats, i _hp2_loaded com a marcador de càrrega. El mòdul de reproducció de sessió integrat amb Contentsquare afegeix un buffer de gravació en memòria que es buidarà al punt final de Heap cada pocs segons i pot persistir un petit identificador de sessió de reproducció per separat. Per tant, la retirada del consentiment ha de caducar les galetes _hp2_ i senyalar una sol·licitud d'eliminació a través de l'API de GDPR de Heap per a les gravacions i el flux d'esdeveniments anteriors de l'usuari.
Mapeig de Heap als marcs de consentiment
Heap no implementa IAB TCF ni IAB Global Privacy Platform de forma nativa — és una plataforma d'analítica de producte de primera part, no un proveïdor de tecnologia publicitària — però s'integra amb Google Consent Mode v2 a través del pont del costat de l'editor, exposa una API d'opt-in i opt-out nativa i suporta una capa de redacció de propietats sensibles que opera independentment de l'estat del consentiment. El patró que sobreviu a la revisió d'un regulador tracta cada mòdul de Heap com una porta separada lligada a un senyal de CMP específic.
- La captura automàtica i el flux d'esdeveniments central s'associen al propòsit d'analítica. En termes de TCF, sol ser el propòsit 8 (mesurar el rendiment del contingut) combinat amb el propòsit 1 (emmagatzemar i/o accedir a la informació). Per a Consent Mode, això s'associa a analytics_storage.
- La reproducció de sessió a través de la integració de Contentsquare es troba darrere d'una porta separada i més estricta perquè la reproducció captura el DOM renderitzat i qualsevol camp d'entrada sense màscara, i les directrius del EDPB sobre reproducció de sessió la tracten com una categoria que requereix consentiment explícit i granular diferent de l'analítica genèrica.
- La identificació d'usuari a través de heap.identify() pot executar-se amb un identificador de sessió efímer sota una base d'interès legítim quan l'usuari és anònim, però cosir la identificació a un identificador de primera part persistent entre sessions requereix el mateix consentiment que l'analítica perquè és aleshores quan l'identificador es converteix en un punt de dades de nivell d'usuari rastreable.
- La propagació d'identitat entre llocs o productes a través de l'API d'identitat requereix la porta de màrqueting perquè creua la línia de l'analítica de producte a l'atribució de màrqueting a nivell d'usuari.
El patró d'integració que funciona
El desplegament de referència té quatre parts: un CMP que exposa un esdeveniment de canvi de consentiment en temps real, una arrencada diferida que carrega Heap amb la captura automàtica desactivada, un escoltador de consentiment que activa la captura automàtica i inicia el buffer de reproducció de sessió quan s'obren les portes rellevants, i un camí de retirada que crida heap.resetIdentity(), atura la captura automàtica, caduca les galetes _hp2_ i envia una sol·licitud d'eliminació a través del punt final GDPR de Heap.
Implementació web
A la web, el patró més net és carregar el fragment de Heap de forma condicional — l'etiqueta <script> s'injecta només després que s'hagi concedit la categoria d'analítica. Subscriviu-vos a l'esdeveniment de canvi de consentiment del CMP. Quan la categoria d'analítica passa a ser certa, injecteu el fragment de Heap amb secureCookie: true, disableTextCapture: false per a la captura automàtica completa i qualsevol configuració específica de l'entorn. Quan el consentiment de reproducció de sessió passa a ser cert i la integració de Contentsquare està habilitada, el buffer de reproducció s'activa automàticament. Quan qualsevol porta es retira, crideu heap.resetIdentity() seguit de l'eliminació de l'element de script de Heap, caduceu les galetes _hp2_ via document.cookie i invoqueu la GDPR-deletion API per a l'identificador de l'usuari.
Redacció de propietats sensibles
Heap inclou una capa de redacció que opera independentment de l'estat del consentiment i que els editors haurien d'utilitzar fins i tot quan s'hagi concedit el consentiment. L'atribut data-heap-redact-text en un camp de formulari suprimeix el contingut de text capturat; l'atribut data-heap-redact-attributes suprimeix els atributs de l'element. Sota les regles de categoria especial del GDPR i la definició d'informació personal sensible del CCPA, qualsevol camp que pogués capturar informació de salut, detalls financers, identificadors governamentals, dades biomètriques, geolocalització precisa o continguts de comunicacions privades ha d'usar els atributs de redacció independentment de l'estat de consentiment de l'usuari. Establir els atributs al nivell del formulari és el patró més segur — suprimeix el formulari sencer fins i tot quan un desenvolupador afegeix un nou camp que oblida marcar individualment.
Selecció de regió: residència de dades a la UE versus als EUA
Heap opera punts finals d'ingestió separats per a la UE i els EUA. Per al trànsit de l'EEA i el Regne Unit, el punt final de la UE és el valor per defecte correcte; manté la ingestió, el processament i l'emmagatzematge dins de l'EEA i redueix l'exposició a Schrems II que porta qualsevol desplegament d'analítica de la regió dels EUA. El punt final s'estableix a través de la configuració del fragment i no es pot canviar de forma retroactiva — les dades existents romanen allà on es van ingerir per primera vegada. Per als editors que planegen un desplegament de Heap, per tant, val la pena confirmar la regió abans d'escalar i documentar la tria a l'avís de privacitat perquè la cadena de base legal sigui neta des de la recollida fins a l'emmagatzematge.
Validació de la integració i el rastre d'auditoria
L'etapa de validació és el que comproven els reguladors i el que els editors sovint ometen. Un desplegament de Heap correctament integrat ha de superar quatre proves en seqüència. En primer lloc, una sessió de navegador neta amb el bàner mostrat però sense cap elecció feta ha de produir zero sol·licituds a heapanalytics.com més enllà de la recuperació del fitxer SDK i zero galetes _hp2_ a document.cookie. En segon lloc, refusar l'analítica ha de mantenir aquest estat — sense captura automàtica, sense identificador, sense gravació. En tercer lloc, acceptar l'analítica ha de produir la galeta _hp2_id esperada amb els atributs SameSite correctes i trànsit d'esdeveniments que flueix cap al punt final de la regió configurada. En quart lloc, retirar el consentiment ha d'aturar immediatament la captura automàtica i la reproducció addicionals, caducar les galetes _hp2_ i activar una sol·licitud d'eliminació a través de l'API de GDPR de Heap.
L'expectativa de rastre d'auditoria sota les directrius del bàner de galetes del EDPB del 2023 i les prioritats renovades del grup de treball del 2026 és que l'editor pugui demostrar, per a qualsevol esdeveniment del projecte de Heap, que l'usuari que el va generar havia donat un consentiment vàlid en el moment de la captura. El patró estàndard és establir la versió de consentiment i la marca de temps com a propietats d'usuari a l'ID distinct a través de heap.addUserProperties({ consent_version: 'v3', consent_ts: ts }) de manera que qualsevol esdeveniment individual sigui rastreable fins a una entrada de registre de consentiment específica. Un desplegament correctament portat, combinat amb atributs de redacció que suprimeixen els camps sensibles per defecte i un camí d'eliminació que s'activa en la retirada, és el que converteix el model de captura automàtica de Heap d'un risc de concentració regulatoria en una de les parts més potents i defensables de la pila d'analítica de producte d'un editor.