תקופת ניסיון להוצאה משימוש של התכונה 'הפחתת מידע בסוכן משתמש'

תקופת הניסיון להוצאה משימוש של הפחתת מידע בסוכן משתמש אפשרה לאתרים להמשיך לקבל את המחרוזת המלאה של סוכן המשתמש אחרי שהמרחקנו את המחרוזת של סוכן המשתמש. תקופת הניסיון הסתיימה ב-23 בספטמבר 2023.

החל מגרסה 101 של Chrome, המידע שזמין במחרוזת של סוכן המשתמש (UA) יופחת באמצעות גישה מדורגת. באתרים שלא היה להם זמן לעבור משימוש במחרוזת המקוצרת של סוכן המשתמש ולעבור לרמזים על הלקוח (Client Hints) לגבי סוכן המשתמש, אפשר להשתתף בתוכנית ניסיונית להוצאה משימוש כדי להמשיך לקבל את המחרוזת המלאה של סוכן המשתמש.

ההרשמה לתקופת הניסיון להוצאה משימוש תתחיל בגרסת הבטא של Chrome 100. היא תאפשר לאתרים לקבל את מחרוזת ה-User-Agent המלאה לפני השקת Chrome 101, שבה מחרוזת הגרסה המשנית תופחת. אם אתם רוצים לבדוק את גרסת המקור לניסיון ב-Chrome 100 Beta לפני שהיא תושק בערוץ היציב, חשוב להירשם ולבדוק אותה לפני תאריך ההשקה של Chrome 100 (התאריך המתוכנן כרגע הוא 31 במרץ 2022).

בהמשך מופיעה סקירה כללית של תקופת הניסיון להוצאה משימוש, וגם מה צפוי לקרות. אם יש לכם משוב או אם נתקלת בבעיות במהלך תקופת הניסיון, אפשר לעדכן אותנו במאגר GitHub של UA Reduction.

מה המשמעות מבחינת מפתחי אתרים?

אם תירשמו לתקופת הניסיון להוצאה משימוש, אתרים ימשיכו לקבל את מחרוזת UA המלאה ב-navigator.userAgent וערכים לא מופחתים ב-getters של JavaScript שקשורים ל-navigator.platform ול-navigator.appVersion:

  • כותרת הבקשה User-Agent של HTTP
  • ה-getter של JavaScript‏ navigator.userAgent
  • ה-getter של JavaScript‏ navigator.platform
  • ה-getter של JavaScript‏ navigator.appVersion

עדיין צריך לבדוק את השימוש בכותרת User-Agent וב-APIs קשורים, ואם צריך, להתכונן למעבר לרמזים על הלקוח (Client Hints) לגבי הסוכן המשתמש לפני שתקופת הניסיון להוצאה משימוש תסתיים. הכוונה היא לסיים את תקופת הניסיון הזו להוצאה משימוש אחרי השלמת השקת צמצום המידע בסוכן המשתמש.

איך משתתפים בתוכנית הניסוי להוצאה משימוש של הפחתת מידע בסוכן משתמש?

הרשמה לתקופת הניסיון

כדי להירשם לגרסת המקור לניסיון ולקבל אסימון לדומיינים שלכם, אפשר להיכנס לדף הניסוי של ההוצאה משימוש של קיצור סוכן המשתמש. אם אתם צד שלישי שמירשם, צריך לסמן את האפשרות 'התאמה של צד שלישי'.

הגדרה

אחרי ההרשמה לתקופת הניסיון, צריך לעדכן את כותרות התגובה של HTTP כך שיכללו את הפרטים הבאים:

  1. מוסיפים את Origin-Trial: <ORIGIN TRIAL TOKEN> לכותרת התגובה של HTTP. השדה <ORIGIN TRIAL TOKEN> מכיל את האסימון שקיבלת כשנרשמת לתקופת הניסיון במקור.
  2. מוסיפים את Accept-CH: Sec-CH-UA-Full לכותרת התגובה של HTTP. ההגדרה Accept-CH תגרום לשליחת המחרוזת המלאה של סוכן המשתמש רק בבקשות הבאות למקור.
  3. אם מחרוזת סוכן המשתמש המלאה חיונית בבקשה הראשונה, מוסיפים את Critical-CH: Sec-CH-UA-Full לכותרת התגובה של ה-HTTP, בנוסף לכותרות Accept-CH ו-Origin-Trial.

  4. למשתתפים שמצטרפים לתוכנית הניסיון של ההוצאה משימוש בהפחתת המחרוזות, מומלץ לאפשר לכל הדומיינים של הצד השלישי גישה למחרוזת המלאה של הסוכן המשתמש. אם לא תרחיבו את הגישה של דומיינים של צד שלישי למחרוזת המלאה של סוכן המשתמש, תיחסמו את הגישה שלהם למחרוזת המלאה של סוכן המשתמש, ללא קשר לרישום שלהם לניסוי להוצאה משימוש של קיצור המחרוזת. אתם יכולים לאפשר גישה מלאה של מחרוזת סוכן משתמש לדומיינים של צד שלישי באחת משתי הדרכים הבאות:

    • מוסיפים כותרת Permissions-Policy עם הדומיינים של הצד השלישי שאמורים לקבל את מחרוזת User-Agent המלאה.
      • כדי לאפשר את כל הדומיינים של הצד השלישי, מוסיפים את Permissions-Policy: ch-ua-full=*.
      • כדי לאפשר רשימה בעלת שם של דומיינים של צד שלישי, מוסיפים את Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com").
    • מוסיפים את המטא תג Accept-CH עם הדומיינים של הצד השלישי שאמורים לקבל את המחרוזת המלאה של User-Agent (רק ב-Chrome מגרסה 100 ואילך).
      • כדי לאפשר רשימה בעלת שם של דומיינים של צד שלישי, מוסיפים את <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">.
      • אי אפשר להעניק גישה לכל הדומיינים של הצד השלישי באמצעות * במטא תג.

  5. טוענים את האתר ב-Chrome 100 (או גרסה מתקדמת יותר) וממשיכים לקבל את המחרוזת המלאה של User-Agent.

הדגמה (דמו)

הדגמה של תקופת הניסיון (יחד עם קוד המקור) זמינה בכתובת https://uard-ot-demo.glitch.me.

איך מוודאים שתקופת הניסיון פועלת?

כדי לוודא שגרסת ה-Origin Trial פועלת, בודקים את כותרות הבקשה ומוודאים את הפרטים הבאים:

  1. כותרת User-Agent מכילה את הגרסה המלאה. הוא לא יכול להכיל אף אחד מהערכים המקוצרים (שמצוינים ברשימת הדוגמאות למחרוזות מקוצרות של User-Agent). דרך קלה לבדוק זאת היא לבדוק ששרשור הגרסה המשנית של Chrome לא צריך להיות 0.0.0.
  2. הכותרת Sec-CH-UA-Full מוגדרת ל-?1.

הכותרות של התגובה הראשונית שמכילות את אסימון הניסיון של המקור אמורות להיראות כך:

כותרות הבקשות הבאות שמכילות את המחרוזת המלאה של סוכן המשתמש אמורות להיראות כך:

איך מפסיקים להשתתף בתוכנית הניסיון להוצאה משימוש של הפחתת מידע בסוכן משתמש?

בכל שלב במהלך תקופת הניסיון, תוכלו להפסיק את ההשתתפות ולקבל את המחרוזת המקוצרת של סוכן המשתמש. כדי להפסיק את ההשתתפות:

  1. שולחים כותרת Accept-CH בתגובת ה-HTTP, בלי Sec-CH-UA-Full. הערה: אפשר להשתמש ב-Accept-CH עם ערך ריק כדי להשיג את זה אם האתר לא מבקש רמזים אחרים ללקוח.
  2. מסירים את הכותרת Origin-Trial מתשובת ה-HTTP שלכם לניסיון ההוצאה משימוש של הפחתת מידע בסוכן משתמש.
  3. אם ההגדרה מוגדרת, מסירים את Sec-CH-UA-Full מהכותרת Critical-CH בתגובת ה-HTTP.

מה ההבדל בין תקופת הניסיון הזו לבין תקופות ניסיון אחרות של מקור User-Agent?

ב-Chrome פועלות שתי גרסאות מקור לניסיון שקשורות להפחתת סוכני משתמשים. הניסוי הראשון היה גרסת מקור לניסיון של הפחתת סוכן המשתמש, שאפשרה לאתרים לקבל את המחרוזת המקוצרת של סוכן המשתמש כדי לבדוק את התרחישים לדוגמה שלהם ולספק משוב לפני שהיא תהפוך להתנהגות ברירת המחדל ב-Chrome.

השני, שאליו מתייחסים כאן, הוא תקופת ניסיון להוצאה משימוש המיועדת לאתרים שצריכים עוד קצת זמן כדי לעבור ל-User-Agent Client Hints API. הוא מאפשר לאתרים להמשיך לקבל את המחרוזת המלאה של סוכן המשתמש.

כמה זמן נמשכת תקופת הניסיון לקראת ההוצאה משימוש?

תקופת הניסיון להוצאה משימוש של קיצור סוכן המשתמש תפעל מ-Chrome 100 עד Chrome 115. גרסה 116 של Chrome תהיה הגרסה הראשונה שבה תישלח רק מחרוזת User-Agent מקוצרת לחלוטין.

איך משתפים משוב על תקופת הניסיון של הפחתת סוכני משתמשים?

אפשר לשלוח בעיות או משוב למאגר GitHub של הפחתת מידע בסוכן משתמש.