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

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

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

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

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

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

צפייה במידע על Topics API

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

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

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

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