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