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

נושאים, מסגרות מגודרות ואחסון משותף. keywords: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Beginner

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

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

יוני 2023

עלייה של 7% בצבירה פרטית בגרסה היציבה

החל מיום שלישי, 6 ביוני 2023, Private Aggregation API יהיה זמין ב-7% מתנועת הגולשים בגרסת Chrome היציבה. ה-API יהיה זמין בקבוצה הראשית המשולבת של גרסת המקור לניסיון (5%), בקבוצה המבודדת של Protected Audience API (1%) ובקבוצה המבודדת של אחסון משותף (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

הגדלה של 1% ב-Private Aggregation בגרסה היציבה

גרסת המקור לניסיון של 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 + פריימים מגודרים בלבד
Protected Audience API מאוחד – 5% 6% מתנועת הגולשים בסטטוס 'יציב' החל מ-13 במרץ 2023
מבודד – 1% – Protected Audience API + פריימים מגודרים בלבד
Private Aggregation מאוחד – 1% 1% מתנועת הגולשים בסטטוס 'יציב' החל מ-17 באפריל 2023
אחסון משותף (בחירת כתובת URL) מאוחד – 5% 6% מתנועת הגולשים בסטטוס 'יציב' החל מ-13 במרץ 2023
מבודד – 1% – אחסון משותף (בחירת כתובת URL) + מסגרות מגודרות בלבד
נושאים מאוחד – 5% 6% מתנועת הגולשים בסטטוס 'יציב' החל מ-13 במרץ 2023
מבודד – 1% – נושאים בלבד

מרץ 2023

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

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

העלאה של 1% ב-Protected Audience API

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

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

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

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

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

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

הקצאת תנועה

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

API הניסוי המאוחד הנוכחי
הקצאת תנועה
דוחות שיוך (Attribution) 5%
פריימים ללא שיתוף נתונים 5%
Protected Audience API 4%
אחסון משותף (בחירת כתובת 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 + פריימים מגודרים בלבד
Protected Audience API Unified –‏ 5% (4% הקצאה נוכחית + 1% הגדלה הדרגתית) 6% מהתנועה בסביבה היציבה החל מ-16 במרץ 2023
מבודד – 1% – Protected Audience API + פריימים מגודרים בלבד
אחסון משותף
(בחירת כתובת URL) 		מאוחד – 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, גרסת המקור לניסיון של URL Selection API של Shared Storage תגדל ל-5% מתנועת הגולשים בגרסת Chrome Stable.

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

נובמבר 2022

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

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

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

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

דוחות שיוך, 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 בנובמבר.
פריימים מוקפים התכונה זמינה בגרסה היציבה, והיא תגדל ל-5% החל מ-9 בנובמבר.
Shared Storage בשלב זה התכונה זמינה רק בגרסת M105 ואילך של Canary,‏ Dev ו-Beta.

אוקטובר 2022

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

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

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

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

אוגוסט 2022

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

מאי 2022

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

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

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

אפריל 2022

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

ממשקי ה-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

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

  • בוחרים באפשרות התאמה לצד שלישי כשנרשמים לגרסת הטרום-השקה.
  • השדה 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.

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

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

סטטוס הטוקן הוא &#39;הצלחה&#39; והוא לא מופעל.
הסטטוס של האסימון הוא 'הצלחה' והוא לא מופעל.

אם מוצגות הודעות שונות, תוכלו לעיין במאמר פתרון בעיות בגרסת המקור לניסיון של 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 ותכונות ספציפיים, וכן דגלים נוספים להגדרות מפורטות יותר.