Topics API: כלים לבדיקה ולניתוח

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

הצגת מידע על Topics API

הדף chrome://topics-internals יהיה זמין ב-Chrome במחשב אחרי הפעלת Topics API. כאן מוצגים נושאים של המשתמש הנוכחי, נושאים שנגזרו משמות מארח ומידע טכני על הטמעת ה-API. אנחנו חוזרים על העיצוב של הדף ומשפרים אותו על סמך משוב מהמפתחים. אתם יכולים לעזור בעיצוב Topics API על ידי שליחת משוב כבאג ב-Chromium.

הצגת נושאים שזוהו בדפדפן

המשתמשים יכולים לראות מידע על נושאים שנצפו בדפדפן שלהם בתקופת הזמן הנוכחית ובתקופת הזמן הקודמת (epoch) באמצעות צפייה ב-chrome://topics-internals.

הדף chrome://topics-internals שבו נבחרה החלונית של מצב הנושאים.
בחלונית chrome://topics-internals 'מצב הנושאים בדף' מוצגים מזהי נושאים, הקצאות נושאים אקראיות ואמיתיות, וטקסונומיה וגרסאות של מודלים.

בצילום המסך הזה מוצגים אתרים שבהם ביקרתם לאחרונה, כולל topics-demo-cats.glitch.me ו-cats-cats-cats-cats.glitch.me. כתוצאה מכך, Topics API יבחר את Pets ואת Cats כשני הנושאים המובילים בתקופה הנוכחית. שלושת הנושאים הנותרים נבחרו באופן אקראי, כי אין מספיק היסטוריית גלישה (באתרים שמזהים נושאים) כדי לספק חמישה נושאים.

בעמודה דומיינים שנצפו על ידי הקשר (מגובבים) מוצג הערך המגובב של שם המארח שנושא מסוים תועד.

הצגת נושאים שהוסקו לגבי שמות מארחים

אפשר גם להציג את הנושאים שהמערכת הסיקה באמצעות מודל הסיווג של Topics עבור שם מארח אחד או יותר בקובץ chrome://topics-internals.

הדף chrome://topics-internals שבו נבחרה חלונית המסווג.
בחלונית chrome://topics-internals של הסיווג של הדף מוצגים הנושאים שנבחרו, המארחים שנצפו, גרסת המודל והנתיב שלו.

ההטמעה הנוכחית של Topics API מסיקה נושאים משמות מארחים בלבד; לא מחלק אחר של כתובת URL.

כדי להציג נושאים שנגזרו מהסיווג של chrome://topics-internals, צריך להשתמש בשמות מארח בלבד (ללא פרוטוקול או נתיב). chrome://topics-internals יציג שגיאה אם תנסה לכלול "/" בשדה 'מארח'.

הצגת מידע על Topics API

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

בדוגמה, הערך של time_period_per_epoch הוגדר ל-15 שניות (ברירת המחדל היא 7 ימים).

הדף chrome://topics-internals עם החלונית 'תכונות ופרמטרים' שנבחרה.
בחלונית chrome://topics-internals Features and Parameters (תכונות ופרמטרים) מוצגות התכונות המופעלות, הזמן לכל תקופת אימון, מספר תקופות האימון שישמשו לחישוב הנושאים, גרסת הטקסונומיה והגדרות אחרות.

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

--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

Colab

אפשר להריץ את Colab כדי ללמוד איך לטעון את מודל TensorFlow Lite שמשמש את Chrome להסקת נושאים משמות מארח. ההוראות מופיעות בתיאור של שיתוף הפעולה או בסרטון ההדרכה. חשוב לשים לב שבשיתוף הפעולה הזה נעשה שימוש בגרסת הטקסונומיה הישנה.

שימוש ב-Topics API באתרים עם prebid.js

כפי שצוין בגרסה Prebid 7 של גורם הקהילה, הקהילה פיתחה באופן פעיל שילוב עם Topics API באמצעות מודול חדש. המודול הזה מוזג בדצמבר 2022. כאן אפשר לקרוא את המאמרים בנושא מודול Topics API של Prebid. לקבלת מידע נוסף על השילוב, אפשר לפנות אל Prebid.js דרך הערוץ הרגיל שהם מציעים.

Next steps

Learn how users and developers can manage and customize the Topics API to suit user's preferences and needs.
Check out our resources for troubleshooting, technical support, filing bugs and asking questions.

See also

Check out our resources to better understand the Topics API on the Web.