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