Heap Auto-Capture پروڈکٹ اینالیٹکس کوکی رضامندی انضمام گائیڈ: ناشرین کے لیے 2026 پلے بک
Heap پروڈکٹ اینالیٹکس ایکوسسٹم میں اس وجہ سے غیر معمولی ہے کہ وہ ڈیفالٹ طور پر کیا کرتی ہے۔ جہاں Mixpanel، Amplitude اور PostHog ناشر سے ان ایونٹس کو انسٹرومینٹ کرنے کو کہتے ہیں جو اہم ہیں، وہاں Heap سب کچھ خودبخود کیپچر کرتی ہے اور تجزیہ کار کو کیپچر کیے گئے اسٹریم سے پچھلی تاریخ میں ایونٹس کی تعریف کرنے دیتی ہے۔ یہ آٹو کیپچر ماڈل پروڈکٹ کی تعریفی خصوصیت ہے اور وہ وجہ ہے جس کے لیے ٹیمیں اسے منتخب کرتی ہیں؛ یہ اس بات کی بھی وجہ ہے کہ ڈیفالٹ Heap تعیناتی کسی بھی ٹول کی سب سے وسیع رویے کے ڈیٹا سطحوں میں سے ایک رکھتی ہے جو ناشر ممکنہ طور پر انسٹال کرتا ہے۔ ہر کلک، ٹیپ، اسکرول، فارم تعامل، صفحے کی منتقلی، اور غصے کا کلک صفحے کے لوڈ ہونے کی ملی سیکنڈز کے اندر ایک مستقل شناخت کنندہ کے خلاف کیپچر کیا جاتا ہے — جس کا مطلب ہے کہ ان کارروائیوں میں سے ہر ایک رضامندی کی ذمہ داری کو فعال کرتی ہے۔ اچھی خبر یہ ہے کہ Heap، Contentsquare کے ذریعے حصول کے بعد سے، پروڈکٹ اینالیٹکس کی جگہ میں سب سے زیادہ دانے دار رضامندی APIs میں سے ایک کے ساتھ آتی ہے؛ کام یہ ہے کہ اسے آٹو کیپچر سطح، شناخت کی پرت اور Contentsquare انضمام کے شامل کردہ سیشن ری پلے ماڈیول کے ذریعے صحیح طریقے سے وائر کیا جائے۔
Heap کو رضامندی کی ضرورت کیوں ہے — اور جواب عام اینالیٹکس سے زیادہ وسیع کیوں ہے
ڈیفالٹ Heap ابتدائیہ صفحے کی پہلی پینٹ میں کئی کام کرتا ہے۔ یہ مستقل صارف شناخت کنندہ پر مشتمل _hp2_id.{envId} کے تحت ایک فرسٹ پارٹی کوکی، سیشن شناخت کنندہ کے ساتھ _hp2_ses_id.{envId} کے تحت ایک سیشن کوکی، _hp2_props.{envId} کے تحت ایک نمونہ ریٹ کوکی، اور _hp2_loaded مارکر جو یہ ظاہر کرتا ہے کہ SDK نے ابتدائی کاری کی ہے، سیٹ کرتا ہے۔ یہ ممتاز شناخت کنندہ تیار کرتا ہے اگر ایک موجود نہیں ہے، ریفرر، UTM پیرامیٹرز اور کلک شناخت کنندگان کے ساتھ ابتدائی صفحہ ویو کیپچر کرتا ہے، اور اس شناخت کنندہ کے خلاف ہر اگلے تعامل کو فوری طور پر ریکارڈ کرنا شروع کردیتا ہے — کلکس، ٹیپس، فارم تبدیلیاں، روٹ تبدیلیاں، کسٹم ایونٹس اور جب Contentsquare انضمام فعال ہو، سیشن ری پلے کے لیے مکمل رینڈر شدہ DOM diff۔
ان سرگرمیوں میں سے ہر ایک ایک علیحدہ رضامندی گیٹ کو فعال کرتی ہے۔ صارف شناخت کنندہ کو برقرار رکھنا ePrivacy Directive کے آرٹیکل 5(3) کے تحت ذخیرہ کاری اور رسائی کی کارروائی ہے اور EEA، UK اور کسی بھی دائرہ اختیار میں جس نے اسی معیار کو درآمد کیا ہے، پہلے سے، آزادانہ طور پر دی گئی، مخصوص، باخبر اور غیر مبہم رضامندی کی ضرورت ہے۔ آٹو کیپچر ایونٹ اسٹریم کو کیپچر کرنا GDPR کے تحت ذاتی ڈیٹا کی پروسیسنگ ہے کیونکہ شناخت کنندہ، IP ایڈریس اور رویے کے نشان کا امتزاج کسی فرد کو منفرد کرنے کے لیے کافی ہے۔ سیشن ری پلے EDPB کی سیشن ری پلے رہنمائی کے تحت ایک علیحدہ، سخت تر زمرے میں ہے — ری پلے رینڈر شدہ DOM اور کسی بھی غیر ماسک شدہ انپٹ فیلڈ کو کیپچر کرتا ہے اور عام اینالیٹکس رضامندی سے الگ واضح، دانے دار رضامندی کی ضرورت ہے۔ CCPA اور CPRA اسی پروسیسنگ کو فروخت یا اشتراک کے طور پر دیکھتے ہیں جب تک کہ ناشر کے پاس Heap کے ساتھ متعلقہ سروس پرووائیڈر معاہدہ نہ ہو — جو Heap پیش کرتا ہے، لیکن معاہدہ صرف اسی وقت نافذ ہوتا ہے جب انضمام سروس پرووائیڈر موڈ کے لیے ترتیب دیا گیا ہو۔
Heap رضامندی سے پہلے کیا لکھتا ہے — اور کیا دبایا جانا چاہیے
معیاری quickstart جو Heap ڈیش بورڈ کے ساتھ آتا ہے، صفحے کے <head> میں براہ راست ٹریکنگ سنپٹ انسٹال کرتا ہے۔ یہ دستاویز کردہ طریقے سے کام کرتا ہے اور Heap تعیناتیوں میں سب سے عام تعمیل کی ناکامی کا ذریعہ ہے: سنپٹ کوکی بینر کے رینڈر ہونے سے پہلے چلتا ہے، _hp2_ کوکیز ملی سیکنڈز کے اندر لکھی جاتی ہیں، اور آٹو کیپچر اسٹریم heapanalytics.com کو بہنا شروع کردیتا ہے چاہے صارف بعد میں کچھ بھی فیصلہ کرے۔ ہر یورپی ریگولیٹر جس نے اس پیٹرن پر فیصلہ دیا ہے اسی طرح فیصلہ دیا ہے: رضامندی سے پہلے سیٹ کی گئی کوکیز غیر قانونی ہیں، اور ناشر ذمہ داری اٹھاتا ہے۔
لہذا ایک تعمیل انضمام کو Heap سنپٹ کو لوڈ ہونے سے روکنا چاہیے جب تک کہ متعلقہ رضامندی کیٹیگری دی نہ گئی ہو۔ پروڈکشن میں کام کرنے والے دو پیٹرنز مشروط اسکرپٹ انجیکشن ہیں — سنپٹ صرف اس وقت DOM میں شامل کیا جاتا ہے جب CMP رضامندی سگنل کرتا ہے — اور heap.load(appId, { disableTextCapture: true, secureCookie: true, autocapture: false }) کے ساتھ سنپٹ کو ملتوی bootstrap کے طور پر پری لوڈ کرنا اور پھر رضامندی ریکارڈ ہونے کے بعد heap.startAutoCapture() کو کال کرنا۔ مشروط انجیکشن پیٹرن صاف تر ہے اور وہ ہے جو Heap دستاویزیشن اب تجویز کرتی ہے۔ ملتوی bootstrap پیٹرن صحیح انتخاب ہے جب ناشر کو شناخت سٹچنگ کے لیے ایک مستحکم گلوبل حوالہ درکار ہو لیکن آٹو کیپچر کو رضامندی سے پہلے فائر کرنے کی اجازت نہیں دے سکتا۔
Heap کی لکھی ہوئی کوکیز اور اسٹوریج
Heap سنپٹ ابتدائی کاری پر مندرجہ ذیل شناخت کنندگان لکھتا ہے، یہ سب غیر ضروری ہیں اور رضامندی کی ضرورت ہے: صارف شناخت کنندہ پر مشتمل 14 ماہ کی میعاد ختم ہونے کے ساتھ _hp2_id.{envId}، 30 منٹ کی سیشن میعاد ختم ہونے کے ساتھ _hp2_ses_id.{envId}، نمونہ ریٹ اور پراپرٹی پروپیگیشن کے لیے _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() کے ذریعے صارف کی شناخت جب صارف گمنام ہو تو جائز مفاد کی بنیاد پر عارضی سیشن شناخت کنندہ کے ساتھ چل سکتی ہے، لیکن سیشنز میں مستقل فرسٹ پارٹی شناخت کنندہ کے ساتھ شناخت کو سٹچ کرنے کے لیے اینالیٹکس جیسی رضامندی کی ضرورت ہے کیونکہ یہی وہ وقت ہے جب شناخت کنندہ ایک قابل ٹریسنگ صارف سطح کا ڈیٹا پوائنٹ بنتا ہے۔
- آئیڈنٹٹی API کے ذریعے کراس سائٹ یا کراس پروڈکٹ آئیڈنٹٹی پروپیگیشن مارکیٹنگ گیٹ کی ضرورت ہے کیونکہ یہ پروڈکٹ اینالیٹکس سے صارف سطح کی مارکیٹنگ اٹریبیوشن میں لائن کراس کرتا ہے۔
انضمام کا پیٹرن جو کام کرتا ہے
ریفرنس تعیناتی کے چار حصے ہیں: ایک CMP جو ریئل ٹائم رضامندی تبدیلی ایونٹ ظاہر کرتا ہے، ایک ملتوی bootstrap جو آٹو کیپچر غیر فعال کے ساتھ Heap لوڈ کرتا ہے، ایک رضامندی سننے والا جو جب متعلقہ گیٹس کھلتے ہیں تو آٹو کیپچر آن کرتا ہے اور سیشن ری پلے بفر شروع کرتا ہے، اور ایک واپسی کا راستہ جو heap.resetIdentity() کو کال کرتا ہے، آٹو کیپچر روکتا ہے، _hp2_ کوکیز ختم کرتا ہے اور Heap کے GDPR اینڈپوائنٹ کے ذریعے حذف کی درخواست بھیجتا ہے۔
ویب پر نافذ کاری
ویب پر سب سے صاف پیٹرن Heap سنپٹ کو مشروط طور پر لوڈ کرنا ہے — <script> ٹیگ صرف اس کے بعد انجیکٹ کیا جاتا ہے جب اینالیٹکس کیٹیگری دی گئی ہو۔ CMP کے رضامندی تبدیلی ایونٹ کو سبسکرائب کریں۔ جب اینالیٹکس کیٹیگری سچ میں منتقل ہو، secureCookie: true، مکمل آٹو کیپچر کے لیے disableTextCapture: false، اور کسی بھی ماحول مخصوص ترتیب کے ساتھ Heap سنپٹ انجیکٹ کریں۔ جب سیشن ری پلے رضامندی سچ میں منتقل ہو اور Contentsquare انضمام فعال ہو، ری پلے بفر خودبخود چالو ہوتا ہے۔ جب کوئی بھی گیٹ واپس لیا جائے، heap.resetIdentity() کو کال کریں اس کے بعد Heap اسکرپٹ عنصر کو ہٹائیں، document.cookie کے ذریعے _hp2_ کوکیز ختم کریں، اور صارف کے شناخت کنندہ کے لیے GDPR حذف API کو فعال کریں۔
حساس پراپرٹی ریڈیکشن
Heap ایک ریڈیکشن لیئر کے ساتھ آتا ہے جو رضامندی کی حالت سے قطع نظر کام کرتی ہے اور جسے ناشرین کو رضامندی دی گئی ہو تب بھی استعمال کرنا چاہیے۔ فارم فیلڈ پر data-heap-redact-text صفت کیپچر شدہ ٹیکسٹ مواد کو دباتی ہے؛ data-heap-redact-attributes صفت عنصر کی صفات کو دباتی ہے۔ GDPR کے خصوصی زمرے کے قوانین اور CCPA کی حساس ذاتی معلومات کی تعریف کے تحت، کوئی بھی فیلڈ جو صحت کی معلومات، مالی تفصیلات، سرکاری شناخت کنندگان، بائیومیٹرک ڈیٹا، درست جغرافیائی مقام، یا نجی مواصلات کے مواد کو کیپچر کر سکتی ہو، اسے صارف کی رضامندی کی حالت سے قطع نظر ریڈیکشن صفات استعمال کرنی چاہئیں۔ فارم کی سطح پر صفات ترتیب دینا سب سے محفوظ پیٹرن ہے — یہ پورے فارم کو دباتا ہے یہاں تک کہ جب کوئی ڈیویلپر نیا فیلڈ شامل کرتا ہے جسے وہ انفرادی طور پر نشان زد کرنا بھول جاتے ہیں۔
علاقے کا انتخاب: EU بمقابلہ US ڈیٹا رہائش
Heap علیحدہ EU اور US انٹیک اینڈپوائنٹس چلاتا ہے۔ EEA اور UK ٹریفک کے لیے EU اینڈپوائنٹ صحیح ڈیفالٹ ہے؛ یہ انٹیک، پروسیسنگ اور اسٹوریج EEA کے اندر رکھتا ہے اور Schrems II کی نمائش کو کم کرتا ہے جو کوئی بھی US ریجن اینالیٹکس تعیناتی اٹھاتی ہے۔ اینڈپوائنٹ سنپٹ ترتیب کے ذریعے سیٹ کیا جاتا ہے اور پیچھے سے تبدیل نہیں کیا جا سکتا — موجودہ ڈیٹا وہاں رہتا ہے جہاں پہلے انٹیک ہوا تھا۔ Heap رول آؤٹ کی منصوبہ بندی کرنے والے ناشرین کے لیے لہذا پیمانہ کرنے سے پہلے علاقے کی تصدیق کرنا قابل قدر ہے، اور رازداری نوٹس میں انتخاب کو دستاویزی کرنا قابل قدر ہے تاکہ قانونی بنیاد کی زنجیر جمع آوری سے لے کر اسٹوریج تک صاف رہے۔
انضمام کی تصدیق اور آڈٹ ٹریل
تصدیق کا مرحلہ وہ ہے جو ریگولیٹرز چیک کرتے ہیں اور جسے ناشر اکثر چھوڑ دیتے ہیں۔ صحیح طریقے سے انٹیگریٹڈ Heap تعیناتی کو ترتیب وار چار ٹیسٹ پاس کرنے چاہئیں۔ پہلا، بینر کے ظاہر ہونے لیکن کوئی انتخاب نہ کیے گئے صاف براؤزر سیشن کو SDK فائل فیچ سے آگے heapanalytics.com کو صفر درخواستیں اور document.cookie میں صفر _hp2_ کوکیز پیدا کرنی چاہئیں۔ دوسرا، اینالیٹکس کو مسترد کرنا اس حالت کو برقرار رکھے — کوئی آٹو کیپچر نہیں، کوئی شناخت کنندہ نہیں، کوئی ریکارڈنگ نہیں۔ تیسرا، اینالیٹکس قبول کرنے سے متوقع _hp2_id کوکی صحیح SameSite صفات کے ساتھ اور ترتیب دیے گئے علاقے اینڈپوائنٹ پر بہنے والا ایونٹ ٹریفک پیدا ہونا چاہیے۔ چوتھا، رضامندی واپس لینے سے فوری طور پر مزید آٹو کیپچر اور ری پلے رک جانی چاہیے، _hp2_ کوکیز ختم ہونی چاہئیں، اور Heap GDPR API کے ذریعے حذف کی درخواست متحرک ہونی چاہیے۔
EDPB کی 2023 کوکی بینر رہنما ہدایات اور تجدید شدہ 2026 ٹاسک فورس ترجیحات کے تحت آڈٹ ٹریل کی توقع یہ ہے کہ ناشر Heap پروجیکٹ میں کسی بھی دیے گئے ایونٹ کے لیے ثابت کر سکے کہ اسے پیدا کرنے والے صارف نے کیپچر کے وقت درست رضامندی دی تھی۔ معیاری پیٹرن یہ ہے کہ رضامندی ورژن اور ٹائم اسٹیمپ کو heap.addUserProperties({ consent_version: 'v3', consent_ts: ts }) کے ذریعے ممتاز ID پر صارف پراپرٹیز کے طور پر سیٹ کیا جائے تاکہ کوئی بھی انفرادی ایونٹ ایک مخصوص رضامندی لاگ انٹری تک قابل ٹریس ہو۔ ایک صحیح گیٹڈ تعیناتی، ریڈیکشن صفات کے ساتھ مل کر جو ڈیفالٹ طور پر حساس فیلڈز کو دباتی ہیں اور ایک حذف کا راستہ جو واپسی پر چالو ہوتا ہے، وہ ہے جو Heap کے آٹو کیپچر ماڈل کو ریگولیٹری ارتکاز کے خطرے سے ناشر کے پروڈکٹ اینالیٹکس اسٹیک کے سب سے طاقتور اور قابل دفاع حصوں میں سے ایک میں تبدیل کرتا ہے۔