כדאי להתנסות וללמוד איך המערכת מסיקה נושאים משמות מארחים עם הגדרה מינימלית.
סטטוס הטמעה
- Topics API השלים את שלב הדיון הציבורי והוא זמין כרגע ל-99% מהמשתמשים, עד 100 אחוזים.
- כדי לשלוח משוב על Topics API, אפשר ליצור בעיה בהסבר של Topics או להשתתף בדיונים ב-שיפור הקבוצה העסקית של הפרסום באינטרנט. הסבר מכיל מספר שאלות פתוחות שעדיין מחייבות הגדרה נוספת.
- לוח הזמנים של ארגז החול לפרטיות מספק לוחות זמנים להטמעה של Topics API והצעות אחרות של ארגז החול לפרטיות.
- ב-Topics API: העדכונים האחרונים מפורטים השינויים והשיפורים ב-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.
רשימה זו מציגה את האתרים שניתן לבקר בהם מההדגמה כדי לתעד נושאים שמעניינים אותך. כמו שאפשר לראות, קטגוריית הבידור/הומור בצילום המסך היא לא הנושא של אחד מהאתרים האלה, לכן הנושא המוקלט הזה הוא נושא שנוסף כנושאים האקראיים האפשריים (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 ולהשתתף בו. למקורות מידע מעמיקים יותר, אפשר לעיין במדריך למפתחים.
עניין ושיתוף משוב
- GitHub: קוראים את ההסבר של Topics API, ומעלים שאלות ועוקבים אחרי דיונים בבעיות במאגר ה-API.
- W3C: דיון על מקרי שימוש בתחום בשיפור הקבוצה העסקית של הפרסום באינטרנט.
- הודעות: הצטרפות לרשימת התפוצה או הצגה של רשימת התפוצה
- תמיכה למפתחים של ארגז חול לפרטיות: אפשר לשאול שאלות ולהצטרף לדיונים על מאגר התמיכה למפתחים של ארגז החול לפרטיות.
- Chromium: דיווח על באג ב-Chromium כדי לשאול שאלות לגבי ההטמעה שזמינה כרגע לבדיקה ב-Chrome.