Veiledning for integrering av informasjonskapseltillatelse for Heap Auto-Capture produktanalyse: 2026-spilleboken for utgivere
Heap er uvanlig i produktanalytikkens økosystem på grunn av det den gjør som standard. Der Mixpanel, Amplitude og PostHog ber utgiveren om å instrumentere hendelsene som betyr noe, fanger Heap opp alt automatisk og lar analytikeren definere hendelser retroaktivt fra den fangede strømmen. Denne auto-capture-modellen er produktets definerende funksjon og grunnen til at team velger det; det er også grunnen til at en standard Heap-implementering har en av de bredeste atferdsdataoverflatene til noe verktøy en utgiver sannsynligvis vil installere. Hvert klikk, trykk, rull, skjemainteraksjon, sideovergang og rasende klikk fanges opp mot en vedvarende identifikator innen millisekunder etter sideinnlasting — noe som betyr at hver av disse operasjonene utløser en samtykkeforpliktelse. Den gode nyheten er at Heap, siden oppkjøpet av Contentsquare, leveres med et av de mer detaljerte samtykke-API-ene i produktanalytikkrommet; arbeidet ligger i å faktisk koble det riktig på tvers av auto-capture-overflaten, identitetslaget og sesjonsavspillingsmodulen som Contentsquare-integrasjonen legger til.
Hvorfor Heap krever samtykke — og hvorfor svaret er bredere enn typisk analyse
En standard Heap-initialisering gjør flere ting ved første sidevisning. Den setter en førstepartskapsel under _hp2_id.{envId} med den vedvarende brukeridentifikatoren, en sesjonskapsel under _hp2_ses_id.{envId} med sesjonsidentifikatoren, en utvalgsfrekvenskapsel under _hp2_props.{envId}, og en _hp2_loaded-markør som angir at SDK-en er initialisert. Den genererer den unike identifikatoren hvis en ikke allerede finnes, fanger opp den første sidevisningen med referent, UTM-parametere og klikkidentifikatorer, og begynner umiddelbart å registrere alle påfølgende interaksjoner mot denne identifikatoren — klikk, trykk, skjemaendringer, ruteendringer, tilpassede hendelser, og når Contentsquare-integrasjonen er aktivert, den fullstendige gjengitte DOM-diff for sesjonsavspilling.
Hver av disse aktivitetene utløser en separat samtykkeport. Vedvarende lagring av brukeridentifikatoren er en lagrings- og tilgangsoperasjon under Artikkel 5(3) i ePrivacy-direktivet og krever forutgående, frivillig gitt, spesifikt, informert og utvetydig samtykke i hele EØS, Storbritannia og enhver jurisdiksjon som har innført den samme standarden. Innhenting av auto-capture-hendelsesstrømmen er behandling av personopplysninger under GDPR fordi kombinasjonen av identifikator, IP-adresse og atferdsspor er tilstrekkelig til å identifisere et individ. Sesjonsavspilling befinner seg i en separat, strengere kategori under EDPBs veiledning om sesjonsavspilling — avspilling fanger opp gjengitt DOM og alle umaskerte inndatafelter og krever eksplisitt, detaljert samtykke som skiller seg fra generisk analysesamtykke. CCPA og CPRA behandler den samme behandlingen som salg eller deling med mindre utgiveren har den relevante tjenesteleverandøravtalen med Heap — som Heap tilbyr, men kontrakten trer bare i kraft når integrasjonen er konfigurert for tjenesteleverandørmodus.
Hva Heap skriver før samtykke — og hva som må undertrykkes
Standard hurtigstart som leveres med Heap-dashbordet, installerer sporingsfragmentet direkte i sidens <head>. Det fungerer som dokumentert og er kilden til den vanligste samsvarsfeilgrep på Heap-implementeringer: fragmentet kjøres før informasjonskapselbanneret er gjengitt, _hp2_-informasjonskapslene skrives innen millisekunder, og auto-capture-strømmen begynner å flyte til heapanalytics.com uavhengig av hva brukeren senere bestemmer. Enhver europeisk tilsynsmyndighet som har avgjort dette mønsteret, har avgjort på samme måte: informasjonskapsler som er satt før samtykke, er ulovlige, og utgiveren har ansvaret.
En samsvarende integrasjon må derfor hindre at Heap-fragmentet lastes inn til den relevante samtykkekategorien er gitt. De to mønstrene som fungerer i produksjon er betinget skriptinjeksjon — fragmentet legges bare til DOM etter at CMP signaliserer samtykke — og forhåndslasting av fragmentet med heap.load(appId, { disableTextCapture: true, secureCookie: true, autocapture: false }) som en utsatt bootstrap og deretter kalle heap.startAutoCapture() når samtykke er registrert. Mønsteret med betinget injeksjon er renere og det Heap-dokumentasjonen nå anbefaler. Mønsteret med utsatt bootstrap er det riktige valget når utgiveren trenger en stabil global referanse for identitetssammenkobling, men ikke kan la auto-capture aktiveres før samtykke.
Informasjonskapsler og lagring som Heap skriver
Heap-fragmentet skriver følgende identifikatorer ved initialisering, alle av dem er ikke-essensielle og krever samtykke: _hp2_id.{envId} med en utløpstid på 14 måneder som inneholder brukeridentifikatoren, _hp2_ses_id.{envId} med en sesjonsutløpstid på 30 minutter, _hp2_props.{envId} for utvalgsfrekvens og egenskapsspredning, og _hp2_loaded som lastmarkøren. Contentsquare-integrert sesjonsavspillingsmodul legger til en opptaksbuffer i minnet som tømmes til Heap-endepunktet hvert par sekunder og kan bevare en liten avspillingssesjonsidentifikator separat. Tilbakekalling av samtykke må derfor både utløpe _hp2_-informasjonskapslene og signalisere en slettingsforespørsel via Heaps GDPR-API for brukerens tidligere opptak og hendelsesstrøm.
Tilordning av Heap til samtykkeverk
Heap implementerer ikke natively IAB TCF eller IAB Global Privacy Platform — det er en førstepartsplattform for produktanalyse, ikke en annonsetech-leverandør — men det integreres med Google Consent Mode v2 gjennom utgiverens sidebru, eksponerer et innebygd opt-in og opt-out API, og støtter et sensitive-egenskap redaksjonslag som opererer uavhengig av samtykkestatus. Mønsteret som overlever en tilsynsmyndighets gjennomgang, behandler hvert Heap-modul som en separat port bundet til et spesifikt CMP-signal.
- Auto-capture og kjernehendelsesstrøm er bundet til analyseformålet. I TCF-termer er dette oftest formål 8 (måle innholdsytelse) kombinert med formål 1 (lagre og/eller få tilgang til informasjon). For Consent Mode tilordnes dette til analytics_storage.
- Sesjonsavspilling via Contentsquare-integrasjonen befinner seg bak en strengere, separat port fordi avspilling fanger opp gjengitt DOM og alle umaskerte inndatafelter, og EDPBs veiledning om sesjonsavspilling behandler det som en kategori som krever eksplisitt og detaljert samtykke som skiller seg fra generisk analyse.
- Brukeridentifikasjon via heap.identify() kan kjøres med en midlertidig sesjonsidentifikator på grunnlag av berettiget interesse når brukeren er anonym, men å sy identifikasjon til en vedvarende førstepartsidentifikator på tvers av sesjoner krever det samme samtykket som analyse fordi det er da identifikatoren blir et sporbart brukervisningsdatapunkt.
- Kryssstedet eller kryssprodukts identitetsspredning via identitets-API-en krever markedsføringsporten fordi den krysser linjen fra produktanalyse til markedsattribusjon på brukernivå.
Integrasjonsmønsteret som fungerer
Referanseimplementeringen har fire deler: et CMP som eksponerer en sanntids samtykkeendringshendelse, en utsatt bootstrap som laster Heap med auto-capture deaktivert, en samtykkelytter som slår på auto-capture og starter sesjonsavspillingsbufferen når de relevante portene åpner, og en tilbakekallingsbane som kaller heap.resetIdentity(), stopper auto-capture, utløper _hp2_-informasjonskapslene og sender en slettingsforespørsel via Heaps GDPR-endepunkt.
Web-implementering
På nettet er det reneste mønsteret å laste Heap-fragmentet betinget — <script>-taggen injiseres kun etter at analysekategorien er gitt. Abonner på CMP-ets samtykkeendringshendelse. Når analysekategorien går over til true, injiser Heap-fragmentet med secureCookie: true, disableTextCapture: false for full auto-capture og eventuell miljøspesifikk konfigurasjon. Når sesjonsavspillingssamtykket går over til true og Contentsquare-integrasjonen er aktivert, aktiveres avspillingsbufferen automatisk. Når en port trekkes tilbake, kall heap.resetIdentity() etterfulgt av fjerning av Heap-skriptelementet, utløp _hp2_-informasjonskapslene via document.cookie, og påkall GDPR-slettings-API-en for brukerens identifikator.
Redigering av sensitive egenskaper
Heap leveres med et redaksjonslag som opererer uavhengig av samtykkestatus og som utgivere bør bruke selv når samtykke er gitt. Attributtet data-heap-redact-text på et skjemafelt undertrykker det fangede tekstinnholdet; attributtet data-heap-redact-attributes undertrykker elementattributtene. Under GDPRs regler for spesielle kategorier og CCPAs definisjon av sensitiv personlig informasjon, må ethvert felt som kan fange helseinformasjon, finansielle detaljer, offentlige identifikatorer, biometriske data, presis geolokasjon eller innhold i private kommunikasjoner bruke redaksjonsattributtene uavhengig av brukerens samtykkestatus. Å sette attributtene på skjemanivå er det sikreste mønsteret — det undertrykker hele skjemaet selv når en utvikler legger til et nytt felt de glemmer å merke individuelt.
Regionvalg: EU versus USA-dataopphold
Heap opererer separate EU- og USA-innsamlingsendepunkter. For EØS- og Storbritannia-trafikk er EU-endepunktet riktig standard; det holder innsamling, behandling og lagring innenfor EØS og reduserer Schrems II-eksponeringen som enhver USA-regionanalyseimplementering bærer. Endepunktet settes via fragmentkonfigurasjonen og kan ikke endres retroaktivt — eksisterende data forblir der den ble første gang samlet inn. For utgivere som planlegger en Heap-utrulling, er det derfor verdt å bekrefte regionen før skalering, og verdt å dokumentere valget i personvernmerkingen slik at den rettslige begrunnelseskjeden er ren fra innsamling til lagring.
Validering av integrasjonen og revisjonssporet
Valideringstrinnet er det tilsynsmyndigheter sjekker og det utgivere oftest hopper over. En korrekt integrert Heap-implementering må bestå fire tester i sekvens. Først må en ren nettleserøkt med banneret vist men ingen valgt, produsere null forespørsler til heapanalytics.com utover SDK-filhenting og null _hp2_-informasjonskapsler i document.cookie. For det andre må avvisning av analyse opprettholde den tilstanden — ingen auto-capture, ingen identifikator, ingen opptak. For det tredje må aksept av analyse produsere den forventede _hp2_id-informasjonskapselen med riktige SameSite-attributter og hendelsestrafik som flyter til det konfigurerte regionsendepunktet. For det fjerde må tilbakekalling av samtykke umiddelbart stoppe videre auto-capture og avspilling, utløpe _hp2_-informasjonskapslene og utløse en slettingsforespørsel via Heaps GDPR-API.
Revisjonssporforventningen under EDPBs retningslinjer for informasjonskapselbanner fra 2023 og de fornyet prioriteringene til 2026-arbeidsgruppen er at utgiveren kan bevise, for enhver gitt hendelse i Heap-prosjektet, at brukeren som genererte den hadde gitt gyldig samtykke på fangstidspunktet. Standardmønsteret er å sette samtykkeversjon og tidsstempel som brukeregenskaper på den unike ID-en via heap.addUserProperties({ consent_version: 'v3', consent_ts: ts }) slik at enhver individuell hendelse kan spores tilbake til en spesifikk samtykkloggoppføring. En korrekt sikret implementering, kombinert med redaksjonsattributter som undertrykker sensitive felter som standard og en slettingsbane som aktiveres ved tilbakekalling, er det som gjør Heaps auto-capture-modell fra en regulatorisk konsentrasjonsrisiko til en av de kraftigste og mest forsvarbare delene av en utgivers produktanalysestakk.