Heap Auto-Capture Produktanalyse Cookie-Samtykke Integrationsguide: 2026 Playbook for Udgivere
Heap er usædvanlig i produktanalysens økosystem på grund af hvad den gør som standard. Mens Mixpanel, Amplitude og PostHog beder udgiveren om at instrumentere de vigtige hændelser, fanger Heap alt automatisk og lader analytikeren definere hændelser bagudrettet fra den fangede strøm. Denne auto-capture-model er produktets definerende funktion og grunden til, at teams vælger den; det er også grunden til, at en standard Heap-implementering bærer en af de bredeste adfærdsdata-flader for ethvert værktøj, en udgiver sandsynligvis vil installere. Hvert klik, tryk, scroll, formularinteraktion, sidetransition og raserianfaldsklik fanges mod en vedvarende identifikator inden for millisekunder efter sideindlæsning — hvilket betyder, at hver af disse operationer udløser en samtykkeforpligtelse. Den gode nyhed er, at Heap siden sin erhvervelse af Contentsquare leveres med en af de mere granulære samtykke-API'er i produktanalysespakken; arbejdet er i faktisk at forbinde det korrekt på tværs af auto-capture-fladen, identitetslaget og session-replay-modulet, som Contentsquare-integrationen tilføjer.
Hvorfor Heap kræver samtykke — og hvorfor svaret er bredere end typisk analyse
En standard Heap-initialisering gør adskillige ting ved sidens første tegning. Den sætter en førstepartscookie under _hp2_id.{envId} indeholdende den vedvarende brugeridentifikator, en sessionscookie under _hp2_ses_id.{envId} med sessionsidentifikatoren, en stikprøvehastighedscookie under _hp2_props.{envId} og et _hp2_loaded-mærke, der angiver, at SDK'et er initialiseret. Den genererer den distinkte identifikator, hvis der ikke allerede er en, fanger det første sidevisning med referrer, UTM-parametre og klikidentifikatorer og begynder straks at registrere enhver efterfølgende interaktion mod den identifikator — klik, tryk, formularændringer, ruteskift, tilpassede hændelser og, når Contentsquare-integrationen er aktiveret, den fuldt renderede DOM-forskel til session replay.
Hver af disse aktiviteter udløser en separat samtykkeport. Persistering af brugeridentifikatoren er en lagrings- og adgangsoperation under Article 5(3) i ePrivacy-direktivet og kræver forudgående, frit givet, specifikt, informeret og utvetydigt samtykke på tværs af EEA, UK og enhver jurisdiktion, der har importeret den samme standard. Fangst af auto-capture-hændelsesstrømmen er behandling af personoplysninger under GDPR, fordi kombinationen af identifikator, IP-adresse og adfærdsspor er tilstrækkelig til at individualisere en person. Session replay falder i en separat, strengere kategori under EDPB's session-replay-vejledning — replay fanger det renderede DOM og enhver umaskeret inputfelt og kræver eksplicit, granulært samtykke, der adskiller sig fra generisk analysesamtykke. CCPA og CPRA behandler den samme behandling som et salg eller deling, medmindre udgiveren har den relevante serviceudbyderaftale med Heap — som Heap tilbyder, men aftalen træder kun i kraft, når integrationen er konfigureret til serviceudbyderindstilling.
Hvad Heap skriver før samtykke — og hvad der skal undertrykkes
Den standard hurtigstart, der leveres med Heap-dashboardet, installerer sporingsfragmentet direkte i sidens <head>. Det fungerer som dokumenteret og er kilden til den mest almindelige overholdelsesfejl ved Heap-implementeringer: fragmentet kører, før cookiebanneret er gengivet, _hp2_-cookies skrives inden for millisekunder, og auto-capture-strømmen begynder at flyde til heapanalytics.com uanset hvad brugeren senere beslutter. Enhver europæisk tilsynsmyndighed, der har truffet afgørelse om dette mønster, har truffet den samme afgørelse: cookies sat inden samtykke er ulovlige, og udgiveren bærer ansvaret.
En compliant integration skal derfor forhindre Heap-fragmentet i at indlæse, indtil den relevante samtykkekategori er blevet givet. De to mønstre, der fungerer i produktion, er betinget scriptinjektion — fragmentet tilføjes til DOM kun efter at CMP'en signalerer samtykke — og forudindlæsning af fragmentet med heap.load(appId, { disableTextCapture: true, secureCookie: true, autocapture: false }) som en udskudt bootstrap og derefter kalde heap.startAutoCapture(), når samtykke er registreret. Betinget injektionsmønsteret er renere og det mønster, Heap-dokumentationen nu anbefaler. Det udskudte bootstrap-mønster er det rigtige valg, når udgiveren har brug for en stabil global reference til identitetssammensyning, men ikke kan tillade, at auto-capture starter inden samtykke.
De cookies og lagring, som Heap skriver
Heap-fragmentet skriver følgende identifikatorer ved initialisering, som alle er ikke-essentielle og kræver samtykke: _hp2_id.{envId} med en 14-måneders udløb indeholdende brugeridentifikatoren, _hp2_ses_id.{envId} med en 30-minutters sessionudløb, _hp2_props.{envId} til stikprøvehastighed og egenskabsudbredelse og _hp2_loaded som belastningsmærket. Det Contentsquare-integrerede session replay-modul tilføjer en in-memory-optagelsesbuffer, der tømmes til Heap-endpointet hvert par sekunder, og kan separat persistere et lille replay-sessionsidentifikator. Tilbagekaldelse af samtykke skal derfor både udløbe _hp2_-cookies og signalere en sletningsanmodning via Heaps GDPR API for brugerens tidligere optagelser og hændelsesstrøm.
Kortlægning af Heap til samtykkerelaterede rammer
Heap implementerer ikke IAB TCF eller IAB Global Privacy Platform naturligt — det er en førstepartsplatform til produktanalyse, ikke en reklameteknologileverandør — men det integreres med Google Consent Mode v2 via udgiveres bridging, eksponerer en native opt-in og opt-out API og understøtter et følsomt ejendomsredigeringslag, der fungerer uanset samtykkestatus. Det mønster, der overlever en tilsynsmyndigheds gennemgang, behandler hvert Heap-modul som en separat port bundet til et specifikt CMP-signal.
- Auto-capture og kernehændelsesstrøm er bundet til analyseformålet. I TCF-termer er dette oftest formål 8 (måle indholdsydelse) kombineret med formål 1 (lagre og/eller tilgå information). For Consent Mode svarer dette til analytics_storage.
- Session replay via Contentsquare-integrationen sidder bag en strengere, separat port, fordi replay fanger det renderede DOM og enhver umaskeret inputfelt, og EDPB's session-replay-vejledning behandler det som en kategori, der kræver eksplicit og granulært samtykke, der adskiller sig fra generisk analyse.
- Brugeridentifikation via heap.identify() kan køre med en flygtig sessionsidentifikator under en legitim interessebasis, når brugeren er anonym, men at sammensye identifikation til en vedvarende førstepartsidentifikator på tværs af sessioner kræver det samme samtykke som analyse, fordi det er da identifikatoren bliver et sporbart datapunkt på brugerniveau.
- Identitetsudbredelse på tværs af websteder eller produkter via identitets-API'en kræver marketingporten, fordi det krydser grænsen fra produktanalyse til bruger-niveau markedsføringsattribution.
Det integrationsmønster, der virker
Referencenimplementeringen har fire dele: en CMP, der eksponerer en realtids samtykkeskiftshændelse, en udskudt bootstrap, der indlæser Heap med deaktiveret auto-capture, en samtykkelytter, der aktiverer auto-capture og starter session replay-bufferen, når de relevante porte åbnes, og en tilbagetrækningssti, der kalder heap.resetIdentity(), stopper auto-capture, udløber _hp2_-cookies og afsender en sletningsanmodning via Heaps GDPR-endpoint.
Webimplementering
På nettet er det reneste mønster at indlæse Heap-fragmentet betinget — <script>-tagget injiceres kun efter at analytikkategorien er blevet givet. Abonner på CMP'ens samtykkeskiftshændelse. Når analytikkategorien skifter til sand, injicér Heap-fragmentet med secureCookie: true, disableTextCapture: false for fuld auto-capture og enhver miljøspecifik konfiguration. Når session replay-samtykke skifter til sand og Contentsquare-integrationen er aktiveret, aktiveres replay-bufferen automatisk. Når en port tilbagetrækkes, kald heap.resetIdentity() efterfulgt af fjernelse af Heap-skriptelementet, udløb _hp2_-cookies via document.cookie og kald GDPR-deletion API for brugerens identifikator.
Redigering af følsomme egenskaber
Heap leveres med et redigeringslag, der fungerer uanset samtykkestatus, og som udgivere bør bruge, selv når samtykke er givet. Attributten data-heap-redact-text på et formularfelt undertrykker det fangede tekstindhold; attributten data-heap-redact-attributes undertrykker elementattributterne. Under GDPR's særkategori-regler og CCPA's definition af følsomme personoplysninger skal ethvert felt, der potentielt kan fange sundhedsoplysninger, finansielle detaljer, statsidentifikatorer, biometriske data, præcis geolokalisering eller indhold i private kommunikationer, bruge redigeringsattributterne uanset brugerens samtykkestatus. Indstilling af attributterne på formularniveau er det sikreste mønster — det undertrykker hele formularen, selv når en udvikler tilføjer et nyt felt, som de glemmer at markere individuelt.
Regionsvalg: EU vs. USA datapermanens
Heap driver separate EU- og USA-indtagsendpoints. For EEA- og UK-trafik er EU-endpointet den rette standard; det holder indtagning, behandling og lagring inden for EEA og reducerer den Schrems II-eksponering, som enhver USA-regions analyseimplementering bærer. Endpointet indstilles via fragmentkonfigurationen og kan ikke ændres bagudrettet — eksisterende data forbliver, hvor de først blev indtaget. For udgivere, der planlægger en Heap-udrulning, er det derfor værd at bekræfte regionen inden skalering og dokumentere valget i privatlivspolitikken, så den lovgivningsmæssige grundkæde er ren fra indsamling til lagring.
Validering af integrationen og revisionssporet
Valideringstrinnet er det, tilsynsmyndigheder kontrollerer, og det udgivere oftest springer over. En korrekt integreret Heap-implementering skal bestå fire tests i rækkefølge. Først skal en ren browsersession med banneret vist, men uden valg foretaget, producere nul anmodninger til heapanalytics.com ud over SDK-filhentningen og nul _hp2_-cookies i document.cookie. For det andet skal afvisning af analyse fastholde denne tilstand — ingen auto-capture, ingen identifikator, ingen optagelse. For det tredje skal accept af analyse producere den forventede _hp2_id-cookie med korrekte SameSite-attributter og hændelsestrafik, der flyder til den konfigurerede regionsendpoint. For det fjerde skal tilbagekaldelse af samtykke straks stoppe yderligere auto-capture og replay, udløbe _hp2_-cookies og udløse en sletningsanmodning via Heaps GDPR API.
Forventningen til revisionssporet under EDPB's 2023 cookiebanner-retningslinjer og de fornyede 2026 taskforce-prioriteter er, at udgiveren for enhver given hændelse i Heap-projektet kan bevise, at den bruger, der genererede den, havde givet gyldigt samtykke på tidspunktet for fangst. Standardmønsteret er at indstille samtykkeversioen og tidsstemplet som brugeregenskaber på det distinkte ID via heap.addUserProperties({ consent_version: 'v3', consent_ts: ts }), så enhver individuel hændelse kan spores tilbage til et specifikt samtykkelogindtastning. En korrekt gated implementering, kombineret med redigeringsattributter, der undertrykker følsomme felter som standard, og en slettesti, der aktiveres ved tilbagekaldelse, er det, der forvandler Heaps auto-capture-model fra en regulatorisk koncentrationsrisiko til en af de mest kraftfulde og forsvarlige dele af en udgivers produktanalysestak.