הדגמות של Topics API

כדאי להתנסות וללמוד איך המערכת מסיקה נושאים משמות מארחים עם הגדרה מינימלית.

סטטוס הטמעה

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

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

אתם יכולים גם להריץ את Colab של Topics כדי לנסות את מודל הסיווג של Topics.

בסרטון הבא מוסבר איך פועלת ההדגמה.

בדיקה באמצעות chrome://flags או feature flags

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

  • הפעלת כל ממשקי ה-API לשמירה על פרטיות בפרסום במסגרת chrome://settings/adPrivacy.

  • מריצים את Chrome משורת הפקודה עם הדגלים הבאים:

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

הדגמה של Topics API

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

במאמר הפעלת Chromium עם דגלים מוסבר איך להגדיר סימונים כשמריצים את Chrome ודפדפנים אחרים מבוססי Chromium משורת הפקודה, אם כי ההדגמה הזו ספציפית ל-Google Chrome.

הדגמה של הכותרות ב-Topics API

ההדגמה ב-topics-fetch-demo.glitch.me מראה איך להשתמש בכותרות של בקשות ותגובות ב-fetch() כדי לגשת לנושאים ולסמן אותם כפריטים שנצפו.

גישה לכותרת הבקשה Sec-Browsing-Topics

במקום להשתמש ב-document.browsingTopics() מ-iframe כדי להציג נושאים עבור המשתמש, קריאות ל-API יכולים לגשת לנושאים שנמדדו באמצעות כותרת הבקשה Sec-Browsing-Topics של בקשת (()fetch שכוללת את {browsingTopics: true} בפרמטר האפשרויות שלה – או מאותה כותרת של בקשת XHR שמגדירה את המאפיין deprecatedBrowsingTopics כ-true.

לדוגמה:

fetch('https://topics-server.glitch.me', {browsingTopics: true})
    .then((response) => {
        // Process the response
 })

בדפדפנים שתומכים ב-API, הבקשה fetch() תכלול כותרת Sec-Browsing-Topics עם פירוט הנושאים שנמדדו עבור שם המארח של כתובת ה-URL של הבקשה: בדוגמה הזו, topics-server.glitch.me.

אם לא תועדו נושאים עבור שם המארח הזה והמשתמש הזה, הכותרת תיכלל אבל הערך יהיה ריק. כלומר, הכותרת Sec-Browsing-Topics בבקשת fetch() כוללת רק נושאים שזוהו בדפדפן של המשתמש הנוכחי על ידי מתקשר שהמקור שלו תואם לשם המארח של כתובת ה-URL של הבקשה. הפעולה הזו זהה לזו של קריאה ל-document.browsingTopics() דרך iframe כדי להציג נושאים מתועדים עבור המשתמש הנוכחי.

כותרת הבקשה נשלחת לבקשה כל עוד יש לה מדיניות הרשאות מתאימה, ההקשר מאובטח והגדרות המשתמש מאפשרות זאת. אין נושאים בכותרות של בקשות ניווט.

כותרת הבקשה של Topics נראית כך:

Sec-Browsing-Topics: 186;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1", 265;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1"

הדוגמה הזו כוללת שני נושאים מתוך הטקסונומיה של Topics, 186 ו-265, יחד עם פרטי הגרסה של כל נושא.

האפשרות לכלול את כותרת הנושאים בבקשות XHR זמינה רק באופן זמני, והתמיכה תוסר בעתיד.

סימון נושאים כנושאים שנצפו באמצעות Observe-Browsing-Topics

אם בקשה כוללת כותרת Sec-Browsing-Topics והתשובה לבקשה הזו כוללת כותרת Observe-Browsing-Topics: ?1, נושאים מכותרת הבקשה יסומנו על ידי הדפדפן כנושאים שנצפו. אפשר לחשב את הנושאים שנצפו באמצעות Topics API. המנגנון הזה נועד להתאים לפונקציונליות שמסופקת על-ידי שימוש ב-JavaScript API מ-iframe.

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

דף ההדגמה של Topics API ב-glitch.me
ההדגמה של glitch.me להתנסות עם ה-API.

רשימה זו מציגה את האתרים שניתן לבקר בהם מההדגמה כדי לתעד נושאים שמעניינים אותך. כמו שאפשר לראות, קטגוריית הבידור/הומור בצילום המסך היא לא הנושא של אחד מהאתרים האלה, לכן הנושא המוקלט הזה הוא נושא שנוסף כנושאים האקראיים האפשריים (5 אחוזים).

  • pets-animals-pets-cats.glitch.me
  • cats-cats-cats-cats.glitch.me
  • cats-pets-animals-pets.glitch.me
  • cats-feline-meow-purr-whiskers-pet.glitch.

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

בכרטיסייה 'מצב נושאים' מוצג מידע על הנושאים שנמדדו.
הכרטיסייה 'מצב נושאים' שמציגה נושאים אמיתיים ואקראיים.

השלבים הבאים

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

עניין ושיתוף משוב