Leiðarvísir um samþykki fyrir vafrakökur í Heap Auto-Capture vörugreiningu: Handbók 2026 fyrir útgefendur
Heap er óvenjulegt í vistkerfi vörugreiningar vegna þess sem það gerir sjálfkrafa. Þar sem Mixpanel, Amplitude og PostHog biðja útgefanda um að tækjanýta þau tilvik sem skipta máli, fangar Heap allt sjálfkrafa og leyfir greinandanum að skilgreina tilvik afturvirkt úr þeirri straumi sem fangaður er. Þetta auto-capture líkan er sérkenni vörunnar og ástæðan fyrir því að lið velja hana; það er líka ástæðan fyrir því að sjálfgefin Heap-uppsetning ber eitt víðast hegðunargagnasviðs allra þeirra tækja sem útgefandi er líklegur til að setja upp. Hvert smellt, snertingu, flettingu, eyðublaðssamskipti, síðuflutning og reiðismellt er fangað gegn varanlegum auðkenni innan millisekúndna frá hleðslu síðunnar — sem þýðir að allar þessar aðgerðir leiða til samþyktisskyldu. Góðar fréttir eru þær að Heap, frá yfirtöku Contentsquare, kemur með eitt ítarlegasta samþykkis-API vörugreiningarsviðsins; verkið felst í því að tengja það rétt yfir auto-capture yfirborðið, auðkennislagið og lotuendurspilunareininguna sem Contentsquare-samþætting bætir við.
Af hverju Heap þarfnast samþykkis — og af hverju svarið er víðara en dæmigerð greining
Sjálfgefin Heap-frumstilling gerir margt við fyrstu mynd síðunnar. Hún setur fyrsta-aðila vafrakökur undir _hp2_id.{envId} sem inniheldur varanlegt notandaauðkenni, lotuköku undir _hp2_ses_id.{envId} með lotuauðkenni, sýnishlutfallsköku undir _hp2_props.{envId}, og _hp2_loaded merki sem gefur til kynna að SDK hafi frumstillt sig. Hún myndar aðskilið auðkenni ef eitt er ekki til staðar, fangar upphaflega síðuskoðun með tilvísunaraðila, UTM breytum og smellauðkennum, og byrjar strax að skrá allar síðari samskipti gegn því auðkenni — smelli, snertingar, eyðublaðsbreytingar, leiðarbreytingar, sérsniðin tilvik og, þegar Contentsquare-samþætting er virkjuð, alla gefsna DOM diff fyrir lotuendurspilun.
Hvert þessara athafna virkjar sérstakt samþykkisgátt. Að geyma notandaauðkennið er geymslu-og-aðgangur aðgerð undir 5(3). grein ePrivacy-tilskipunarinnar og krefst fyrirfram, frjálst gefnum, sértækum, upplýstum og skýrum samþykki í gegnum EEA, UK og öll lögsögu sem hafa tekið upp sama staðal. Að fanga auto-capture tilvikstraum er vinnsla persónulegra gagna undir GDPR vegna þess að samsetning auðkennisins, IP-tölu og hegðunarslóðar er nægjanleg til að einangra einstakling. Lotuendurspilun fellur í sérstakan, strangari flokk undir leiðbeiningar EDPB um lotuendurspilun — endurspilun fangar gefsna DOM og allar ómaðkaðar inntaksreitir og krefst skýrs, nákvæms samþykkis sem er aðskilið frá almennum greiningarsamþykki. CCPA og CPRA meðhöndla sömu vinnslu sem sölu eða deilingu nema útgefandinn hafi viðeigandi þjónustuveiturasamning við Heap — sem Heap býður upp á, en samningurinn tekur aðeins gildi þegar samþætting er stillt á þjónustuveitumáta.
Hvað Heap skrifar fyrir samþykki — og hvað þarf að bæla
Staðalflutningur sem fylgir Heap-stjórnborðinu setur rakningarbrotið beint inn í <head> síðunnar. Það virkar eins og skjalfest og er uppspretta algengasta samræmisvandans í Heap-uppsetningum: brotið keyrir áður en vafrakökuborðið hefur gengið, _hp2_ vafrakökurnar eru skrifaðar innan millisekúndna og auto-capture straumurinn byrjar að renna til heapanalytics.com óháð því hvað notandinn ákveður síðar. Sérhver evrópskur eftirlitsaðili sem hefur fjallað um þetta mynstur hefur niðurstaðan sömu: vafrakökur settar fyrir samþykki eru ólöglegar og útgefandinn ber ábyrgðina.
Samræmt samþætting verður því að koma í veg fyrir að Heap-brotið hleðst þangað til viðeigandi samþykkisflokkur hefur verið veittur. Tvær mynstrar sem virka í framleiðslu eru skilyrt skriftur-innjeksjón — brotið er bætt við DOM aðeins eftir að CMP gefur til kynna samþykki — og forhlöðun brotsins með heap.load(appId, { disableTextCapture: true, secureCookie: true, autocapture: false }) sem frestað ræsiforrit og síðan að kalla á heap.startAutoCapture() þegar samþykki er skráð. Skilyrta innjeksjónarmynstrið er hreinlegra og það sem Heap-skjölin mæla nú með. Frestaða ræsiforritsmynstrið er rétt val þegar útgefandinn þarf stöðuga altæka tilvísun fyrir auðkennissaumlagningu en getur ekki leyft auto-capture að kveikna fyrir samþykki.
Vafrakökurnar og geymslan sem Heap skrifar
Heap-brotið skrifar eftirfarandi auðkenni við frumstillingu, öll sem eru ekki nauðsynleg og þurfa samþykki: _hp2_id.{envId} með 14 mánaða gildistíma sem inniheldur notandaauðkenni, _hp2_ses_id.{envId} með 30 mínútna lotugildi, _hp2_props.{envId} fyrir sýnishlutfall og eigindadreifingu, og _hp2_loaded sem hleðslumerki. Contentsquare-samþætta lotuendurspilunareining bætir við minni-skráningarpuffer sem skolast til Heap-endapunkts á nokkurra sekúndna fresti og gæti geymt lítið lotuendurspilunarnauðkennni sérstaklega. Að afturkalla samþykki verður því bæði að gera _hp2_ vafrakökurnar útrunnar og senda eyðingarbeiðni í gegnum GDPR API Heap fyrir fyrri upptökur og tilvikstraum notandans.
Að kortleggja Heap á samþykkisramma
Heap innleiðir ekki innbyrðis IAB TCF eða IAB Global Privacy Platform — það er fyrsta-aðila vörugreiningarvettvangur, ekki auglýsingartæknibirgir — en samþættist Google Consent Mode v2 í gegnum tengingu á útgefendahlið, afhjúpar innbyggt opt-in og opt-out API, og styður næmt-eigind afmyndingarlag sem virkar óháð samþykkisástandi. Mynstrið sem lifir af yfirlit eftirlitsaðila meðhöndlar hverja Heap-einingu sem sérstaka gátt bundna við ákveðið CMP-merki.
- Auto-capture og kjarna-tilvikstraumur bindast við greiningartilgang. Í TCF-skilmálum er þetta oftast tilgangur 8 (mæla efnisframmistöðu) ásamt tilgangi 1 (geyma og/eða nálgast upplýsingar). Fyrir Consent Mode kortleggst þetta á analytics_storage.
- Lotuendurspilun í gegnum Contentsquare-samþætti er á bak við strangari, aðskilda gátt vegna þess að endurspilun fangar gefsna DOM og allar ómaðkaðar inntaksreitir, og leiðbeiningar EDPB um lotuendurspilun meðhöndlar hana sem flokk sem krefst skýrs og nákvæms samþykkis aðskilið frá almennum greiningum.
- Notandaauðkenning í gegnum heap.identify() getur keyrt með skammvinnur lotuauðkenni á grundvelli lögmætra hagsmuna þegar notandinn er nafnlaus, en að sauma auðkenningu við varanlegt fyrsta-aðila auðkenni þvert á lotur krefst sama samþykkis og greining vegna þess að það er þegar auðkennið verður rekjanlegt notandastigs gagnastig.
- Auðkennadreifing milli vefsvæða eða milli vara í gegnum auðkenni-API þarfnast markaðssetningargáttarinnar vegna þess að hún fer yfir línuna frá vörugreiningu yfir í notendastigsmarkaðssetningu.
Samþættiðarmynstrið sem virkar
Tilvísannaruppsetningin hefur fjóra hluta: CMP sem afhjúpar rauntímasamþykki-breytingartilvik, frestað ræsiforrit sem hleður Heap með auto-capture óvirkt, samþykkilystilir sem kveikir á auto-capture og ræsir lotuendurspilunarpuffer þegar viðeigandi gáttir opnast, og afturkallanarleið sem kallar á heap.resetIdentity(), stöðvar auto-capture, gerir _hp2_ vafrakökurnar útrunnar og sendir eyðingarbeiðni í gegnum GDPR-endapunkt Heap.
Vefinnleiðing
Á vefnum er hreinlegasta mynstrið að hlaða Heap-brotið skilyrt — <script> merkingin er aðeins innjekteret eftir að greiningaflokkurinn hefur verið veittur. Gerast áskrifandi að samþykki-breytingartilviki CMP. Þegar greiningaflokkurinn breytist í satt, injektaðu Heap-brotið með secureCookie: true, disableTextCapture: false fyrir fulla auto-capture, og hvaða umhverfistengda stillingu sem er. Þegar samþykki fyrir lotuendurspilun breytist í satt og Contentsquare-samþætting er virkjuð, virkjast endurspilunarpufferinn sjálfkrafa. Þegar annaðhvort gátt afturkallar, kallaðu á heap.resetIdentity() og fjarlægðu síðan Heap-skriftureininguna, gerðu _hp2_ vafrakökurnar útrunnar í gegnum document.cookie, og kallaðu á GDPR-eyðingar-API fyrir auðkenni notandans.
Afmynding næmra eiginda
Heap kemur með afmyndingarlag sem virkar óháð samþykkisástandi og sem útgefendur ættu að nota jafnvel þegar samþykki hefur verið veitt. data-heap-redact-text eigindin á inntaksreit bælir fangað textainnihald; data-heap-redact-attributes eigindin bælir einingaeigindir. Undir sértaka-flokksreglum GDPR og skilgreiningu CCPA á næmum persónulegum upplýsingum, verður sérhver reitur sem gæti fangað heilsufarsupplýsingar, fjárhagslegar upplýsingar, ríkisskyldur auðkennar, líffræðileg gögn, nákvæma landfræðilega staðsetningu eða efni einkasamskipta að nota afmyndunareigindir óháð samþykkisástandi notandans. Að stilla eigindirnar á eyðublaðsstigi er öruggasta mynstrið — það bælir allt eyðublaðið jafnvel þegar þróunarmaður bætir við nýjum reit sem hann gleymir að merkja sérstaklega.
Svæðisval: gagnabúseta EES vs. Bandaríkin
Heap rekur aðskildar EES og Bandaríkja inntöku-endapunkta. Fyrir EES og UK umferð er EES-endapunkturinn rétti sjálfgefni; hann heldur inntöku, vinnslu og geymslu innan EES og dregur úr Schrems II útsetningu sem sérhver bandarísk svæðis greiningaruppsetning ber. Endapunkturinn er stilltur í gegnum skilgreiningu brotsins og er ekki hægt að breyta afturvirkt — fyrirliggjandi gögn eru þar sem þau voru fyrst tekin inn. Útgefendur sem skipuleggja Heap-útfærslu ættu því að staðfesta svæðið áður en þeir skala upp, og skrá valið í persónuverndartilkynningu svo lögmætir-grunnar-keðjan sé hrein frá söfnun til geymslu.
Að staðfesta samþættiðina og endurskoðunarslóðina
Staðfestingarskrefið er það sem eftirlitsaðilar athuga og það sem útgefendur sleppa oftast. Rétt samþætt Heap-uppsetning verður að standast fjórar prófanir í röð. Í fyrsta lagi verður hreint vafralotur þar sem borðinn er sýndur en engin val gerð að framleiða núll beiðnir til heapanalytics.com umfram SDK-skráarsækju og núll _hp2_ vafrakökur í document.cookie. Í öðru lagi verður að hafna greiningu að halda þessu ástandi — ekkert auto-capture, ekkert auðkenni, engin skráning. Í þriðja lagi verður að samþykkja greiningu að framleiða væntanlega _hp2_id köku með réttum SameSite eigindum og tilvikaumferð sem rennur á stilltan svæðisendapunkt. Í fjórða lagi verður afturköllun samþykkis að stöðva strax frekari auto-capture og endurspilun, gera _hp2_ vafrakökurnar útrunnar og kveikja á eyðingarbeiðni í gegnum GDPR API Heap.
Endurskoðunarslóðarvæntingin undir vafrakökuborðaleiðbeiningum EDPB frá 2023 og endurnýjuðum 2026 verkefnishópsforgang er að útgefandinn geti sannað, fyrir hvaða tiltekið tilvik sem er í Heap-verkefninu, að notandinn sem bjó til það hafi gefið gilt samþykki á þeim tíma sem fangað var. Staðalmynstrið er að stilla samþykkisútgáfu og tímastimpil sem notandaeigindir á aðskilið auðkenni í gegnum heap.addUserProperties({ consent_version: 'v3', consent_ts: ts }) þannig að sérhvert einstakt tilvik sé rekjanlegt aftur til tiltekins samþykkisskráafærslu. Rétt gáttuð uppsetning, pöruð með afmyndunareigindum sem bæla næmar reitir sjálfkrafa og eyðingarleiðar sem virkjast við afturköllun, er það sem breytir auto-capture líkani Heap frá reglugerðarþéttingaráhættu í einn öflugasta og varnarlegasta hluta vörugreiningarkerfis útgefanda.