Heap Auto-Capture өнім талдауы Cookie келісімін интеграциялау нұсқаулығы: Баспагерлер үшін 2026 жылғы нұсқаулық
Heap өнім аналитикасы экожүйесінде өзінің әдепкі жұмысымен ерекше орын алады. Mixpanel, Amplitude және PostHog баспагерден маңызды оқиғаларды инструменттеуін талап еткенде, Heap барлығын автоматты түрде ұстап, аналитикке ұсталған ағыннан оқиғаларды кері белгілеуге мүмкіндік береді. Бұл auto-capture үлгісі өнімнің айрықша ерекшелігі және командалардың оны таңдау себебі; бұл сонымен қатар әдепкі Heap орналастыруының баспагер орнатуы мүмкін кез келген құралдың ішіндегі мінез-құлық деректерінің ең кең беттерінің бірін тасымалдауының себебі болып табылады. Барлық басу, тигізу, айналдыру, форммен өзара әрекет ету, бет ауысуы және rage-click беттің жүктелуінен миллисекунд ішінде тұрақты идентификаторға қарсы ұсталады — бұл аталған операциялардың әрқайсысы келісім міндеттемесін тудыратынын білдіреді. Жақсы жаңалық — Heap, Contentsquare сатып алғаннан бері, өнім аналитикасы аясындағы ең егжей-тегжейлі келісім API-лерінің бірімен жеткізіледі; жұмыс оны auto-capture бетінде, идентификация қабатында және Contentsquare интеграциясы қосатын сеанс ойнату модулінде дұрыс жалғауда жатыр.
Heap неге келісімді қажет етеді — және неге жауап кәдімгі аналитикадан кеңірек
Әдепкі Heap инициализациясы беттің бірінші бояуында бірнеше нәрсе жасайды. Ол _hp2_id.{envId} астында тұрақты пайдаланушы идентификаторын қамтитын бірінші тарап cookie-ін, сеанс идентификаторы бар _hp2_ses_id.{envId} астында сеанс cookie-ін, _hp2_props.{envId} астында үлгі жылдамдығы cookie-ін және SDK инициализацияланғанын көрсететін _hp2_loaded маркерін орнатады. Бар болмаса ерекше идентификаторды жасайды, реферер, UTM параметрлері және басу идентификаторларымен бірге бастапқы беттің қаралуын ұстайды және сол идентификаторға қарсы барлық кейінгі өзара әрекеттестіктерді — баспаларды, тигізулерді, форм өзгерістерін, маршрут өзгерістерін, арнайы оқиғаларды және Contentsquare интеграциясы қосылғанда сеанс ойнату үшін толық рендерленген DOM айырмашылығын — бірден жазуды бастайды.
Бұл әрекеттердің әрқайсысы жеке келісім қақпасын іске қосады. Пайдаланушы идентификаторын сақтау ePrivacy директивасының 5(3) бабы бойынша сақтау-және-кіру операциясы болып табылады және ЕЭА, Ұлыбритания және сол стандартты енгізген кез келген юрисдикцияда алдын ала, еркін берілген, нақты, хабарланған және екіұштылықсыз келісімді талап етеді. auto-capture оқиға ағынын ұстау GDPR бойынша жеке деректерді өңдеу болып табылады, себебі идентификатор, IP-мекенжай және мінез-құлық ізінің үйлесімі жеке тұлғаны оқшаулауға жеткілікті. Сеанс ойнату EDPB сеанс ойнату нұсқаулығы бойынша жеке, қатаңырақ санатта орналасады — ойнату рендерленген DOM және кез келген маскасыз енгізу өрісін ұстайды және жалпы аналитикалық келісімнен ерекшеленетін нақты, егжей-тегжейлі келісімді талап етеді. CCPA және CPRA баспагердің Heap-пен тиісті қызмет провайдері шарты болмаса, бірдей өңдеуді сату немесе бөлісу ретінде қарастырады.
Heap келісімге дейін не жазады — және не басылуы керек
Heap бақылау тақтасымен жеткізілетін стандартты жылдам іске қосу бақылау үзіндісін беттің <head> бөліміне тікелей орнатады. Бұл құжатталғандай жұмыс істейді және Heap орналастырудағы ең кең тараған сәйкестік сәтсіздігінің қайнар көзі болып табылады: үзінді cookie баннері рендерленбей тұрып іске қосылады, _hp2_ cookie-лер миллисекунд ішінде жазылады және auto-capture ағыны пайдаланушының кейіннен не шешетініне қарамастан heapanalytics.com сайтына ағыла бастайды. Осы үлгі бойынша шешім қабылдаған барлық еуропалық реттеуші бірдей шешті: келісімге дейін орнатылған cookie-лер заңсыз, ал баспагер жауапкершілікті өзіне алады.
Сәйкес интеграция, сондықтан, тиісті келісім санаты берілгенше Heap үзіндісінің жүктелуін болдырмауы керек. Өндірісте жұмыс істейтін екі үлгі шартты сценарий инъекциясы — үзінді DOM-ға тек CMP келісімді сигналдаған соң қосылады — және heap.load(appId, { disableTextCapture: true, secureCookie: true, autocapture: false }) арқылы үзіндіні кешіктірілген жүктеу жинағы ретінде алдын ала жүктеу, содан кейін келісім тіркелген кезде heap.startAutoCapture() шақыру болып табылады. Шартты инъекция үлгісі таза және Heap құжаттамасы қазір ұсынатын үлгі болып табылады. Кешіктірілген жүктеу жинағы үлгісі баспагер идентификацияны тігу үшін тұрақты жаһандық сілтемені қажет ететін, бірақ auto-capture-ке келісімге дейін іске қосылуға рұқсат бере алмайтын жағдайда дұрыс таңдау болып табылады.
Heap жазатын cookie-лер мен жад
Heap үзіндісі инициализация кезінде келесі идентификаторларды жазады, барлығы маңызды емес және келісімді қажет етеді: пайдаланушы идентификаторын қамтитын 14 айлық жарамдылық мерзімі бар _hp2_id.{envId}, 30 минуттық сеанс мерзімі бар _hp2_ses_id.{envId}, үлгі жылдамдығы мен қасиет таратуы үшін _hp2_props.{envId} және жүктелу маркері ретінде _hp2_loaded. Contentsquare-интеграцияланған сеанс ойнату модулі бірнеше секунд сайын Heap соңғы нүктесіне жіберілетін жадтағы жазу буферін қосады және кішкентай ойнату сеансы идентификаторын бөлек сақтауы мүмкін. Келісімді кері қайтару, сондықтан, _hp2_ cookie-лерінің мерзімі өтуі және пайдаланушының алдыңғы жазбалары мен оқиға ағыны үшін Heap GDPR API арқылы жою сұрауын жіберу керек.
Heap-ті келісім жақтауларына бейнелеу
Heap IAB TCF немесе IAB Global Privacy Platform-ды нативтік іске асырмайды — бұл жарнама технологиясы жеткізушісі емес, бірінші тараптың өнім аналитикасы платформасы — бірақ баспагер жағындағы ауысу арқылы Google Consent Mode v2-мен интеграцияланады, нативтік opt-in және opt-out API-ін ашады және келісім күйіне қарамастан жұмыс істейтін сезімтал қасиет редакциялау қабатын қолдайды. Реттеуші тексерусінен өтетін үлгі әрбір Heap модулін нақты CMP сигналына байланысты жеке қақпа ретінде қарастырады.
- Auto-capture және негізгі оқиға ағыны аналитика мақсатына байланысты. TCF тілінде бұл ең жиі 8-мақсат (мазмұн тиімділігін өлшеу) 1-мақсатпен (ақпаратты сақтау және/немесе қол жеткізу) үйлесімі болып табылады. Consent Mode үшін бұл analytics_storage-ке бейнеленеді.
- Contentsquare интеграциясы арқылы сеанс ойнату қатаңырақ, жеке қақпаның артында орналасады, себебі ойнату рендерленген DOM және кез келген маскасыз енгізу өрісін ұстайды, ал EDPB сеанс ойнату нұсқаулығы оны жалпы аналитикадан ерекшеленетін нақты және егжей-тегжейлі келісімді қажет ететін санат ретінде қарастырады.
- heap.identify() арқылы пайдаланушыны идентификациялау пайдаланушы анонимді болғанда заңды мүддеге негізделген уақытша сеанс идентификаторымен іске қосыла алады, бірақ сеанстар бойынша тұрақты бірінші тараптың идентификаторына идентификацияны тігу идентификатор пайдаланушы деңгейінің қадағалануға болатын деректер нүктесіне айналатын кезде аналитикамен бірдей келісімді талап етеді.
- Идентификация API арқылы сайтаралық немесе өнімаралық идентификацияны тарату маркетинг қақпасын талап етеді, себебі ол өнім аналитикасынан пайдаланушы деңгейіндегі маркетинг атрибуциясына шекараны кесіп өтеді.
Жұмыс істейтін интеграция үлгісі
Анықтамалық орналастырудың төрт бөлігі бар: нақты уақыттағы келісім өзгеру оқиғасын ашатын CMP, auto-capture өшіріліп Heap-ті жүктейтін кешіктірілген жүктеу жинағы, тиісті қақпалар ашылғанда auto-capture-ді қосатын және сеанс ойнату буферін бастайтын келісім тыңдаушысы және heap.resetIdentity() шақыратын, auto-capture-ді тоқтататын, _hp2_ cookie-лерінің мерзімін аяқтататын және Heap GDPR соңғы нүктесі арқылы жою сұрауын жіберетін кері қайтару жолы.
Веб-жүзеге асыру
Вебте ең таза үлгі Heap үзіндісін шартты түрде жүктеу болып табылады — <script> тегі аналитика санаты берілгеннен кейін ғана инъекцияланады. CMP келісім өзгеру оқиғасіне жазылыңыз. Аналитика санаты true-ге ауысқанда, secureCookie: true, толық auto-capture үшін disableTextCapture: false және кез келген орта-белгілі конфигурациямен Heap үзіндісін инъекциялаңыз. Сеанс ойнату келісімі true-ге ауысып, Contentsquare интеграциясы қосылғанда, ойнату буфері автоматты түрде белсендіріледі. Кез келген қақпа кері қайтарылса, heap.resetIdentity() шақырыңыз, содан кейін Heap сценарий элементін алыңыз, document.cookie арқылы _hp2_ cookie-лерінің мерзімін аяқтатыңыз және пайдаланушының идентификаторы үшін GDPR жою API-ін шақырыңыз.
Сезімтал қасиетті редакциялау
Heap келісім күйіне қарамастан жұмыс істейтін редакциялау қабатымен жеткізіледі және баспагерлер келісім берілген кезде де оны пайдалануы керек. Форм өрісіндегі data-heap-redact-text атрибуты ұсталған мәтін мазмұнын басады; data-heap-redact-attributes атрибуты элемент атрибуттарын басады. GDPR арнайы санат ережелері мен CCPA сезімтал жеке ақпаратты анықтауы бойынша денсаулық туралы ақпаратты, қаржылық мәліметтерді, мемлекеттік идентификаторларды, биометриялық деректерді, дәл геолокацияны немесе жеке хат-хабарлардың мазмұнын ұстауы мүмкін кез келген өріс пайдаланушының келісім күйіне қарамастан редакциялау атрибуттарын пайдалануы керек. Форм деңгейінде атрибуттарды орнату ең қауіпсіз үлгі болып табылады — ол тіпті разработчик жеке белгілеуді ұмытқан жаңа өрісті қосқан кезде де бүкіл форманы басады.
Аймақты таңдау: ЕО мен АҚШ деректерінің орналасуы
Heap жеке ЕО және АҚШ тарату соңғы нүктелерін пайдаланады. ЕЭА және Ұлыбритания трафигі үшін ЕО соңғы нүктесі дұрыс әдепкі болып табылады; ол тарату, өңдеу және сақтауды ЕЭА ішінде ұстайды және кез келген АҚШ аймағы аналитика орналастыруы тасымалдайтын Schrems II ықпалын азайтады. Соңғы нүкте үзінді конфигурациясы арқылы орнатылады және кері қайтарымды өзгерту мүмкін емес — бар деректер бірінші рет тарату жүргізілген жерде қалады. Heap іске қосуды жоспарлайтын баспагерлер масштабтауға дейін аймақты растап, масштабтаудан бұрын конфиденциалдылық туралы хабарламада таңдауды тіркеуге тұрарлық, осылайша жинаудан сақтауға дейінгі заңдық негіз тізбегі таза болады.
Интеграцияны және аудит ізін тексеру
Тексеру қадамы реттеушілер тексеретін және баспагерлер жиі өткізіп жіберетін нәрсе болып табылады. Дұрыс интеграцияланған Heap орналастыруы ретпен төрт сынақтан өтуі керек. Біріншіден, баннер көрсетілген бірақ ешқандай таңдау жасалмаған таза браузер сеансы SDK файлын жүктеуден тыс heapanalytics.com сайтына нөлдік сұрауларды және document.cookie ішінде нөлдік _hp2_ cookie-лерді шығаруы керек. Екіншіден, аналитикадан бас тарту сол күйді сақтауы керек — auto-capture жоқ, идентификатор жоқ, жазба жоқ. Үшіншіден, аналитиканы қабылдау дұрыс SameSite атрибуттары бар күтілетін _hp2_id cookie-ін және конфигурацияланған аймақ соңғы нүктесіне ағатын оқиға трафигін шығаруы керек. Төртіншіден, келісімді кері қайтару одан әрі auto-capture мен ойнатуды бірден тоқтатуы, _hp2_ cookie-лерінің мерзімін аяқтатуы және Heap GDPR API арқылы жою сұрауын іске қосуы керек.
EDPB 2023 cookie баннері нұсқаулықтары мен жаңартылған 2026 жұмыс тобы басымдықтары бойынша аудит ізі күтімі баспагердің Heap жобасындағы кез келген нақты оқиға үшін оны жасаған пайдаланушының ұстау сәтінде жарамды келісім бергенін дәлелдей алатынын білдіреді. Стандартты үлгі heap.addUserProperties({ consent_version: 'v3', consent_ts: ts }) арқылы келісім нұсқасы мен уақыт белгісін ерекше ID бойынша пайдаланушы қасиеттері ретінде орнату, сондықтан кез келген жеке оқиға нақты келісім журналы жазбасына дейін қадағалануы мүмкін болады. Дұрыс қақпаланған орналастыру, сезімтал өрістерді әдепкі бойынша басатын редакциялау атрибуттары мен кері қайтарылғанда белсендіретін жою жолымен жұптастырылып, Heap auto-capture үлгісін реттеуші концентрация тәуекелінен баспагердің өнім аналитикасы жинағының ең күшті және қорғалатын бөліктерінің біріне айналдыратын нәрсе болып табылады.