Cookie Consent

ویجت Cookie Consent برای مدیریت رضایت کاربر پیش از شروع collection طراحی شده است.

وقتی این Widget در داشبورد فعال باشد و مقدار consentMode روی auto قرار گرفته باشد، SDK پیش از ثبت رضایت visitor هیچ داده رفتاری ارسال نمی‌کند. در این وضعیت، collection تا زمانی که کاربر انتخاب خود را مشخص کند متوقف می‌ماند.

این توقف شامل داده‌ها و رویدادهای اصلی SDK است؛ از جمله:

• pageview
• heatmap
• replay
• goal
• revenue
• log

به این ترتیب، شروع جمع‌آوری داده به تصمیم visitor وابسته می‌شود و SDK پیش از مشخص شدن وضعیت رضایت، collection را آغاز نمی‌کند.

رفتار پس از تصمیم کاربر#

وقتی visitor با بنر Cookie Consent تعامل می‌کند، رفتار SDK بر اساس انتخاب او ادامه پیدا می‌کند.

• اگر کاربر رضایت را بپذیرد، collection آغاز می‌شود و SDK می‌تواند داده‌های رفتاری را مطابق config فعلی ارسال کند.

• اگر کاربر رضایت را رد کند، collection برای همان visitor غیرفعال باقی می‌ماند و داده‌های مربوط به pageview، Heatmap، Replay، Goal، Revenue و Log ارسال نمی‌شوند.

• تصمیم کاربر همراه با version فعلی Widget در storage مرورگر ذخیره می‌شود تا SDK در بازدیدهای بعدی بداند این visitor برای همان نسخه چه انتخابی داشته است.

• تا زمانی که version تغییر نکرده باشد، همان تصمیم قبلی معتبر باقی می‌ماند و بنر دوباره به کاربر نمایش داده نمی‌شود.

مدیریت version#

Version در Cookie Consent مشخص می‌کند تصمیم ذخیره‌شده کاربر مربوط به کدام نسخه از بنر و سیاست رضایت است.

اگر متن، شرایط، ساختار رضایت یا منطق مربوط به Cookie Consent به‌صورت معنادار تغییر کند، می‌توانید version را افزایش دهید.

افزایش version باعث می‌شود تصمیم ذخیره‌شده برای نسخه قبلی، مانع نمایش نسخه جدید نشود و بنر دوباره برای visitor نمایش داده شود.

بهتر است version را فقط زمانی تغییر دهید که واقعاً نیاز دارید کاربر دوباره درباره رضایت خود تصمیم بگیرد؛ نه برای تغییرات جزئی ظاهری یا ویرایشی که معنای رضایت را تغییر نمی‌دهند.

وقتی Widget غیرفعال است#

اگر Cookie Consent در داشبورد غیرفعال باشد، SDK رفتار فوری خود را حفظ می‌کند و collection بدون انتظار برای نمایش یا پاسخ به بنر رضایت ادامه پیدا می‌کند.

در این حالت، Widget در چرخه شروع collection دخالتی ندارد و SDK بر اساس سایر تنظیمات فعال پروژه رفتار می‌کند.

نمونه تنظیم#

برای فعال کردن مدیریت رضایت از طریق Cookie Consent، مقدار consentMode را روی auto قرار دهید:

new UserTracker({
  appId: "YOUR_APP_ID",
  secretKey: "YOUR_APP_SECRET",
  consentMode: "auto",
}).init();

با این تنظیم، SDK وضعیت رضایت را بررسی می‌کند و در صورت فعال بودن Cookie Consent، شروع collection را به تصمیم visitor وابسته می‌کند.

تفاوت auto و disabled#

وقتی consentMode روی auto قرار دارد، SDK می‌تواند از جریان رضایت مدیریت‌شده توسط Cookie Consent استفاده کند.

در مقابل، مقدار زیر:

consentMode: "disabled";

باعث می‌شود منطق بنر رضایت در SDK نادیده گرفته شود و collection بدون انتظار برای تصمیم visitor ادامه پیدا کند.

این انتخاب صرفاً رفتار فنی SDK را مشخص می‌کند و به‌تنهایی تعیین نمی‌کند که محصول شما از نظر حقوقی یا حریم خصوصی به Cookie Consent نیاز دارد یا نه.

نکات اجرایی#

• اگر Cookie Consent برای پروژه فعال است، قبل از انتشار مطمئن شوید متن بنر، دکمه‌های پذیرش و رد و رفتار پس از هر انتخاب به‌درستی تست شده‌اند.

• تغییر version را فقط زمانی انجام دهید که لازم است تصمیم رضایت کاربران دوباره دریافت شود.

• وضعیت ذخیره‌شده consent را در سناریوهای بازدید مجدد، refresh و navigation بین صفحات بررسی کنید.

• اگر پروژه شما سیاست‌های حریم خصوصی یا الزامات حقوقی خاصی دارد، رفتار consentMode را بر اساس همان سیاست‌ها تنظیم کنید و فقط به تنظیم فنی SDK اکتفا نکنید.