کتابخانه
@segment/analytics-consent-wrapper-onetrust یه بسته npm با مجوز MIT برای سایت هایی هست که هم از Segment برای آنالیتیکس استفاده می کنن و هم از OneTrust برای گرفتن رضایت کاربر. کارش اینه که ارسال داده های Segment رو با انتخاب کاربر توی پنجره رضایت کوکی هماهنگ کنه.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
۴۳۶ کیلوبایت· ۱۸ فایل· انتشار
SHA-256: b4a61473031683dd45d8a9af4a246ebff36b4187b801606746f3987a7723ed09
@segment/analytics-consent-wrapper-onetrust یه لایه واسط بین کتابخونه Analytics.js سگمنت و پنجره رضایت OneTrust هست. فرض کن کاربر توی بنر کوکی فقط کوکی های ضروری رو قبول کرده. اون موقع سایتت نباید رویدادهای تبلیغاتی یا تحلیلی رو برای ابزارهای جانبی بفرسته. بدون این بسته باید خودت کد چسب بنویسی که انتخاب های OneTrust رو بخونه و بر اساسش Segment رو کنترل کنه. این بسته همین کار تکراری رو جمع و جور انجام می ده.
مناسب کیه؟ کسی که تو پروژه اش از Segment استفاده می کنه، رضایت رو با OneTrust مدیریت می کنه و مخاطبی داره که قوانین حریم خصوصی براش مهمه، مثلا کاربرهای اروپایی. یه فروشگاه یا اپلیکیشن وب که به خارج از ایران هم سرویس می ده نمونه خوبیه. اگه سایتت از هیچ کدوم از این دو سرویس استفاده نمی کنه، این بسته به دردت نمی خوره. خودش هم بنر نشون نمی ده، یعنی پنجره رضایت رو باید جدا توی OneTrust بسازی و تنظیم کنی.
موقع انتخاب و استفاده چند نکته رو یادت باشه. اول اینکه بسته روی کتابخونه analytics-next سگمنت سوار می شه، پس چک کن با روش بارگذاری فعلی پروژه ات جور باشه. دوم اینکه دسته بندی های رضایت باید هم سمت OneTrust و هم سمت Segment درست تعریف شده باشن و با هم بخونن. وگرنه ممکنه رویدادی که نباید بره، بره، یا رویدادی که باید بره، گم بشه. سوم اینکه بعد از راه اندازی حتما توی تب Network مرورگر امتحان کن: یه بار همه دسته ها رو رد کن، یه بار همه رو قبول کن و ببین چه درخواست هایی می ره. یادت باشه فقط با نصب این بسته نمی شه مطمئن بود همه چیز با قوانین حریم خصوصی جور شده.
یه نکته هم برای شرایط ایران. خود OneTrust و Segment سرویس های خارجی هستن و بسته به شرایط شبکه ممکنه کند بشن یا در دسترس نباشن. ولی خود این بسته فقط کد جاوااسکریپته و می تونی فایلش رو کنار بقیه وابستگی های پروژه ات نگه داری، پس بیلد و استقرار لازم نیست هر بار منتظر npm بین الملل بمونه. نسخه های رسمی و بدون تغییر این بسته توی مخزن داخلی ما هم هست و وقتی دسترسی به منبع اصلی مشکل داره، می تونی از همون استفاده کنی.
این بسته باید کنار تنظیمات OneTrust و Segment استفاده بشه، نه به جای اون ها. مسیر کلی کار این شکلیه:
اگه نتیجه با انتظارت جور نبود، اول نقشه دسته بندی ها رو بررسی کن، چون بیشتر مشکل ها از ناهماهنگی همون جاست.
این بسته انتخاب کاربر توی پنجره رضایت OneTrust رو با Segment هماهنگ می کنه. یعنی بر اساس دسته هایی که کاربر قبول کرده، مشخص می شه داده ها برای ابزارهای مختلف Segment ارسال بشن یا نه. خودش بنر رضایت نمی سازه و فقط واسط بین OneTrust و Segment هست.
نه، به درد نمی خوره. بسته دقیقا برای ترکیب این دو سرویس ساخته شده. اگه فقط یکی از اون ها رو داری، یا برای رضایت کوکی و آنالیتیکس سراغ ابزار دیگه ای رفتی، باید راهکار مناسب همون ابزار رو پیدا کنی.
نه. پنجره رو خود OneTrust نمایش می ده و تنظیماتش رو هم از پنل OneTrust انجام می دی. این بسته فقط انتخاب کاربر رو می خونه و رفتار Segment رو باهاش هماهنگ می کنه، پس اول باید خود OneTrust روی سایت درست کار کنه.
فقط اگه سایتت Segment و OneTrust رو داره و کاربرهایی داره که رضایت کوکی براشون مهمه. بیشتر سایت های وردپرسی ایرانی به این ترکیب نیاز ندارن. اگه داری، بسته رو مثل یه کتابخونه جاوااسکریپت توی قالب یا پروژه ات بارگذاری کن.
با حالت ناشناس مرورگر دو حالت رو امتحان کن: یکی با رد کردن همه دسته ها و یکی با قبول کردن همه. بعد توی تب Network ببین درخواست های Segment و مقصدهاش توی هر حالت چه فرقی دارن. اگه فرقی نبود، نقشه دسته بندی ها رو دوباره چک کن.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.