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

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