Vodnik za integracijo soglasja za piškotke v analitiki izdelkov Heap Auto-Capture: Priročnik 2026 za založnike
Heap je nenavaden v ekosistemu analitike izdelkov zaradi tega, kar počne privzeto. Medtem ko Mixpanel, Amplitude in PostHog prosijo založnika, da instrumentira pomembne dogodke, Heap samodejno zajema vse in analitiku omogoča retroaktivno definiranje dogodkov iz zajetega toka. Ta model samodejnega zajemanja je opredelilna lastnost izdelka in razlog, zakaj ga ekipe izbirajo; prav tako je razlog, zakaj privzeta implementacija Heap nosi eno najširših površin vedenjskih podatkov med vsemi orodji, ki jih bo založnik verjetno namestil. Vsak klik, dotik, pomikanje, interakcija z obrazcem, prehod strani in klik iz frustracije se zajame glede na vztrajni identifikator v milisekundah po nalaganju strani — kar pomeni, da vsaka od teh operacij ustvari obveznost soglasja. Dobra novica je, da Heap od pridobitve s strani Contentsquare prinaša enega podrobnejših API-jev soglasja v prostoru analitike izdelkov; delo je v dejanski pravilni povezavi čez površino samodejnega zajemanja, plast identitete in modul ponovnega predvajanja seje, ki ga doda integracija Contentsquare.
Zakaj Heap zahteva soglasje — in zakaj je odgovor širši kot pri tipični analitiki
Privzeta inicializacija Heap pri prvem prikazu strani naredi več stvari. Nastavi piškotek prve strani pod _hp2_id.{envId}, ki vsebuje vztrajni identifikator uporabnika, piškotek seje pod _hp2_ses_id.{envId} z identifikatorjem seje, piškotek stopnje vzorčenja pod _hp2_props.{envId} in oznako _hp2_loaded, ki nakazuje, da je bil SDK inicializiran. Ustvari edinstveni identifikator, če še ne obstaja, zajame začetni ogled strani z napotiteljem, parametri UTM in identifikatorji klikov ter takoj začne beležiti vsako naslednjo interakcijo glede na ta identifikator — klike, dotike, spremembe obrazca, spremembe poti, prilagojene dogodke in, ko je integracija Contentsquare omogočena, celotno razliko izrisanega DOM za ponovno predvajanje seje.
Vsaka od teh dejavnosti sproži ločena vrata soglasja. Vztrajnost identifikatorja uporabnika je operacija shranjevanja in dostopa v skladu s členom 5(3) Direktive ePrivacy in zahteva predhodno, prostovoljno dano, specifično, informirano in nedvoumno soglasje po vsem EGP, Združenem kraljestvu in kateri koli jurisdikciji, ki je sprejela enak standard. Zajemanje toka dogodkov samodejnega zajemanja je obdelava osebnih podatkov v skladu z GDPR, ker kombinacija identifikatorja, naslova IP in vedenjske sledi zadostuje za posamičenje osebe. Ponovno predvajanje seje spada v ločeno, strožjo kategorijo v skladu z smernicami EDPB o ponovnem predvajanju sej — predvajanje zajame izrisani DOM in vsa nemaskirane vnosna polja ter zahteva izrecno, granularno soglasje, ki je ločeno od splošnega analitičnega soglasja. CCPA in CPRA enako obdelavo obravnavata kot prodajo ali skupno rabo, razen če ima založnik ustrezno pogodbo z Heap kot ponudnikom storitev — ki jo Heap ponuja, toda pogodba začne veljati šele, ko je integracija konfigurirana za način ponudnika storitev.
Kaj Heap zapiše pred soglasjem — in kaj je treba zatreti
Standardni hitri začetek, ki je priložen nadzorni plošči Heap, namesti sledilni odlomek neposredno v <head> strani. To deluje, kot je dokumentirano, in je vir najpogostejše napake pri skladnosti v implementacijah Heap: odlomek se zažene, preden se prikaže pasica za piškotke, piškotki _hp2_ se zapišejo v milisekundah in tok samodejnega zajemanja začne teči na heapanalytics.com ne glede na to, kaj se uporabnik pozneje odloči. Vsak evropski regulativni organ, ki se je izrekel o tem vzorcu, je odločil enako: piškotki, nastavljeni pred soglasjem, so nezakoniti, in založnik nosi odgovornost.
Skladna integracija mora zato preprečiti nalaganje odlomka Heap, dokler ustrezna kategorija soglasja ni bila odobrena. Dva vzorca, ki delujeta v produkciji, sta pogojna vbrizgavanja skripte — odlomek se doda DOM-u šele po tem, ko CMP signalizira soglasje — in predhodno nalaganje odlomka z heap.load(appId, { disableTextCapture: true, secureCookie: true, autocapture: false }) kot zakasneli zagonski program in nato klic heap.startAutoCapture() takoj ko je soglasje zabeleženo. Vzorec pogojnega vbrizgavanja je čistejši in tisti, ki ga dokumentacija Heap zdaj priporoča. Vzorec zakasnitvenega zagona je prava izbira, ko založnik potrebuje stabilno globalno referenco za spajanje identitete, vendar ne more dopustiti aktivacije samodejnega zajemanja pred soglasjem.
Piškotki in shranjevanje, ki jih zapiše Heap
Odlomek Heap pri inicializaciji zapiše naslednje identifikatorje, ki so vsi nebistveni in zahtevajo soglasje: _hp2_id.{envId} s 14-mesečnim rokom veljavnosti, ki vsebuje identifikator uporabnika, _hp2_ses_id.{envId} z 30-minutnim rokom veljavnosti seje, _hp2_props.{envId} za stopnjo vzorčenja in širjenje lastnosti, in _hp2_loaded kot oznaka nalaganja. Modul ponovnega predvajanja seje, integriran s Contentsquare, doda pomnilniški medpomnilnik za snemanje, ki se vsakih nekaj sekund sprazni v končno točko Heap in lahko ločeno ohrani majhen identifikator seje ponovnega predvajanja. Preklic soglasja mora zato tako potekati piškotke _hp2_ kakor signalizirati zahtevo za izbris prek API-ja GDPR Heap za prejšnje posnetke in tok dogodkov uporabnika.
Preslikava Heap na okvire soglasja
Heap izvorno ne implementira IAB TCF ali Globalne platforme zasebnosti IAB — je platforma za analitiko izdelkov prve strani, ne prodajalec oglaševalske tehnologije — toda integrira se z Google Consent Mode v2 prek premostitve na strani založnika, izpostavlja izvorno API za opt-in in opt-out ter podpira sloj za urejanje občutljivih lastnosti, ki deluje ne glede na stanje soglasja. Vzorec, ki preživi pregled regulativnega organa, vsak modul Heap obravnava kot ločena vrata, vezana na specifičen signal CMP.
- Samodejno zajemanje in tok osnovnih dogodkov sta vezana na analitični namen. V smislu TCF je to najpogosteje namen 8 (merjenje uspešnosti vsebine) v kombinaciji z namenom 1 (shranjevanje in/ali dostop do informacij). Za Consent Mode se to preslika na analytics_storage.
- Ponovno predvajanje seje prek integracije Contentsquare je za strožjimi, ločenimi vrati, ker predvajanje zajame izrisani DOM in vsa nemaskirane vnosna polja, smernice EDPB o ponovnem predvajanju sej pa to obravnavajo kot kategorijo, ki zahteva izrecno in granularno soglasje, ločeno od splošne analitike.
- Identifikacija uporabnika prek heap.identify() lahko deluje z efemirnim identifikatorjem seje na podlagi zakonitega interesa, ko je uporabnik anonimen, toda spajanje identifikacije s trajnim identifikatorjem prve strani med sejami zahteva enako soglasje kot analitika, ker takrat identifikator postane sledljiva podatkovna točka na ravni uporabnika.
- Širjenje identitete med spletnimi mesti ali med izdelki prek identity API zahteva marketinška vrata, ker presega mejo od analitike izdelkov do marketinškega pripisovanja na ravni uporabnika.
Vzorec integracije, ki deluje
Referenčna implementacija ima štiri dele: CMP, ki izpostavi dogodek spremembe soglasja v realnem času, zakasneli zagonski program, ki naloži Heap z onemogočenim samodejnim zajemanjem, poslušalec soglasja, ki vklopi samodejno zajemanje in zažene medpomnilnik ponovnega predvajanja seje, ko se odprejo ustrezna vrata, in pot preklica, ki pokliče heap.resetIdentity(), ustavi samodejno zajemanje, poteče piškotke _hp2_ in pošlje zahtevo za izbris prek končne točke GDPR Heap.
Spletna implementacija
Na spletu je najčistejši vzorec pogojno nalaganje odlomka Heap — oznaka <script> se vbrizga šele po odobritvi analitične kategorije. Naročite se na dogodek spremembe soglasja CMP. Ko analitična kategorija preide na true, vbrizgajte odlomek Heap z secureCookie: true, disableTextCapture: false za popolno samodejno zajemanje in kakršno koli konfiguracijo, specifično za okolje. Ko soglasje za ponovno predvajanje seje preide na true in je integracija Contentsquare omogočena, se medpomnilnik predvajanja aktivira samodejno. Ko se katera koli vrata umaknejo, pokličite heap.resetIdentity(), nato odstranite element skripte Heap, potecite piškotke _hp2_ prek document.cookie in prikličite API za izbris GDPR za identifikator uporabnika.
Urejanje občutljivih lastnosti
Heap prinaša plast za urejanje, ki deluje ne glede na stanje soglasja in ki bi jo morali založniki uporabljati tudi, ko je soglasje bilo dano. Atribut data-heap-redact-text na polju obrazca zatre zajet besedilni vsebino; atribut data-heap-redact-attributes zatre atribute elementa. Po pravilih GDPR o posebnih kategorijah in definiciji občutljivih osebnih podatkov CCPA mora vsako polje, ki bi lahko zajelo zdravstvene informacije, finančne podrobnosti, vladne identifikatorje, biometrične podatke, natančno geolokacijo ali vsebino zasebnih komunikacij, uporabljati atribute za urejanje ne glede na stanje soglasja uporabnika. Nastavitev atributov na ravni obrazca je najvarnejši vzorec — zatre celoten obrazec, tudi ko razvijalec doda novo polje, za katerega pozabi, da bi ga označil posamično.
Izbira regije: rezidenca podatkov v EU ali ZDA
Heap upravlja ločeni končni točki za vnos v EU in ZDA. Za promet iz EGP in Združenega kraljestva je končna točka EU privzeta prava vrednost; ohranja vnos, obdelavo in shranjevanje znotraj EGP ter zmanjšuje izpostavljenost Schrems II, ki jo nosi vsaka implementacija analitike v regiji ZDA. Končna točka se nastavi prek konfiguracije odlomka in je ni mogoče retroaktivno spremeniti — obstoječi podatki ostanejo tam, kjer so bili prvič vneseni. Za založnike, ki načrtujejo uvajanje Heap, se zato splača potrditi regijo pred povečanjem obsega in dokumentirati izbiro v obvestilu o zasebnosti, da bo veriga pravne podlage jasna od zbiranja do shranjevanja.
Validacija integracije in revizijske sledi
Korak validacije je tisto, kar preverijo regulativni organi in kar založniki najpogosteje preskočijo. Pravilno integrirana implementacija Heap mora zaporedoma opraviti štiri teste. Prvič, čista seja brskalnika s prikazano pasico, a brez opravljene izbire, mora ustvariti nič zahtevkov na heapanalytics.com razen pridobivanja datoteke SDK in nič piškotkov _hp2_ v document.cookie. Drugič, zavrnitev analitike mora ohraniti to stanje — brez samodejnega zajemanja, brez identifikatorja, brez snemanja. Tretjič, sprejetje analitike mora ustvariti pričakovani piškotek _hp2_id s pravilnimi atributi SameSite in prometom dogodkov, ki teče na konfigurirano regionalno končno točko. Četrtič, preklic soglasja mora takoj ustaviti nadaljnje samodejno zajemanje in predvajanje, potekati piškotke _hp2_ in sprožiti zahtevo za izbris prek API-ja GDPR Heap.
Pričakovanje revizijske sledi v skladu z smernicami EDPB iz leta 2023 o pasicah za piškotke in prenovljenimi prednostnimi nalogami delovne skupine 2026 je, da kan założnik dokaže za kateri koli dani dogodek v projektu Heap, da je uporabnik, ki ga je ustvaril, dal veljavno soglasje v trenutku zajemanja. Standardni vzorec je nastaviti različico soglasja in časovni žig kot lastnosti uporabnika na edinstvenem ID-ju prek heap.addUserProperties({ consent_version: 'v3', consent_ts: ts }), da je vsak posamezni dogodek sledljiv nazaj na specifičen vpis v dnevnik soglasja. Pravilno varovana implementacija, skupaj z atributi za urejanje, ki privzeto zatrejo občutljiva polja, in potjo izbrisa, ki se aktivira ob preklicu, je tisto, kar Heapov model samodejnega zajemanja pretvori iz regulativnega tveganja koncentracije v enega najmočnejših in najzagovarljivejših delov analitičnega sklada za izdelke založnika.