הדגמות של Topics API

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

סטטוס הטמעה

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

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

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

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

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

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

  • מפעילים את ה-API בדף Chrome של chrome://flags/#privacy-sandbox-ads-apis:

    הפעלת Topics API באמצעות הדף chrome://flags/#privacy-sandbox-ads-apis
    הדף chrome://flags/#privacy-sandbox-ads-apis שבו אפשר להפעיל או להשבית את ה-API.

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

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

הדגמה של Topics API

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

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

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

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

כותרת הבקשה 'נושאים' נראית כך:

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"

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

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