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

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

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

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

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

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

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

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

העמודה Observed-by context domains (hashed) מספקת את הערך המעוקל של שם מארח שעבורו נצפה נושא.

הצגת נושאים שנגזרו משמות מארחים

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

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

שימוש ב-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.