Guía de integración do consentimento de cookies para a analítica de produto Heap Auto-Capture: Manual 2026 para editores
Heap é inusual no ecosistema de analítica de produto polo que fai por defecto. Mentres Mixpanel, Amplitude e PostHog piden ao editor que instrumente os eventos importantes, Heap captura todo automaticamente e permite ao analista definir eventos de forma retroactiva desde o fluxo capturado. Este modelo de auto-capture é a característica definitoria do produto e a razón pola que os equipos o elixen; é tamén a razón pola que un despregamento de Heap por defecto leva unha das superficies de datos de comportamento máis amplas de calquera ferramenta que un editor é probable que instale. Cada clic, toque, desprazamento, interacción con formularios, transición de páxina e clic furioso captúrase contra un identificador persistente en milisegundos da carga da páxina — o que significa que cada unha desas operacións implica unha obrigación de consentimento. A boa nova é que Heap, desde a súa adquisición por Contentsquare, envía agora unha das API de consentimento máis granulares do espazo de analítica de produto; o traballo consiste en conectala correctamente a través da superficie de auto-capture, a capa de identidade e o módulo de reprodución de sesión que engade a integración de Contentsquare.
Por que Heap require consentimento — e por que a resposta é máis ampla que a analítica típica
Unha inicialización de Heap por defecto fai varias cousas na primeira pintura da páxina. Establece unha cookie de primeira parte baixo _hp2_id.{envId} que contén o identificador de usuario persistente, unha cookie de sesión baixo _hp2_ses_id.{envId} co identificador de sesión, unha cookie de taxa de mostra baixo _hp2_props.{envId}, e un marcador _hp2_loaded que indica que o SDK se inicializou. Xera o identificador distinto se aínda non existe, captura a vista de páxina inicial co referente, os parámetros UTM e os identificadores de clic, e comeza inmediatamente a rexistrar cada interacción posterior contra ese identificador — clics, toques, cambios de formulario, cambios de ruta, eventos personalizados e, cando a integración de Contentsquare está activada, o diff de DOM renderizado completo para a reprodución de sesión.
Cada unha desas actividades activa unha porta de consentimento separada. A persistencia do identificador de usuario é unha operación de almacenamento e acceso baixo o artigo 5(3) da Directiva ePrivacy e require consentimento previo, libremente dado, específico, informado e sen ambigüidades en todo o EEA, o Reino Unido e calquera xurisdición que adoptase o mesmo estándar. Capturar o fluxo de eventos de auto-capture é un tratamento de datos persoais baixo o GDPR porque a combinación de identificador, enderezo IP e rastro de comportamento é suficiente para individualizar a unha persoa. A reprodución de sesión atópase nunha categoría separada e máis estrita segundo a orientación de reprodución de sesión do EDPB — a reprodución captura o DOM renderizado e calquera campo de entrada sen máscara e require consentimento explícito e granular que é distinto do consentimento analítico xenérico. O CCPA e o CPRA tratan o mesmo procesamento como unha venda ou compartición a menos que o editor teña o contrato de provedor de servizos relevante con Heap — que Heap ofrece, pero o contrato só entra en vigor cando a integración está configurada para o modo de provedor de servizos.
O que Heap escribe antes do consentimento — e o que debe suprimirse
O inicio rápido estándar que se envía co panel de Heap instala o fragmento de seguimento directamente no <head> da páxina. Iso funciona como está documentado e é a orixe do fallo de cumprimento máis común nos despregamentos de Heap: o fragmento execútase antes de que se renderice o banner de cookies, as cookies _hp2_ escríbense en milisegundos, e o fluxo de auto-capture comeza a fluír cara a heapanalytics.com independentemente do que o usuario decida máis tarde. Cada regulador europeo que se pronunciou sobre este patrón fíxoo do mesmo xeito: as cookies establecidas antes do consentimento son ilícitas, e o editor leva a responsabilidade.
Unha integración conforme debe polo tanto impedir que o fragmento de Heap se cargue ata que se outorgue a categoría de consentimento relevante. Os dous patróns que funcionan en produción son a inxección condicional de scripts — o fragmento engádese ao DOM só despois de que a CMP sinalice o consentimento — e a precarga do fragmento con heap.load(appId, { disableTextCapture: true, secureCookie: true, autocapture: false }) como bootstrap diferido e logo chamando a heap.startAutoCapture() unha vez rexistrado o consentimento. O patrón de inxección condicional é máis limpo e o que a documentación de Heap recomenda agora. O patrón de bootstrap diferido é a opción correcta cando o editor necesita unha referencia global estable para o cosido de identidade pero non pode permitir que o auto-capture se active antes do consentimento.
As cookies e o almacenamento que Heap escribe
O fragmento de Heap escribe os seguintes identificadores na inicialización, todos non esenciais e que requiren consentimento: _hp2_id.{envId} cunha caducidade de 14 meses que contén o identificador de usuario, _hp2_ses_id.{envId} cunha caducidade de sesión de 30 minutos, _hp2_props.{envId} para a propagación da taxa de mostra e propiedades, e _hp2_loaded como marcador de carga. O módulo de reprodución de sesión integrado con Contentsquare engade un búfer de gravación en memoria que descarga no endpoint de Heap cada poucos segundos e pode conservar por separado un pequeno identificador de sesión de reprodución. A retirada do consentimento debe polo tanto caducar as cookies _hp2_ e sinalizar unha solicitude de eliminación a través da API GDPR de Heap para as gravacións e o fluxo de eventos anteriores do usuario.
Mapear Heap con marcos de consentimento
Heap non implementa de forma nativa o IAB TCF nin a Plataforma de Privacidade Global de IAB — é unha plataforma de analítica de produto de primeira parte, non un provedor de adtech — pero intégrase con Google Consent Mode v2 a través da ponte do lado do editor, expón unha API nativa de opt-in e opt-out, e soporta unha capa de redacción de propiedades sensibles que opera independentemente do estado do consentimento. O patrón que supera a revisión dun regulador trata cada módulo de Heap como unha porta separada ligada a un sinal específico da CMP.
- O auto-capture e o fluxo de eventos principal están ligados ao propósito analítico. En termos TCF, isto é máis comunmente o propósito 8 (medir o rendemento do contido) combinado co propósito 1 (almacenar e/ou acceder a información). Para Consent Mode, isto mapéase a analytics_storage.
- A reprodución de sesión a través da integración de Contentsquare sitúase detrás dunha porta máis estrita e separada porque a reprodución captura o DOM renderizado e calquera campo de entrada sen máscara, e a orientación de reprodución de sesión do EDPB trátaa como unha categoría que require consentimento explícito e granular distinto da analítica xenérica.
- A identificación de usuario a través de heap.identify() pode executarse cun identificador de sesión efémero baixo unha base de interese lexítimo cando o usuario é anónimo, pero o cosido da identificación a un identificador de primeira parte persistente entre sesións require o mesmo consentimento que a analítica porque é cando o identificador se converte nun punto de datos rastrexable a nivel de usuario.
- A propagación de identidade entre sitios ou produtos a través da API de identidade require a porta de mercadotecnia porque cruza a liña da analítica de produto á atribución de mercadotecnia a nivel de usuario.
O patrón de integración que funciona
O despregamento de referencia ten catro partes: unha CMP que expón un evento de cambio de consentimento en tempo real, un bootstrap diferido que carga Heap con auto-capture desactivado, un oyente de consentimento que activa o auto-capture e inicia o búfer de reprodución de sesión cando se abren as portas relevantes, e un camiño de retirada que chama a heap.resetIdentity(), detén o auto-capture, caduca as cookies _hp2_, e envía unha solicitude de eliminación a través do endpoint GDPR de Heap.
Implementación web
Na web, o patrón máis limpo é cargar o fragmento de Heap de forma condicional — a etiqueta <script> inxéctase só despois de que se outorgue a categoría analítica. Subscríbete ao evento de cambio de consentimento da CMP. Cando a categoría analítica cambia a verdadeiro, inxecta o fragmento de Heap con secureCookie: true, disableTextCapture: false para o auto-capture completo, e calquera configuración específica do entorno. Cando o consentimento de reprodución de sesión cambia a verdadeiro e a integración de Contentsquare está activada, o búfer de reprodución actívase automaticamente. Cando se retira calquera porta, chama a heap.resetIdentity() seguido da eliminación do elemento de script de Heap, caduca as cookies _hp2_ a través de document.cookie, e invoca a API de eliminación GDPR para o identificador do usuario.
Redacción de propiedades sensibles
Heap envía con unha capa de redacción que opera independentemente do estado do consentimento e que os editores deben usar mesmo cando se outorgou o consentimento. O atributo data-heap-redact-text nun campo de formulario suprime o contido de texto capturado; o atributo data-heap-redact-attributes suprime os atributos do elemento. Baixo as regras de categoría especial do GDPR e a definición de información persoal sensible do CCPA, calquera campo que poida capturar información sanitaria, detalles financeiros, identificadores gobernamentais, datos biométricos, xeolocalización precisa ou contidos de comunicacións privadas debe usar os atributos de redacción independentemente do estado de consentimento do usuario. Establecer os atributos no nivel do formulario é o patrón máis seguro — suprime todo o formulario mesmo cando un programador engade un novo campo que esquece marcar individualmente.
Selección de rexión: residencia de datos UE fronte a EE.UU.
Heap opera endpoints de inxestión separados para a UE e os EE.UU. Para o tráfico do EEA e do Reino Unido, o endpoint da UE é o valor predeterminado correcto; mantén a inxestión, o procesamento e o almacenamento dentro do EEA e reduce a exposición de Schrems II que leva calquera despregamento de analítica na rexión dos EE.UU. O endpoint establécese a través da configuración do fragmento e non se pode cambiar de forma retroactiva — os datos existentes quedan onde foron inxeridos por primeira vez. Para os editores que planifican un despregamento de Heap, paga a pena confirmar a rexión antes de escalar e documentar a elección no aviso de privacidade para que a cadea de base xurídica sexa clara desde a recollida ata o almacenamento.
Validación da integración e o rastro de auditoría
O paso de validación é o que os reguladores comproba e o que os editores máis frecuentemente omiten. Un despregamento de Heap correctamente integrado debe superar catro probas en secuencia. En primeiro lugar, unha sesión de navegador limpa co banner mostrado pero sen ningunha elección realizada debe producir cero solicitudes a heapanalytics.com máis aló da obtención do ficheiro SDK e cero cookies _hp2_ en document.cookie. En segundo lugar, rexeitar a analítica debe manter ese estado — sen auto-capture, sen identificador, sen gravación. En terceiro lugar, aceptar a analítica debe producir a cookie _hp2_id esperada con atributos SameSite correctos e tráfico de eventos que flúe cara ao endpoint da rexión configurada. En cuarto lugar, a retirada do consentimento debe deter inmediatamente o auto-capture e a reprodución ulteriores, caducar as cookies _hp2_, e desencadear unha solicitude de eliminación a través da API GDPR de Heap.
A expectativa do rastro de auditoría segundo as directrices de banner de cookies de 2023 do EDPB e as renovadas prioridades do grupo de traballo de 2026 é que o editor poida demostrar, para calquera evento dado no proxecto Heap, que o usuario que o xerou proporcionara un consentimento válido no momento da captura. O patrón estándar é establecer a versión do consentimento e a marca de tempo como propiedades de usuario no ID distinto a través de heap.addUserProperties({ consent_version: 'v3', consent_ts: ts }) para que calquera evento individual sexa rastrexable de volta a unha entrada específica do rexistro de consentimento. Un despregamento correctamente portado, combinado con atributos de redacción que suprimen por defecto os campos sensibles e un camiño de eliminación que se activa ao retirar o consentimento, é o que converte o modelo de auto-capture de Heap dun risco de concentración regulatoria nunha das partes máis potentes e defendibles da pila de analítica de produto dun editor.