גרסת מקור מאוחדת לניסיון של רלוונטיות ומדידה

ארגז החול לפרטיות כולל מבחר הצעות שמאפשרות להשתמש בפרסום בלי לבצע מעקב באתרים שונים. ניסויי מקור מאפשרים למפתחים לבדוק טכנולוגיות אינטרנט חדשות ולספק עליהן משוב באמצעות בדיקות בעולם האמיתי. גרסת המקור לניסיון של ארגז החול לפרטיות: רלוונטיות ומדידה מספקת ניסיון יחיד שמאפשר לאתרים להריץ ניסויים מאוחדים ב-Attribution Reporting, ב-Protected Audience API, ב-Topics, ב-Fenced Frames וב-Shared Storage. מפתחים יכולים להירשם לגרסת המקור לניסיון הזו, שמאפשרת לבדוק את Topics API, ‏ Protected Audience API ו-Attribution Reporting API. במדריך הזה מוסבר איך להגדיר גישה לממשקי ה-API, איך לאמת את ההגדרה ואיפה אפשר למצוא משאבים נוספים לבדיקה של ממשקי ה-API.

בדיקת הסטטוס של תקופת הניסיון של התכונה

יוני 2023

השקת Private Aggregation בגרסה יציבה: 7%

‫Private Aggregation API יהיה זמין ב-7% מתנועת הגולשים בגרסה היציבה של Chrome החל מיום שלישי, 6 ביוני 2023. ה-API יהיה זמין בקבוצה הראשית המאוחדת של גרסת המקור לניסיון (5%), בקבוצה המבודדת של Protected Audience (1%) ובקבוצה המבודדת של Shared Storage (1%). הקצאת התנועה לקהל המוגן ולנפח האחסון המשותף לא תשתנה, כי הצבירה הפרטית מתווספת לניסויים מבודדים קיימים.

הקצאת התנועה נכון ליום שלישי, 6 ביוני:

‫API הקצאת תנועה סטטוס
דוחות שיוך (Attribution) מאוחד – 5% ‫6% מהתנועה בגרסה היציבה נכון ל-13 במרץ 2023
מבודד – 1% – רק ב-ARA
מסגרות בלי שיתוף נתונים מאוחד – 5% ‫7% מהתנועה בגרסה היציבה החל מ-13 במרץ 2023
מבודד – 1% – נפח אחסון משותף + צבירה פרטית + מסגרות מוגבלות בלבד
מבודד – 1% – Protected Audience + Private Aggregation + Fenced Frames בלבד
Protected Audience מאוחד – 5% ‫6% מהתנועה בגרסה היציבה נכון ל-13 במרץ 2023
מבודד – 1% – Protected Audience + Private Aggregation + Fenced Frames בלבד
Private Aggregation מאוחד – 5% ‫7% מהתנועה היציבה נכון ל-6 ביוני 2023
מבודד – 1% – Protected Audience + Private Aggregation + Fenced Frames בלבד
מבודד – 1% – נפח אחסון משותף + צבירה פרטית + מסגרות מוגבלות בלבד
Shared Storage מאוחד – 5% ‫6% מהתנועה בגרסה היציבה נכון ל-13 במרץ 2023
מבודד – 1% – נפח אחסון משותף + צבירה פרטית + מסגרות מוגבלות בלבד
נושאים מאוחד – 5% ‫6% מהתנועה בגרסה היציבה נכון ל-13 במרץ 2023
מבודד – 1% – נושאים בלבד

עדכונים קודמים

כדאי לעיין בעדכונים הקודמים לגבי תקופת הניסיון של התכונה.

אפריל 2023

השקת Private Aggregation ב-Stable עם הגדלה הדרגתית של נפח התנועה (ramp-up) בשיעור של 1%

גרסת המקור לניסיון של Private Aggregation API תהיה זמינה ב-1% מתנועת הניסוי המאוחדת של Chrome Stable החל מיום שני, 17 באפריל. הפונקציה sendHistogramReport() של Private Aggregation זמינה לשימוש ב-worklets של Protected Audience API ושל Shared Storage.

הקצאת התנועה תיראה כך החל מיום שני, 17 באפריל:

‫API הקצאת תנועה סטטוס
דוחות שיוך (Attribution) מאוחד – 5% ‫6% מהתנועה היציבה החל מ-13 במרץ 2023
מבודד – 1% – רק ב-ARA
מסגרות בלי שיתוף נתונים מאוחד – 5% ‫7% מהתנועה היציבה החל מ-13 במרץ 2023
מבודד – 1% – אחסון משותף (בחירת כתובת URL) + מסגרות מגודרות בלבד
מבודד – 1% – Protected Audience API + Fenced Frames בלבד
Protected Audience API מאוחד – 5% ‫6% מהתנועה היציבה החל מ-13 במרץ 2023
מבודד – 1% – Protected Audience API + Fenced Frames בלבד
Private Aggregation מאוחד – 1% ‫1% מהתנועה היציבה החל מ-17 באפריל 2023
Shared Storage (בחירת כתובת URL) מאוחד – 5% ‫6% מהתנועה היציבה החל מ-13 במרץ 2023
מבודד – 1% – אחסון משותף (בחירת כתובת URL) + מסגרות מגודרות בלבד
נושאים מאוחד – 5% ‫6% מהתנועה היציבה החל מ-13 במרץ 2023
מבודד – 1% – נושאים בלבד

מרץ 2023

עדכון ציר הזמן

הודענו בתחילה שנתחיל את הניסויים המבודדים ביום שני, 13 במרץ 2023, אבל הניסויים החדשים יתחילו עכשיו ביום חמישי, 16 במרץ 2023, כי נדרש זמן נוסף להגדרת הניסויים. ההגדלה של השימוש ב-Protected Audience API מ-4% ל-5% (1%) תתרחש גם ביום חמישי, 16 במרץ 2023.

הגדלת היקף השימוש ב-Protected Audience API ל-1%

בחודש שעבר הפחתנו באופן זמני את תנועת הגולשים בגרסת המקור לניסיון של Protected Audience API מ-5% ל-4% בגרסה היציבה של Chrome לצורך בדיקה. הבדיקה הראשונית הסתיימה, ואנחנו מתכננים להגדיל את השימוש ב-Protected Audience API מ-4% ל-5% במסגרת הניסוי המאוחד ביום חמישי, 16 במרץ 2023.

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

ניסויים מבודדים

כדי לשפר את תהליך הבדיקה שלנו ולהמשיך לעקוב אחרי המדדים של ממשקי API של ניסויים ב-Origin, אנחנו יוצרים ניסויים מבודדים לכל API, בנוסף לניסוי המאוחד הקיים. ניסויים חדשים ייווצרו עבור Attribution Reporting, ‏ Topics, ‏ שילוב של Protected Audience API ו-Fenced Frames, ושילוב של פעולת בחירת כתובות URL של Shared Storage ו-Fenced Frames. בכל ניסוי מבודד, רק ממשקי ה-API שהוקצו יהיו זמינים למשתמשים בקבוצה הזו.

API הקצאת תנועה
לניסוי מבודד
דוחות שיוך (Attribution) 1%
Protected Audience API + Fenced Frames 1%
Shared Storage (בחירת כתובת URL) + Fenced Frames 1%
נושאים 1%

החל מיום חמישי, 16 במרץ, תתחיל לקבל עוד 1% מהתנועה בגרסה היציבה של Chrome עבור ממשקי ה-API שצוינו למעלה, בנוסף ל-5% מהתנועה שאתה מקבל מהניסוי המאוחד הקיים. משתמשים חדשים יוקצו לכל ניסוי.

הקצאת תנועה

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

API הקצאת התנועה בניסוי המאוחד הנוכחי
דוחות שיוך (Attribution) 5%
מסגרות בלי שיתוף נתונים 5%
Protected Audience API 4%
Shared Storage (בחירת כתובת URL) 5%
נושאים 5%

הקצאת התנועה תיראה כך החל מיום חמישי, 16 במרץ, אחרי ש-Protected Audience API יופעל מחדש והניסויים המבודדים החדשים יתחילו:

API הקצאת תנועה חדשה סטטוס
דוחות שיוך (Attribution) מאוחד – 5% ‫6% מהתנועה היציבה החל מ-16 במרץ 2023
מבודד – 1% – רק ב-ARA
מסגרות בלי שיתוף נתונים מאוחד – 5% ‫7% מהתנועה בגרסה היציבה החל מ-16 במרץ 2023
מבודד – 1% – אחסון משותף (בחירת כתובת URL) + מסגרות מגודרות בלבד
מבודד – 1% – Protected Audience API + Fenced Frames בלבד
Protected Audience API מאוחד – 5% (הקצאה נוכחית של 4% + 1% חזרה להגדלה) ‫6% מהתנועה היציבה החל מ-16 במרץ 2023
מבודד – 1% – Protected Audience API + Fenced Frames בלבד
Shared Storage
(URL Selection) 		מאוחד – 5% ‫6% מהתנועה היציבה החל מ-16 במרץ 2023
מבודד – 1% – אחסון משותף (בחירת כתובת URL) + מסגרות מגודרות בלבד
נושאים מאוחד – 5% ‫6% מהתנועה היציבה החל מ-16 במרץ 2023
מבודד – 1% – נושאים בלבד

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

ינואר 2023

כחלק מחקירת רגרסיה ב-Chrome, נצמצם באופן זמני את תנועת הגולשים בגרסת המקור לניסיון של Protected Audience API מ-5% ל-4% ב-Chrome Stable, החל מ-26 בינואר 2023. להערכתנו, הבדיקה תימשך כחודש, ונודיע לך כשתנועת הגולשים תחזור לרמה הרגילה.

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

בנוסף, החל מ-26 בינואר 2023, גרסת המקור לניסיון של Shared Storage's URL Selection API תורחב ל-5% מתנועת הגולשים בגרסה היציבה של Chrome.

API הערות
דוחות שיוך (Attribution) זמין בגרסה יציבה, עלה ל-5% החל מ-26 באוקטובר 2022.
נושאים זמין בגרסה יציבה, עלה ל-5% החל מ-26 באוקטובר 2022.
Protected Audience API זמין בגרסה יציבה, עם ירידה זמנית ל-4% החל מ-26 בינואר 2023.
Fenced Frames התכונה זמינה בגרסה יציבה, והחל מ-9 בנובמבר 2022 היא תהיה זמינה ל-5% מהמשתמשים.
Shared Storage זמין בגרסה יציבה, עם עלייה של 5% החל מ-26 בינואר 2023.

נובמבר 2022

החל מ-9 בנובמבר, ‏API‏ ‏selectURL‏ של Shared Storage יצטרף לגרסת המקור לניסיון ב-1% מתנועת הגולשים ב-Chrome Stable.

כפי שפורסם בפוסט בבלוג הגדלת גרסת המקור לניסיון של ארגז החול לפרטיות בנושא רלוונטיות ומדידה ל-5%, ממשקי ה-API של Attribution Reporting ו-Topics מופעלים עכשיו ב-5% מהתנועה. ב-9 בנובמבר יופעלו גם ממשקי ה-API של Protected Audience ו-Fenced Frames ב-5% מהתנועה.

API הערות
דוחות שיוך (Attribution) זמין בגרסה היציבה, והחל מ-26 באוקטובר הוא גדל ל-5%.
נושאים זמין בגרסה היציבה, והחל מ-26 באוקטובר הוא גדל ל-5%.
Protected Audience API זמין בגרסה יציבה, ושיעור החשיפה יעלה ל-5% החל מ-9 בנובמבר.
Fenced Frames זמין בגרסה יציבה, ושיעור החשיפה יעלה ל-5% החל מ-9 בנובמבר.
Shared Storage התכונה תהיה זמינה בגרסה היציבה, החל מ-1% מהמשתמשים מ-9 בנובמבר.

אוקטובר 2022: עלייה של 5%

התכונות Attribution Reporting,‏ Topics,‏ Protected Audience API ו-Fenced Frames זמינות כרגע בגרסה היציבה של Chrome ויהיו חלק מהתנועה המוגברת.

החל מהשבוע הזה, נתחיל להגדיל את נפח התנועה של Attribution Reporting ו-Topics. נפח התנועה של Protected Audience API ו-Fenced Frames יגדל החל מ-9 בנובמבר.

מידע נוסף זמין בפוסט בבלוג בנושא הגדלת הרלוונטיות של ארגז החול לפרטיות וגרסת המקור לניסיון של המדידה ל-5%.

API הערות
דוחות שיוך (Attribution) זמין בערוץ היציב, ויעלה ל-5% אחרי 26 באוקטובר.
נושאים זמין בערוץ היציב, ויעלה ל-5% אחרי 26 באוקטובר.
Protected Audience API זמין בגרסה יציבה, ושיעור החשיפה יעלה ל-5% החל מ-9 בנובמבר.
Fenced Frames זמין בגרסה יציבה, ושיעור החשיפה יעלה ל-5% החל מ-9 בנובמבר.
Shared Storage בשלב הזה, התכונה זמינה רק בגרסאות Canary, ‏ Dev ו-Beta של Chrome M105 ומעלה.

אוקטובר 2022

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

ציר הזמן הכולל של ארגז החול לפרטיות נשאר ללא שינוי.

ממשקי ה-API שכלולים בתקופת הניסיון:

API הערות
דוחות שיוך (Attribution) מדריך למפתחים בנושא תקופת הניסיון של התכונה
Protected Audience API מדריך למפתחים בנושא תקופת הניסיון של התכונה
נושאים מדריך למפתחים בנושא תקופת הניסיון של התכונה
Fenced Frames הנחיות לשימוש בגרסת המקור לניסיון של Protected Audience API
Shared Storage בשלב הזה, התכונה זמינה רק בגרסאות Canary, ‏ Dev ו-Beta של Chrome M105 ומעלה.

אוגוסט 2022

  • הזמינות של תקופת הניסיון של מקורות גדלה בהדרגה עד 1% ממשתמשי המחשב ב-Chrome Stable 104.
  • כשמשתמשים בנייד יוכלו להשתמש בתוסף, נפרסם עדכונים.
  • ערוצים לפני גרסה יציבה (Canary, ‏ Beta) נשארים ב-50% מהמשתמשים.
  • ממשקי API לא זמינים ב-Chrome ל-iOS.

מאי 2022

הזמינות של גרסת המקור לניסיון עולה בהדרגה עד 50% מהמשתמשים מגרסת Chrome 102 Beta.

ממשקי ה-API שכלולים בתקופת הניסיון:

API הערות
דוחות שיוך (Attribution) מדריך למפתחים בנושא תקופת הניסיון של התכונה
Protected Audience API מדריך למפתחים בנושא תקופת הניסיון של התכונה
נושאים מדריך למפתחים בנושא תקופת הניסיון של התכונה התכונה 'נושאים' הושבתה לזמן קצר בניסוי המקור בגלל באג שהשפיע על יציבות הדפדפן.
Fenced Frames הוספנו את התכונה Fenced Frames לניסוי המקור. הנחיות לשימוש בניסויים ב-Protected Audience API

אפריל 2022

גרסת המקור לניסיון מתחילה עם חלק מוגבל מהמשתמשים מגרסת הבטא של Chrome 102.

ממשקי ה-API שכלולים בתקופת הניסיון:

API הערות
דוחות שיוך (Attribution) פוסט בנושא הכוונה להתנסות (I2E). התכונה 'דוחות שיוך' זמינה גם כניסוי מקור נפרד.
Protected Audience API פוסט בנושא הכוונה להתנסות (I2E). ‫Protected Audience API זמין רק במחשב עם קבוצת משנה של פונקציות.
נושאים פוסט בנושא הכוונה להתנסות (I2E).

הרשמה לניסוי המקור והגדרתו

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

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

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

משתמשים בתג <meta> בקטע <head> של הדף:

<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">

אפשרות אחרת היא לכלול את כותרת ה-HTTP הבאה בתגובה של הדף:

Origin-Trial: TOKEN_GOES_HERE

הגדרה באמצעות iframe

אם אתם משתמשים בתכונות של גרסת מקור לניסיון בתוך iframe (כמו joinAdInterestGroup() של Protected Audience API), צריך לספק את האסימון בתוך ה-iframe והוא צריך להתאים למקור של ה-iframe.

הגדרה של מעקב חוצה-אתרים באמצעות JavaScript

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

  • כשנרשמים לתקופת הניסיון של התכונה origin, בוחרים באפשרות Third-party matching.
  • בשדה Web Origin צריך להזין את המקור של הסקריפט.
  • מזריקים את התג <meta> לדף ברמה העליונה (כלומר, לדף של צד ראשון, לא לתוכן שלכם) מהסקריפט. לדוגמה:
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);

ניפוי באגים בגרסת המקור לניסיון

אפשר לבדוק את הסטטוס של תקופת ניסיון של תכונה בDevTools > בחלונית Applications.

סטטוס הטוקן הוא &#39;הצלחה&#39; והוא מופעל.
הסטטוס של הטוקן הוא 'הצלחה' ומופעל.
  1. גוללים למטה לחלונית מסגרות.
  2. בוחרים את המסגרת שבה רוצים להגדיר את האסימון. לדוגמה, המסגרת העליונה של הדף ברמה העליונה או ה-iframe הספציפי של דפים מוטמעים.
  3. בחלונית השמאלית, גוללים למטה לקטע Origin Trials.
  4. אמורה להופיע רשומה של תקופת הניסיון של PrivacySandboxAdsAPIs.
  5. מרחיבים את הרשומה הזו כדי לראות את הסטטוס של תקופת הניסיון של התכונה ואת האסימונים הספציפיים שלכם.

תקופת הניסיון מוגבלת לחלק קטן ממשתמשי Chrome, ויכול להיות שהדפדפן שלכם לא נכלל בקבוצת הניסוי. כתוצאה מכך, יכול להיות שתופיע הודעה אדומה TrialNotAllowed לצד PrivacySandboxAdsAPIs. כשמרחיבים את הרשומה כדי לבדוק את סטטוס האסימון, אם מופיעה הודעה ירוקה Success, ההגדרה של תקופת הניסיון של המקור תקינה. משתמשים שעומדים בדרישות יראו את ההודעה שמוגדרת לEnabled.

סטטוס הטוקן הוא Success (הצלחה) והוא לא מופעל.
סטטוס הטוקן הוא Success (הצלחה) והוא לא מופעל.

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

זיהוי תכונות

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

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // Attribution Reporting enabled
}

if ('runAdAuction' in navigator) {
  // Protected Audience API enabled
}

if ('browsingTopics' in document) {
  // Topics enabled
}

if ('HTMLFencedFrameElement' in window) {
  // Fenced Frames enabled
}

if ('sharedStorage' in window) {
  // Shared Storage enabled
}

if (window?.sharedStorage?.selectURL instanceof Function) {
  // optionally check specifically for the selectURL function in Shared Storage
}

איך בודקים אם משתמש עומד בדרישות

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

הגדרות דפדפן

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

  • להשתמש בגרסה ובערוץ של Chrome שבהם פועלת גרסת המקור לניסיון.

  • להיות חלק מקבוצת הניסוי הפעילה ב-Chrome.

הגדרות משתמש

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

  • התכונות הניסיוניות של ארגז החול לפרטיות מופעלות דרך 'הגדרות' > 'אבטחה ופרטיות' > 'ארגז חול לפרטיות'. אפשר גם לגשת אליהן דרך chrome://settings/adPrivacy.
  • קובצי Cookie של צד שלישי מופעלים דרך הגדרות > אבטחה ופרטיות > קובצי Cookie ונתונים נוספים מאתרים, ומוגדרים לאחת מהאפשרויות 'אישור כל קובצי ה-Cookie' או 'חסימת קובצי Cookie של צד שלישי במצב אנונימי'. אפשר לגשת להגדרות גם דרך chrome://settings/cookies.
  • להיות בסשן גלישה רגיל ולא במצב פרטי.

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

שליטה בהשתתפות בתקופת הניסיון של התכונה

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

הגישה המומלצת היא:

  1. כוללים את האסימונים של תקופת הניסיון של התכונה כברירת מחדל בכל ההקשרים שבהם רוצים לבצע ניסוי.
  2. משתמשים בזיהוי תכונות כדי לבדוק אם יש ממשקי API פעילים.
  3. אם ממשקי ה-API פעילים (ולכן הדפדפן עומד בדרישות להשתתפות בניסוי הזה), אתם יכולים לבחור אם להשתמש בהם או לא על סמך הקריטריונים של הניסוי שלכם. לדוגמה, אם כבר יש לכם תשתית לבדיקות A/B כדי לבצע ניסויים על אחוז מסוים מהתנועה, על דגימה או על מאפיין אחר, בשלב הזה תוכלו להחליט באילו תכונות תשתמשו באופן פעיל.

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

שליטה בגרסת מקור לניסיון לפי אזור גיאוגרפי

אי אפשר לבטל את ההשתתפות בגרסת מקור לניסיון באזורים ספציפיים. ניסויים ב-Origin פעילים בדפים שכוללים את הטוקן, שמופיע דרך כותרות HTTP (בצד השרת) או מטא תגי HTML (בצד הלקוח).

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

עם זאת, מקור ספציפי לאזור גיאוגרפי יכול להגדיר מדיניות הרשאות כדי לקבוע באילו תכונות אפשר להשתמש. לדוגמה, us.example.com ו-uk.example.com הם מקורות ספציפיים גיאוגרפית שאפשר לשלוט בהם. המשמעות היא שאזור מסוים לא הצטרף לגרסת המקור לניסיון.

באמצעות מדיניות הרשאות, אתר מוסיף קטע קוד קטן לדפים שלו שמספק הוראות לדפדפן. כשהדף נטען, הדפדפן קורא את ההוראות של מדיניות ההרשאות ויאפשר או יחסום תכונות (או ממשקי API) בהתאם למדיניות ההרשאות. אם בעל אתר רוצה להגביל API באזור מסוים, המפתח יכול להגדיר מדיניות לכל הדפים שמתבקשים מהאזור הזה.

חידוש הטוקן

תוקף האסימונים של תקופת הניסיון מסוג Origin יפוג שישה שבועות מתאריך ההנפקה שלהם (או בסוף תקופת הניסיון, אם זה קורה מוקדם יותר).

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

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

בדיקה מקומית

הנחיות ספציפיות לבדיקות מקומיות של מפתחים זמינות במאמרים הבאים:

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

  • להשתמש בגרסה ובערוץ של Chrome שבהם התכונות זמינות.
  • מפעילים את כל ממשקי ה-API לשמירה על פרטיות בפרסום בקטע chrome://settings/adPrivacy.

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