לאתרים שמשתתפים באחד או יותר מ- ניסויי הוצאה משימוש של קובצי cookie של צד שלישי, Chrome מספק תקופת חסד כדי להפעיל מחדש באופן זמני קובצי cookie של צד שלישי. במהלך תקופת החסד, אתרים יוכלו גישה לקובצי cookie של צד שלישי ב-Chrome, גם אם הם עדיין לא פרסו תקופת ניסיון לאסימונים אישיים.
ב-Chrome יש גם מנגנון שמאפשר לאתרים לבטל את ההסכמה שלהם לחסד לאחוז מסוים מהמשתמשים. המנגנון לביטול הסכמה יאפשר לאתרים לפעול השקות מדורגות משלהם כדי לעזור להם להפסיק להסתמך על החסד תקופה, כדי לבדוק את הפריסה של אסימון הניסיון להוצאה משימוש ולעבור אל פתרונות לטווח ארוך.
למה מפתחים צריכים את המנגנון לביטול ההסכמה
כשאתר או שירות מקבלים אישור עבור אינטראקציה ישירה (First-Party) או צד שלישי בתקופות ניסיון להוצאה משימוש, Chrome מספק אסימון לניסיון ומפעיל תקופת חסד כדי לאפשר פריסה של אסימונים. תקופת החסד ממשיכה יישארו בתוקף עד שהתוקף שלהם יפוג – גם לאחר פריסת האסימונים. מי יכול להיות בעייתית בבדיקה אם פריסה של אסימון לניסיון בהוצאה משימוש הפעולה הצליחה.
מפתחים יכולים להגדיר סימון של Chrome להשבתת תקופת החסד לבדיקה מקומית של פריסת האסימון, אבל זה לא מתאים לבדיקה קנה מידה. כדי לאפשר לאתרים לבדוק את הפריסה של אסימונים בסביבת הייצור, עכשיו Chrome מתן מנגנון לביטול ההסכמה לתקופת החסד עבור אחוז מסוים משתמשים.
הגדרת אחוזי המשתמשים שביטלו את ההסכמה לתקופת חסד
כדי לבטל את ההסכמה לשימוש בתכונה, צריך לספק הגדרה נגישה לכולם
בקובץ
.well-known
של האתר שלך בכתובת /.well-known/tpcd/grace-period.json
.
הקובץ grace-period.json
מספק אחוזי ביטולי הסכמה עבור אחד או יותר
תקופות חסד לניסיון שהוצא משימוש:
FirstPartyOptOutPercentage
ThirdPartyOptOutPercentage
הערכים האלה יכולים להיות 0, 25, 50 או 100. לדוגמה:
{
"ThirdPartyOptOutPercentage": 25
}
שינוי אחוז ביטול ההסכמה של תקופת החסד לא משפיע על שיעור לקוחות Chrome כפוף למנגנון חסימת מעקב של Chrome, שמגביל קובצי Cookie של צד שלישי ב-1% מ-Chrome הלקוחות שלנו.
לדוגמה: אם אפשרות ההסכמה לתקופת החסד מוגדרת ל-50% לגבי אתר, אז על 0.5% (1% * 50%) מלקוחות Chrome יוגבלו קובצי Cookie של צד שלישי באתר.
בדיקת הפריסה
אם רוצים לבטל את ההסכמה לתקופת החסד, מומלץ
להתחיל באמצעות פריסה של 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 כפופים ל
חסימת מעקב,
קובצי cookie של צד שלישי מ-third-party.example
יוגבלו, אלא אם
תקופת הניסיון להוצאה משימוש של צד שלישי פעילה.
דוגמה של אינטראקציה ישירה
בדוגמה הבאה, first-party.example
נרשם עבור
ניסוי בדומיין של צד ראשון שהוצאה משימוש ותקופת החסד הופעלו עבורם.
הם מארחים את הקובץ הבא ב-
first-party.example/well-known/tpcd/grace-period.json:
{
"FirstPartyOptOutPercentage": 50
}
לאחר מכן, תקופת החסד תושבת ב-50% מ-Chrome לקוחות שמבקרים באתר שלהם. לכל לקוחות Chrome האלה שהם חלק מ קבוצת חסימת המעקב, קובצי Cookie של צד שלישי יוגבלו
למידע נוסף
אם יש לך שאלות לגבי מנגנון ביטול ההסכמה, אפשר לדווח על בעיה בקישור מאגר התמיכה של ארגז החול לפרטיות
- הסבר על ביטול ההסכמה לתקופת חסד לקובצי Cookie של צד שלישי
- 'tpcd/grace-period.json' מזהה משאבים ידוע
- כוונה לשלוח: ביטול ההסכמה לתקופת חסד לקובצי Cookie של צד שלישי
- תקופת ניסיון בהוצאה משימוש של צד ראשון
- ניסיון הוצאה משימוש של צד שלישי
- איך מתחילים לעבוד עם גרסאות מקור לניסיון
- פתרון בעיות בגרסאות המקור לניסיון ב-Chrome
- URI ידוע
- RFC 8615 – מזהי משאבים אחידים (URIs) מוכרים