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

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

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

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

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

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

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

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

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

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

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

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

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

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

השלבים הבאים

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

ראה גם

כדאי לעיין במקורות המידע שלנו כדי להבין טוב יותר את Topics API באינטרנט.