مکانیزم انصراف برای دوره مهلت آزمایشی لغو کوکی شخص ثالث

برای سایت‌هایی که در یکی از آزمایش‌های لغو کوکی‌های شخص ثالث شرکت می‌کنند، Chrome مهلتی برای فعال کردن موقت کوکی‌های شخص ثالث فراهم می‌کند. در طول دوره مهلت، سایت‌ها می‌توانند به کوکی‌های شخص ثالث در Chrome دسترسی داشته باشند، حتی اگر هنوز توکن‌های آزمایشی را اجرا نکرده باشند.

کروم همچنین مکانیزمی را ارائه می‌کند که به سایت‌ها اجازه می‌دهد از دوره مهلت برای درصدی از کاربران انصراف دهند. مکانیسم انصراف سایت‌ها را قادر می‌سازد تا راه‌اندازی‌های مرحله‌ای خود را اجرا کنند تا به آنها کمک کند تا از اتکا به دوره مهلت دور شوند تا بکارگیری توکن آزمایشی منسوخ را آزمایش کنند و به سمت راه‌حل‌های بلندمدت حرکت کنند.

چرا توسعه دهندگان به مکانیزم انصراف نیاز دارند

وقتی سایت یا سرویسی برای دوره‌های آزمایشی منسوخ شدن شخص اول یا شخص ثالث تأیید می‌شود، Chrome یک نشانه آزمایشی ارائه می‌کند و یک دوره مهلت را آغاز می‌کند تا زمانی را برای استقرار نشانه‌ها فراهم کند. دوره مهلت تا زمان انقضای آن همچنان به قوت خود باقی می ماند - حتی پس از استقرار توکن ها. این می تواند برای آزمایش موفقیت آمیز بودن استقرار توکن آزمایشی منسوخ شدن مشکل ساز باشد.

توسعه‌دهندگان می‌توانند پرچم کروم را برای غیرفعال کردن دوره مهلت برای آزمایش استقرار رمز به صورت محلی تنظیم کنند، اما این برای آزمایش در مقیاس مناسب نیست. برای فعال کردن سایت‌ها برای استقرار توکن تست تولید، کروم اکنون مکانیزمی برای انصراف از دوره مهلت برای درصدی از کاربران ارائه می‌کند.

درصدهای انصراف دوره مهلت را پیکربندی کنید

برای شرکت در انصراف، یک فایل پیکربندی در دسترس عموم را در فهرست .well-known سایت خود در /.well-known/tpcd/grace-period.json ارائه دهید. فایل grace-period.json درصدهای انصراف را برای هر یک یا هر دو دوره مهلت آزمایشی منسوخ ارائه می دهد:

  • FirstPartyOptOutPercentage
  • ThirdPartyOptOutPercentage

اینها می توانند مقادیر 0، 25، 50 یا 100 داشته باشند. به عنوان مثال:

{
  "ThirdPartyOptOutPercentage": 25
}

تغییر درصد انصراف دوره مهلت بر نسبت مشتریان Chrome که تحت مکانیسم محافظت از ردیابی Chrome هستند، تأثیری نمی‌گذارد، که کوکی‌های شخص ثالث را برای 1٪ از مشتریان Chrome محدود می‌کند.

به عنوان مثال: اگر انصراف از دوره مهلت برای یک وب‌سایت روی 50٪ تنظیم شده باشد، 0.5٪ (1٪ * 50٪) از مشتریان Chrome کوکی‌های شخص ثالث را در سایت محدود می‌کنند.

استقرار آزمایشی

اگر می‌خواهید از انصراف دوره مهلت استفاده کنید، توصیه می‌کنیم در اسرع وقت با استفاده از grace-period.json با مقدار 0 برای یک یا هر دو کلید شروع کنید. این به شما امکان می‌دهد بدون تأثیر بر فعال‌سازی دوره مهلت، تأیید کنید که آیا Chrome فایل را همانطور که انتظار می‌رود پردازش می‌کند یا خیر. بعد از آماده شدن می توانید شروع به افزایش درصد کنید. در آینده قصد داریم ابزارهایی را برای توسعه‌دهندگان فراهم کنیم تا وضعیت فعال‌سازی دوره مهلت را برای سایت‌هایی که توسط مرورگرشان به آن‌ها دسترسی دارند، پرس و جو کنند.

فایل grace-period.json باید به خوبی شکل گرفته باشد تا بتواند تاثیرگذار باشد. برای جلوگیری از خطا، فایل خود را با ابزار اعتبارسنجی انصراف از دوره مهلت بررسی کنید.

زیر دامنه ها

همانطور که در مثال های زیر نشان داده شده است، دامنه انصراف با محدوده مبدأ ثبت شده برای آزمایش منسوخ شدن یکسان است. اگر ثبت نام آزمایشی منسوخ، تطبیق دامنه فرعی را فعال کرده باشد، انصراف از دوره مهلت برای مبدأ ثبت‌شده و زیر دامنه‌های آن اعمال می‌شود.

فایل پیکربندی .well-known/tpcd/grace-period.json باید در مبدا ثبت شده برای آزمایش منسوخ شدن میزبانی شود.

مبدا ثبت شده تطابق زیر دامنه؟ فایل پیکربندی محدوده انصراف
https://foo.example خیر https://foo.example/.well-known/tpcd/grace-period.json https://foo.example
https://sub.foo.example خیر https://sub.foo.example/.well-known/tpcd/grace-period.json https://sub.foo.example
https://foo.example بله https://foo.example/.well-known/tpcd/grace-period.json https://*.foo.example

اشکال زدایی مکانیزم انصراف

سرورهای Google به طور مرتب فایل grace-period.json را (در صورت وجود) در هر سایتی که دوره مهلت برای آن فعال است بررسی می کنند. سپس درصدهای انصراف را می‌توان بین همه مشتریان Chrome توزیع کرد، اگرچه ممکن است تکمیل این فرآیند 24 تا 48 ساعت طول بکشد. Chrome ابزاری ارائه می‌کند تا توسعه‌دهندگان سایت بتوانند وضعیت فعال‌سازی دوره مهلت را از پانل مشکلات ابزارهای توسعه‌دهنده Chrome بررسی کنند تا بفهمند چه زمانی انصراف در حال اجرا است.

نمونه ها

مثال شخص ثالث

در مثال زیر، third-party.example برای آزمایشی منسوخ شدن شخص ثالث ثبت نام کرده و مهلت برای آنها فعال شده است. آنها فایل زیر را در third-party.example/well-known/tpcd/grace-period.json:

{
  "ThirdPartyOptOutPercentage": 25
}

با وجود این فایل، مهلت مهلت برای 25 درصد از مشتریان Chrome که به سایت‌ها یا خدمات از third-party.example دسترسی دارند غیرفعال می‌شود. برای کلاینت‌های Chrome که مشمول «محافظت ردیابی» هستند، کوکی‌های شخص ثالث از third-party.example محدود خواهند شد، مگر اینکه نسخه آزمایشی منسوخ شدن شخص ثالث فعال باشد.

مثال شخص اول

در مثال زیر، first-party.example برای آزمایشی منسوخ شدن شخص اول ثبت نام کرده و مهلت برای آنها فعال شده است. آنها فایل زیر را در first-party.example/well-known/tpcd/grace-period.json:

{
  "FirstPartyOptOutPercentage": 50
}

با وجود این، مهلت برای 50٪ از مشتریان Chrome که از سایت آنها بازدید می کنند غیرفعال می شود. برای هر یک از این کلاینت‌های Chrome که بخشی از گروه حفاظت از ردیابی هستند، کوکی‌های شخص ثالث محدود خواهند شد.

بیشتر بدانید

اگر در مورد مکانیسم انصراف سؤالی دارید، مشکلی را در مخزن پشتیبانی Privacy Sandbox ثبت کنید.