Водич за интеграцију сагласности за колачиће аналитике производа Heap Auto-Capture: Приручник 2026 за издаваче
Heap је необичан у екосистему аналитике производа због онога што ради подразумевано. Тамо где Mixpanel, Amplitude и PostHog траже од издавача да инструментише догађаје који су важни, Heap аутоматски снима све и омогућава аналитичару да ретроактивно дефинише догађаје из снимљеног тока. Тај модел аутоматског снимања је дефинишућа карактеристика производа и разлог зашто га тимови бирају; то је такође разлог зашто подразумевани Heap deployment носи један од најширих бихевиоралних података у свим алаткама које издавач вероватно инсталира. Сваки клик, додир, скроловање, интеракција са формуларом, прелаз странице и бесни клик снима се против постојаног идентификатора у милисекундама учитавања странице — што значи да свака та операција покреће обавезу сагласности. Добра вест је да Heap, од када га је преузео Contentsquare, долази са једним од детаљнијих API-јева сагласности у простору аналитике производа; посао је у правилном повезивању кроз површину аутоматског снимања, слој идентитета и модул снимка сесије које Contentsquare интеграција додаје.
Зашто Heap захтева сагласност — и зашто је одговор шири од типичне аналитике
Подразумевана иницијализација Heap-а ради неколико ствари у првом рендеровању странице. Поставља колачић прве стране под _hp2_id.{envId} који садржи постојани идентификатор корисника, колачић сесије под _hp2_ses_id.{envId} са идентификатором сесије, колачић стопе узорка под _hp2_props.{envId}, и маркер _hp2_loaded који означава да је SDK иницијализован. Генерише препознатљиви идентификатор ако он не постоји, снима почетни приказ странице са упућивачем, UTM параметрима и идентификаторима кликова, и одмах почиње да снима сваку наредну интеракцију против тог идентификатора — кликове, додире, промене формулара, промене руте, прилагођене догађаје и, када је Contentsquare интеграција омогућена, пуну рендерну разлику DOM-а за снимак сесије.
Свака од тих активности покреће одвојену капију сагласности. Чување идентификатора корисника је операција складиштења и приступа под Чланом 5(3) еPrivacy Директиве и захтева претходну, слободно дату, специфичну, информисану и недвосмислену сагласност широм EEA, UK и свих јурисдикција које су увезле исти стандард. Снимање тока аутоматски снимљених догађаја је обрада личних података под GDPR јер је комбинација идентификатора, IP адресе и бихевиоралног трага довољна да издвоји особу. Снимак сесије спада у посебну, строжу категорију под смерницама EDPB-а о снимку сесије — снимак бележи рендерни DOM и свако немаскирано поље уноса и захтева изричиту, детаљну сагласност која се разликује од опште аналитичке сагласности. CCPA и CPRA третирају исту обраду као продају или дељење осим ако издавач нема одговарајући уговор са пружаоцем услуга са Heap-ом — које Heap нуди, али уговор ступа на снагу само када је интеграција конфигурисана за режим пружаоца услуга.
Шта Heap пише пре сагласности — и шта мора бити потиснуто
Стандардни брзи почетак испоручен са Heap контролном таблом инсталира праћење фрагмента директно у <head> странице. То ради како је документовано и извор је најчешћег кршења усаглашености у Heap deployment-овима: фрагмент се покреће пре него што се банер са колачићима прикаже, колачићи _hp2_ се уписују у милисекундама, а ток аутоматског снимања почиње да тече ка heapanalytics.com без обзира на оно што корисник касније одлучи. Сваки европски регулатор који је одлучио о овом обрасцу одлучио је на исти начин: колачићи постављени пре сагласности су незаконити, а издавач сноси одговорност.
Стога, усаглашена интеграција мора спречити учитавање Heap фрагмента до добијања одговарајуће категорије сагласности. Два обрасца која раде у производњи су условна ињекција скрипте — фрагмент се додаје у DOM само пошто CMP сигнализује сагласност — и претходно учитавање фрагмента са heap.load(appId, { disableTextCapture: true, secureCookie: true, autocapture: false }) као одложеним покретачем, а затим позивање heap.startAutoCapture() када је сагласност забележена. Образац условне ињекције је чистији и онај који документација Heap-а сада препоручује. Образац одложеног покретача је прави избор када издавач треба стабилну глобалну референцу за спајање идентитета, али не може дозволити аутоматско снимање пре сагласности.
Колачићи и складиштење које Heap уписује
Heap фрагмент уписује следеће идентификаторе при иницијализацији, сви су небитни и захтевају сагласност: _hp2_id.{envId} са истеком од 14 месеци садржи идентификатор корисника, _hp2_ses_id.{envId} са истеком сесије од 30 минута, _hp2_props.{envId} за стопу узорка и пропагацију особина, и _hp2_loaded као маркер учитавања. Contentsquare интегрисани модул снимка сесије додаје бафер снимања у меморији који се испразни у Heap крајњу тачку сваких неколико секунди и може посебно да сачува мали идентификатор сесије снимка. Повлачење сагласности мора стога и истећи колачиће _hp2_ и сигнализовати захтев за брисање преко Heap-овог GDPR API-ја за претходне снимке и ток догађаја корисника.
Мапирање Heap-а на оквире сагласности
Heap не имплементира IAB TCF или IAB Global Privacy Platform — то је платформа аналитике производа прве стране, а не добављач адтех-а — али се интегрише са Google Consent Mode v2 преко премошћивања са стране издавача, излаже нативни API за пристанак и одбијање, и подржава слој редаговања осетљивих особина који ради без обзира на стање сагласности. Образац који преживљава регулаторни преглед третира сваки Heap модул као одвојену капију везану за специфични CMP сигнал.
- Аутоматско снимање и основни ток догађаја везани су за аналитичку сврху. У TCF терминима ово је најчешће сврха 8 (мерење перформанси садржаја) у комбинацији са сврхом 1 (чување и/или приступ информацијама). За Consent Mode ово се пресликава на analytics_storage.
- Снимак сесије преко Contentsquare интеграције стоји иза строже, одвојене капије јер снимак бележи рендерни DOM и свако немаскирано поље уноса, а EDPB-ове смернице о снимку сесије третирају га као категорију која захтева изричиту и детаљну сагласност различиту од опште аналитике.
- Идентификација корисника преко heap.identify() може радити са ефемерним идентификатором сесије на основу легитимног интереса када је корисник анониман, али спајање идентификације са постојаним идентификатором прве стране кроз сесије захтева исту сагласност као аналитика, јер тада идентификатор постаје тачка података корисника коју је могуће пратити.
- Унакрсна пропагација идентитета преко identity API-ја захтева маркетинг капију јер прелази границу од аналитике производа до атрибуције маркетинга на нивоу корисника.
Образац интеграције који функционише
Референтни deployment има четири дела: CMP који излаже догађај промене сагласности у реалном времену, одложени покретач који учитава Heap са онемогућеним аутоматским снимањем, слушалац сагласности који укључује аутоматско снимање и покреће бафер снимка сесије када се отворе одговарајуће капије, и путања повлачења која позива heap.resetIdentity(), зауставља аутоматско снимање, истиче колачиће _hp2_ и шаље захтев за брисање преко Heap-овог GDPR крајња тачке.
Веб имплементација
На вебу је најчистији образац условно учитавање Heap фрагмента — ознака <script> се убризгава само пошто аналитичка категорија буде одобрена. Претплатите се на догађај промене сагласности CMP-а. Када аналитичка категорија пређу у истинито, убризгајте Heap фрагмент са secureCookie: true, disableTextCapture: false за потпуно аутоматско снимање и сваком конфигурацијом специфичном за окружење. Када сагласност за снимак сесије пређу у истинито и Contentsquare интеграција је омогућена, бафер снимка се активира аутоматски. Када се нека капија повуче, позовите heap.resetIdentity(), а затим уклоните елемент Heap скрипте, истекните колачиће _hp2_ преко document.cookie и позовите GDPR-API за брисање за идентификатор корисника.
Редаговање осетљивих особина
Heap долази са слојем редаговања који ради без обзира на стање сагласности и који издавачи треба да користе чак и када је сагласност дата. Атрибут data-heap-redact-text на пољу формулара потискује снимљени текстуални садржај; атрибут data-heap-redact-attributes потискује атрибуте елемента. Под правилима посебне категорије GDPR-а и дефиницијом осетљивих личних података CCPA-а, свако поље које би могло да снима здравствене информације, финансијске детаље, државне идентификаторе, биометријске податке, прецизну геолокацију или садржај приватних комуникација мора да користи атрибуте редаговања без обзира на стање сагласности корисника. Постављање атрибута на нивоу формулара је најсигурнији образац — потискује цео формулар чак и када програмер дода ново поље за које заборави да га означи појединачно.
Избор региона: резиденција података ЕУ наспрам САД
Heap управља одвојеним крајњим тачкама за унос у ЕУ и САД. За EEA и UK саобраћај, EU крајња тачка је прави подразумевани; одржава унос, обраду и складиштење унутар EEA и смањује изложеност Schrems II коју носи свaki аналитички deployment у US региону. Крајња тачка се поставља преко конфигурације фрагмента и не може се ретроактивно мењати — постојећи подаци остају тамо где су прво унесени. За издаваче који планирају Heap увођење, стога вреди потврдити регион пре скалирања и вреди документовати избор у обавештењу о приватности тако да ланац правне основе буде чист од прикупљања до складиштења.
Валидација интеграције и ревизорски траг
Корак валидације је оно што регулатори проверавају и оно што издавачи најчешће прескачу. Исправно интегрисани Heap deployment мора да прође четири теста редом. Прво, чиста браузер сесија са приказаним банером, али без донетог избора, мора да произведе нула захтева ка heapanalytics.com осим захтева за SDK датотеку и нула колачића _hp2_ у document.cookie. Друго, одбијање аналитике мора задржати то стање — без аутоматског снимања, без идентификатора, без снимања. Треће, прихватање аналитике мора произвести очекивани колачић _hp2_id са исправним SameSite атрибутима и саобраћај догађаја који тече ка конфигурисаној регионалној крајњој тачки. Четврто, повлачење сагласности мора одмах зауставити даље аутоматско снимање и снимак, истећи колачиће _hp2_ и покренути захтев за брисање преко Heap-овог GDPR API-ја.
Очекивање ревизорског трага под EDPB смерницама за банер колачића из 2023. и обновљеним приоритетима радне групе из 2026. је да издавач може доказати, за сваки дати догађај у Heap пројекту, да је корисник који га је генерисао дао важећу сагласност у тренутку снимања. Стандардни образац је постављање верзије сагласности и временске ознаке као особина корисника на препознатљиви идентификатор преко heap.addUserProperties({ consent_version: 'v3', consent_ts: ts }) тако да сваки поједини догађај буде проследив до конкретног уноса у евиденцију сагласности. Исправно обезбеђен deployment, упарен са атрибутима редаговања који по подразумевани потискују осетљива поља и путањом брисања која се активира при повлачењу, је оно што Heap-ов модел аутоматског снимања претвара из регулаторног ризика концентрације у један од најмоћнијих и најбраниљивијих делова аналитичког стека производа издавача.