PostHog ஏன் ஒப்புதல் தேவைப்படுகிறது — மற்றும் ஒவ்வொரு தொகுதிக்கும் பதில் ஏன் ஒரே மாதிரியாக இல்லை

PostHog-இன் வலை SDK ஒரு செயலற்ற பக்க-டேக் அல்ல. இயல்புநிலை துவக்கத்தில் SDK ஒன்று அல்லது அதற்கு மேற்பட்ட first-party நிலைத்தன்மை உள்ளீடுகளை அமைக்கிறது — இயல்பாக ph_{projectKey}_posthog கீழ் விசையிடப்பட்ட ஒரு இணைந்த குக்கீ மற்றும் localStorage திட்டம் — ஒரு நிலையான தனித்துவ அடையாளங்காட்டியை உருவாக்குகிறது, referrer, UTM அளவுருக்கள், மற்றும் கிளிக் அடையாளங்காட்டிகளுடன் ஆரம்ப பக்கப்பார்வையைப் பிடிக்கிறது, மற்றும் கட்டமைக்கப்பட்ட உட்செலுத்தும் ஹோஸ்டிற்கு ஒரு நீண்ட-ஆயுள் நிகழ்வு சேனலைத் திறக்கிறது. திட்ட நிலையில் அமர்வு மறுஇயக்கம் இயக்கப்பட்டிருந்தால், SDK கூடுதலாக வழங்கப்பட்ட DOM, மவுஸ் ஆயத்தொலைவுகள், மற்றும் உள்ளீட்டு நிகழ்வுகளின் தொடர்ச்சியான பதிவை ஸ்ட்ரீம் செய்யத் தொடங்குகிறது. அம்ச கொடிகள் கட்டமைக்கப்பட்டிருந்தால், SDK அவற்றை தனித்துவ அடையாளங்காட்டிக்கு எதிராக மதிப்பிடுகிறது, முடிவுகளை அமர்விற்கு தக்கவைக்கிறது, மற்றும் ஒவ்வொரு மதிப்பீட்டிற்கும் ஒரு $feature_flag_called நிகழ்வை வெளியிடுகிறது.

இந்த செயல்பாடுகள் ஒவ்வொன்றும் வெவ்வேறு ஒப்புதல் வாயில்களுக்கு மேப் செய்கின்றன. ஒரு தனித்துவ அடையாளங்காட்டியைத் தக்கவைப்பது ePrivacy Directive-இன் பிரிவு 5(3)-இன் கீழ் ஒரு சேமிப்பு-மற்றும்-அணுகல் செயல்பாடு மற்றும் EEA, UK, மற்றும் அதே தரநிலையை இறக்குமதி செய்த எந்த அதிகார வரம்பு முழுவதும் முன்கூட்டிய, தடையின்றி அளிக்கப்பட்ட, குறிப்பிட்ட, தகவலறிந்த, மற்றும் தெளிவற்றதல்லாத ஒப்புதல் தேவை. நடத்தை நிகழ்வுகளைப் பிடிப்பது GDPR-இன் கீழ் தனிப்பட்ட தரவின் செயலாக்கம், ஏனெனில் அடையாளங்காட்டி, IP முகவரி, மற்றும் நடத்தை சுவடின் கலவை ஒரு தனிநபரை தனிமைப்படுத்த போதுமானது. அமர்வு மறுஇயக்கம் EDPB-இன் அமர்வு-மறுஇயக்க வழிகாட்டுதலின் கீழ் ஒரு தனி, கடுமையான வகையில் அமர்ந்துள்ளது — மறுஇயக்கம் வழங்கப்பட்ட DOM மற்றும் எந்த மறைக்கப்படாத உள்ளீட்டு புலத்தையும் பிடிக்கிறது மற்றும் பொதுவான பகுப்பாய்வு ஒப்புதலிலிருந்து வேறுபட்ட வெளிப்படையான, நுணுக்கமான ஒப்புதல் தேவை. அம்ச கொடி மதிப்பீடு நுட்பமானது: ஒரு boolean-ஐ திருப்பும் கொடி சோதனைக்கு ஒப்புதல் தேவையில்லை, ஆனால் அமர்வுகள் முழுவதும் பயனரின் கொடி ஒதுக்கீட்டை ஒரு நிலையான அடையாளங்காட்டிக்கு தக்கவைப்பது தேவை, ஏனெனில் கொடி-அடிப்படையிலான சோதனை பயனர்-நிலை கண்காணிக்கக்கூடிய தரவை உருவாக்குவது அவ்வாறே.

PostHog ஒப்புதலுக்கு முன் என்ன எழுதுகிறது — மற்றும் என்ன அடக்கப்பட வேண்டும்

இயல்புநிலை PostHog உலாவி SDK துவக்கத்தில் பின்வருவனவற்றை எழுதுகிறது: தனித்துவ அடையாளங்காட்டி, அமர்வு அடையாளங்காட்டி, மற்றும் அம்ச-கொடி முடிவுகளைக் கொண்ட ph_{projectKey}_posthog கீழ் ஒரு இணைந்த குக்கீ மற்றும் localStorage உள்ளீடு, கூடவே, அமர்வு மறுஇயக்கம் இயக்கப்பட்டிருந்தால், ஒவ்வொரு சில வினாடிகளுக்கும் உட்செலுத்தும் இறுதிப்புள்ளிக்கு பிளஷ் செய்யும் கூடுதல் நினைவக-உள் பதிவு பஃபர். SDK ஒரு உடனடி $pageview நிகழ்வையும், autocapture இயக்கப்பட்டிருந்தால், பக்கத்தில் அடுத்தடுத்த ஒவ்வொரு கிளிக், படிவ தொடர்பு, மற்றும் rage-click-ஐயும் அனுப்புகிறது.

பரிந்துரைக்கப்பட்ட முறை PostHog-ஐ opt_out_capturing_by_default: true மற்றும் disable_session_recording: true உடன் துவக்குவது, பின்னர் ஒப்புதல் பேனர் ஒரு நேர்மறை சமிக்ஞையைத் திருப்பியவுடன் இரண்டு கொடிகளையும் மாற்றுவது. இது PostHog ஆவணப்படுத்தல் இப்போது பரிந்துரைக்கும் ஒருங்கிணைப்பு நிலைப்பாடு, மற்றும் இது ஒரு ஒழுங்குமுறை அதிகாரியின் மறுஆய்வைத் தாங்கிப் பிழைக்கும் நிலைப்பாடு, ஏனெனில் இது இயல்புநிலையைத் தலைகீழாக்குகிறது: ஒப்புதல் பதிவு செய்யப்படும் வரை எதுவும் பிடிக்கப்படவில்லை, மற்றும் SDK ஒரு stateful retrofit-க்குப் பதிலாக ஒரு தூய்மையான மாற்றத்தை வழங்குகிறது.

PostHog தக்கவைக்கும் குக்கீகள், localStorage உள்ளீடுகள், மற்றும் அடையாளங்காட்டிகள்

உலாவி SDK 1.x திட்டத்திற்கு ஒரு நிலைத்தன்மை உள்ளீட்டை எழுதுகிறது, ph_{projectKey}_posthog கீழ் விசையிடப்பட்டது, இயல்பாக 365-நாள் காலாவதியுடன். persistence init விருப்பம் அடிப்படை வழிமுறையைக் கட்டுப்படுத்துகிறது: cookie மட்டும், localStorage மட்டும், localStorage+cookie (இயல்புநிலை), sessionStorage, அல்லது memory. ஒப்புதல்-முதன்மை வரிசைப்படுத்தலுக்கு, ஒப்புதல் இன்னும் வழங்கப்படாதபோது memory நிலைத்தன்மை சரியான இயல்புநிலை — இது எந்த அடையாளங்காட்டியும் பக்க அமர்வை விட நீடிக்காமல் இருப்பதை உறுதி செய்கிறது — ஒப்புதல் மாறியவுடன் localStorage+cookie-க்கு மாற்றத்துடன். SDK பயனரின் தேர்வை வருகைகள் முழுவதும் நினைவில் கொள்ள __ph_opt_in_out_{projectKey} கீழ் ஒரு opt-in அல்லது opt-out குறியையும் எழுதுகிறது; அந்தக் குறி ஒரு ஒப்புதல் முடிவைத் தக்கவைப்பதால் தானே கண்டிப்பாக-அவசியமான குக்கீ.

PostHog தொகுதிகளை ஒப்புதல் கட்டமைப்புகளுக்கு மேப் செய்தல்

PostHog நேட்டிவாக IAB TCF அல்லது IAB Global Privacy Platform-ஐ செயல்படுத்தவில்லை, மற்றும் இது ஒரு ad-tech விற்பனையாளராக கட்டமைக்கப்படவில்லை. இருப்பினும், இது வெளியீட்டாளர்-பக்க பிரிட்ஜிங் வழியாக Google Consent Mode v2 உடன் ஒருங்கிணைகிறது, ஒரு நேட்டிவ் opt-in மற்றும் opt-out API-ஐ வெளிப்படுத்துகிறது, மற்றும் respect_dnt init விருப்பம் வழியாக Do Not Track தலைப்பை மதிக்கிறது. உற்பத்தியில் வேலை செய்யும் முறை ஒவ்வொரு PostHog தொகுதியையும் ஒரு குறிப்பிட்ட CMP சமிக்ஞையுடன் இணைக்கப்பட்ட தனி வாயிலாகக் கருதுகிறது.

• தயாரிப்பு பகுப்பாய்வு நிகழ்வுகள் பகுப்பாய்வு நோக்கத்துடன் இணைக்கின்றன. TCF சொற்களில் இது மிகவும் பொதுவாக நோக்கம் 8 (உள்ளடக்க செயல்திறனை அளவிடுதல்) நோக்கம் 1 (தகவலைச் சேமித்தல் மற்றும்/அல்லது அணுகுதல்) உடன் இணைந்து. Consent Mode-க்கு இது analytics_storage-க்கு மேப் செய்கிறது.
• அமர்வு மறுஇயக்கம் ஒரு கடுமையான வாயிலின் பின்னால் அமர்கிறது. PostHog-இன் அமர்வு மறுஇயக்கம் வழங்கப்பட்ட DOM மற்றும் எந்த மறைக்கப்படாத உள்ளீட்டு புலத்தையும் பிடிக்கிறது, எனவே பகுப்பாய்விலிருந்து வேறுபட்ட விருப்பத்தேர்வு-நிலை அல்லது ஆராய்ச்சி-நிலை opt-in EDPB-இன் வழிகாட்டுதலின் கீழ் பாதுகாக்கக்கூடிய நிலைப்பாடு.
• அம்ச கொடிகள் மற்றும் சோதனை வழங்கப்பட்ட பக்கத்தை மாற்றுவது மட்டுமே குறிக்கோளாக இருக்கும்போது ஒரு நியாயமான-நலன் அடிப்படையின் கீழ் தற்காலிக, நினைவக-உள் மதிப்பீட்டுடன் இயங்கலாம். அமர்வுகள் முழுவதும் ஒரு நிலையான அடையாளங்காட்டியுடன் இணைக்கப்பட்ட நிரந்தர கொடி ஒதுக்கீடு பகுப்பாய்வுக்கு உள்ள அதே ஒப்புதல் தேவை, ஏனெனில் கொடி ஒரு கண்காணிக்கக்கூடிய பயனர்-நிலை தரவு புள்ளியாக மாறுவது அப்போதே.
• கணக்கெடுப்புகள் மற்றும் கருத்து அவை இலவச-உரை உள்ளீட்டைச் சேகரிக்கும்போது அமர்வு மறுஇயக்கத்துடன் அதே வாயிலுடன் இணைக்கின்றன, அல்லது அவை மதிப்பீடுகள் அல்லது ஒற்றை-தேர்வு பதில்களை மட்டுமே சேகரிக்கும்போது பகுப்பாய்வு வாயிலுடன்.

வேலை செய்யும் ஒருங்கிணைப்பு முறை

குறிப்பு வரிசைப்படுத்தலுக்கு நான்கு பகுதிகள் உள்ளன: நிகழ்நேர ஒப்புதல் மாற்ற நிகழ்வை வெளிப்படுத்தும் CMP, பிடிப்பு மற்றும் மறுஇயக்கம் முடக்கப்பட்ட நிலையில் PostHog-ஐ துவக்கும் தாமதமான bootstrap, தொடர்புடைய வாயில்கள் திறக்கும்போது opt_in_capturing மற்றும் பதிவு சுவிட்சை மாற்றும் ஒப்புதல் கேட்பவர், மற்றும் opt_out_capturing-ஐ அழைத்து, மறுஇயக்க பஃபரை நிறுத்தி, SDK-இன் reset API வழியாக நிரந்தர அடையாளங்காட்டிகளை அழிக்கும் திரும்பப்பெறும் பாதை.

வலை செயல்படுத்தல்

தூய்மையான முறை PostHog SDK-ஐ ஒவ்வொரு பக்கத்திலும் ஏற்றுவது, ஆனால் ஆரம்ப bootstrap ஆக posthog.init(apiKey, { api_host: 'https://eu.posthog.com', opt_out_capturing_by_default: true, disable_session_recording: true, persistence: 'memory', respect_dnt: true })-ஐ அழைப்பது. CMP-இன் ஒப்புதல் மாற்ற நிகழ்வுக்கு குழுசேரவும். பகுப்பாய்வு வகை true-க்கு மாறும்போது, posthog.set_config({ persistence: 'localStorage+cookie' })-ஐ தொடர்ந்து posthog.opt_in_capturing()-ஐ அழைக்கவும்; இது நிகழ்வு பிடிப்பை மீண்டும் இயக்குகிறது, மற்றும் நிலைத்தன்மை மாற்றம் தனித்துவ அடையாளங்காட்டியை எழுதத் தொடங்குகிறது. அமர்வு-மறுஇயக்க வகை true-க்கு மாறும்போது, posthog.startSessionRecording()-ஐ அழைக்கவும். எந்த வாயிலும் திரும்பப்பெறும்போது, பகுப்பாய்வு வாயிலுக்கு posthog.opt_out_capturing() அல்லது மறுஇயக்க வாயிலுக்கு posthog.stopSessionRecording()-ஐ அழைக்கவும், posthog.reset() வழியாக தொடர்புடைய நிலைத்தன்மை உள்ளீடுகளை காலாவதியாக்கவும், மற்றும் பயனர் தனது அழிப்பு உரிமையைப் பயன்படுத்தியிருந்தால் PostHog-இன் GDPR API வழியாக ஒரு நீக்க கோரிக்கையை அனுப்பவும்.

பகுதி தேர்வு: PostHog Cloud US vs EU vs self-hosted

PostHog இரண்டு cloud பகுதிகளை இயக்குகிறது — US (us.posthog.com) மற்றும் EU (eu.posthog.com) — மற்றும் வாடிக்கையாளரின் சொந்த உள்கட்டமைப்பில் self-hosted நிறுவல்களை ஆதரிக்கிறது. EEA மற்றும் UK போக்குவரத்துக்கு, EU cloud சரியான இயல்புநிலை; இது உட்செலுத்துதல், செயலாக்கம், மற்றும் சேமிப்பை EEA-க்குள் வைத்திருக்கிறது மற்றும் எந்த US-பகுதி பகுப்பாய்வு வரிசைப்படுத்தலும் சுமக்கும் Schrems II வெளிப்பாட்டைக் குறைக்கிறது. api_host init விருப்பம் பகுதியை நிலைநிறுத்துகிறது. Self-hosted PostHog முழு தொகுப்பையும் வெளியீட்டாளரின் சொந்த உள்கட்டமைப்பிற்கு நகர்த்துகிறது, இது வலுவான தரவு-வசிப்பிட நிலைப்பாடு, ஆனால் ஒப்புதல் கடமைகளை அகற்றாது — சட்ட அடிப்படை தரவைப் பின்தொடர்கிறது, ஆபரேட்டரை அல்ல. தேர்ந்தெடுக்கப்பட்ட எந்த விருப்பமும் தனியுரிமை அறிவிப்பு மற்றும் கட்டுப்படுத்தியின் செயலாக்க பதிவில் பிரதிபலிக்கப்பட வேண்டும்.

சர்வர் பக்க பிடிப்பு

PostHog Python, Node, Go, Ruby, மற்றும் PHP SDK-கள் வழியாக சர்வர் பக்க நிகழ்வு உட்செலுத்துதலை ஆதரிக்கிறது. சர்வர் பக்க நிகழ்வுகள் ஒப்புதலிலிருந்து விலக்கப்படவில்லை — சட்ட அடிப்படை தரவைப் பின்தொடர்கிறது — ஆனால் சர்வர் பக்க உட்செலுத்துதல் எந்த புலங்கள் வெளியிடப்படுகின்றன மற்றும் எப்போது என்பதில் வெளியீட்டாளருக்கு முழு கட்டுப்பாட்டை அளிக்கிறது. ஒரு பொதுவான முறை நியாயமான நலனின் கீழ் சர்வர் பக்க குறைந்தபட்ச அத்தியாவசிய-மட்டும் நிகழ்வுத் தொகுப்பைப் பிடிப்பது, பின்னர் பயனர் பகுப்பாய்வு ஒப்புதலை வழங்கிய பிறகு மட்டுமே அந்த நிகழ்வுகளை கிளையன்ட்டிலிருந்து நடத்தை விவரத்துடன் வளப்படுத்துவது. ஒப்புதல் மாறியபோது சர்வர் பக்க மற்றும் கிளையன்ட் பக்க நிகழ்வுகள் அதே தனித்துவ அடையாளங்காட்டியில் இணைகின்றன; ஒப்புதலுக்கு முன், சர்வர் பக்க நிகழ்வுகள் ஒவ்வொரு அமர்விலும் மீட்டமைக்கப்படும் ஒரு அநாமதேய, தற்காலிக அடையாளங்காட்டியுடன் வெளியிடப்படுகின்றன.

ஒருங்கிணைப்பு மற்றும் தணிக்கை சுவடைச் சரிபார்த்தல்

சரிபார்ப்பு படி என்பது ஒழுங்குமுறை அதிகாரிகள் சரிபார்ப்பது மற்றும் வெளியீட்டாளர்கள் அடிக்கடி தவறவிடுவது. சரியாக ஒருங்கிணைக்கப்பட்ட PostHog வரிசைப்படுத்தல் வரிசையில் நான்கு சோதனைகளில் தேர்ச்சி பெற வேண்டும். முதலில், பேனர் காட்டப்பட்ட ஆனால் தேர்வு செய்யப்படாத ஒரு தூய்மையான உலாவி அமர்வு SDK கோப்பு பெறுதலுக்கு அப்பால் கட்டமைக்கப்பட்ட api_host-க்கு பூஜ்ஜிய கோரிக்கைகள், document.cookie-இல் பூஜ்ஜிய ph_ குக்கீகள், மற்றும் localStorage-இல் பூஜ்ஜிய ph_ உள்ளீடுகளை உருவாக்க வேண்டும். இரண்டாவதாக, பகுப்பாய்வை நிராகரிப்பது அந்த நிலையை வைத்திருக்க வேண்டும் — பிடிப்பு இல்லை, பதிவு இல்லை, நிரந்தர அடையாளங்காட்டி இல்லை. மூன்றாவதாக, பகுப்பாய்வை ஏற்றுக்கொள்வது ஒரு உடனடி $opt_in நிகழ்வை, சரியான SameSite பண்புகளுடன் எதிர்பார்க்கப்படும் ph_{projectKey}_posthog நிலைத்தன்மை உள்ளீட்டை, மற்றும் கட்டமைக்கப்பட்ட ஹோஸ்டிற்கு பாயும் நிகழ்வு போக்குவரத்தை உருவாக்க வேண்டும். நான்காவதாக, உண்மைக்குப் பிறகு ஒப்புதலைத் திரும்பப்பெறுவது மேலும் பிடிப்பு மற்றும் மறுஇயக்கத்தை உடனடியாக நிறுத்தி, நிரந்தர அடையாளங்காட்டிகளை காலாவதியாக்கி, பயனர் அழிப்பைப் பயன்படுத்தியிருந்தால் PostHog-இன் GDPR API வழியாக ஒரு நீக்க கோரிக்கையைத் தூண்ட வேண்டும்.

EDPB-இன் 2023 குக்கீ பேனர் வழிகாட்டுதல்கள் மற்றும் புதுப்பிக்கப்பட்ட 2026 பணிக்குழு முன்னுரிமைகளின் கீழ் தணிக்கை-சுவடு எதிர்பார்ப்பு என்னவென்றால், PostHog திட்டத்தில் எந்தவொரு குறிப்பிட்ட நிகழ்விற்கும், அதை உருவாக்கிய பயனர் பிடிப்பு தருணத்தில் சரியான ஒப்புதலை அளித்தார் என்பதை வெளியீட்டாளர் நிரூபிக்க முடியும். நிலையான முறை எந்த தனிப்பட்ட நிகழ்வும் ஒரு குறிப்பிட்ட ஒப்புதல் பதிவு உள்ளீட்டிற்கு திரும்ப கண்காணிக்கக்கூடியதாக இருக்கும்படி posthog.setPersonProperties({ consent_version: 'v3', consent_ts: ts }) வழியாக ஒப்புதல் பதிப்பு மற்றும் நேர முத்திரையை தனித்துவ ID-இல் நபர் பண்புகளாக அமைப்பது. பார்வையாளர்களுடன் பொருந்தும் பகுதி தேர்வு, இயல்பாக memory-க்கு செல்லும் நிலைத்தன்மை, மற்றும் திரும்பப்பெறுதலில் செயல்படும் நீக்க பாதையுடன் இணைந்த சரியாக கேட் செய்யப்பட்ட வரிசைப்படுத்தல், PostHog-ஐ ஒரு ஒழுங்குமுறை குவிப்பு அபாயத்திலிருந்து தயாரிப்பு பகுப்பாய்வு தொகுப்பின் பாதுகாக்கக்கூடிய மையமாக மாற்றுவதாகும்.