Topics API מאפשר פרסום המבוסס על תחומי עניין, בלי להשתמש בקובצי cookie של צד שלישי.
איך פועל Topics API
אפשר להשתמש ב-Topics API כדי לעקוב אחרי נושאים שנראים מעניינים את המשתמש, על סמך הפעילות שלו, ולספק גישה אליהם. לאחר מכן, Topics API יכול לתת למפעילי API (כמו פלטפורמות של טכנולוגיית פרסום) גישה לנושאי העניין של המשתמש, אבל בלי לחשוף מידע נוסף על הפעילות של המשתמש.
מושגים מרכזיים
- נושא הוא נושא שקריא לבני אדם ומעניין את המשתמש הנוכחי, והוא חלק מטקסונומיית הנושאים.
- מבצע קריאה הוא ישות, כמו אפליקציה, ערכת SDK של צד שלישי, אתר או שירות, ששולחת בקשה ל-Topics API כדי לצפות בתחומי העניין של משתמש או לגשת אליהם.
- נושא נצפה על ידי מבצע קריאה, אם מבצע הקריאה שלח בקשה ל-Topics API מדף אינטרנט או מאפליקציה המשויכים לנושא הזה במהלך שלושת העידנים האחרונים.
- תקופת זמן היא תקופה של חישוב נושאים, שמוגדרת כברירת מחדל לשבוע אחד.
- טקסונומיה היא רשימה היררכית של קטגוריות, שכוללת, לדוגמה, קטגוריות כמו
/Arts & Entertainment/Music & Audio/Soul & R&B
ו-/Business & Industrial/Business Services/Corporate Events
. - המערכת מייצרת את הנושאים באמצעות מודל סיווג שממפה את פעילות המשתמשים לאפס נושאים או יותר.
השלבים המרכזיים בתהליך של Topics API
מחזור החיים של Topics API כולל שלושה שלבים עיקריים:
- לבחון את פעילות המשתמשים, למשל כשהם מבקרים בדף האינטרנט
https://cats.example/tabby/index.html
או מורידים את האפליקציהcats
. - הסקת נושאים מפעילות המשתמשים, לדוגמה
/Pets & Animals/Pets/Cats
. - גישה לנושאים שנצפו בעבר אצל המשתמש, למשל כאות לבחירת פרסום רלוונטי (כמו קידום מכירות של מזון לחתולים).
מעקב אחר נושאים
מבצעי השיחות יכולים לגשת רק לנושאים שהם צפו בהם. מבצע קריאה חוזרת עוקב אחרי נושא כששולח בקשה ל-Topics API מהקשר שמשויך לנושא הזה. כדי להמחיש את העיקרון הזה, נבחן את הדוגמה הפשוטה הבאה.
- נניח שיש שני גורמים שמפעילים את Topics API: A ו-B.
- יש שני הקשרים:
- Greenhouse, למשל אפליקציה בשם Greenhouse או אתר greenhouse.example, המשויכים לנושא
Home & Garden
. - תרגילי טניס, לדוגמה אפליקציה בשם 'תרגילי טניס' או אתר tennis.example, שמשויכים לנושא
Sports/Tennis
.
- Greenhouse, למשל אפליקציה בשם Greenhouse או אתר greenhouse.example, המשויכים לנושא
- גם מבצע הקריאה החוזרת A וגם מבצע הקריאה החוזרת B נמצאים בהקשר של Greenhouse.
- רק המתקשר B נמצא בהקשר של תרגילי טניס.
- כדי לפשט את העניין, נניח שלא זוהו נושאים לגבי המשתמש לפני תקופת 1.
- המשתמש מבקר באפליקציה Greenhouse, והגורמים A ו-B מבצעים קריאה ל-Topics API כדי לתעד את הביקור של המשתמש בדף או באפליקציה (כדי ללמוד איך מבצעים קריאה ל-Topics API, אפשר לעיין במדריך להטמעה שמופיע בקטע השלבים הבאים). הרשומה הזו (שם מארח או נתוני אפליקציה) משמשת מאוחר יותר להסקת נושאים שמעניינים אתכם. בהמשך, Topics API יסמן את הנושא
Home & Garden
כנושא שנצפה על ידי שני מבצעי הקריאה A ו-B. - המשתמש נכנס לאפליקציה Tennis exercises. רק מבצע הקריאה B שולח בקשה ל-Topics API. מאוחר יותר, Topics API יסמן את הנושא
Sports/Tennis
כנושא שנצפה על ידי מבצע הקריאה החוזרת B. - בסוף תקופת הזמן לקביעת נושאים, Topics API מרענן את הנושאים המובילים של המשתמש ומזהה את מבצעי הקריאה החוזרת שצפו בנושאים האלה על סמך פעילות המשתמש.
- בהמשך, כשמבצע הקריאה B יבצע קריאה נוספת ל-Topics API, הוא יכול לקבל את הנושא
Home & Garden
אוSports/Tennis
(או, עם סיכוי של 5%, נושא אקראי) עבור המשתמש הזה במערך התשובות. - למבצע הקריאה החוזרת A יש גישה רק לנושא
Home & Garden
, כי הוא אף פעם לא צפה בנושאSports/Tennis
. כלומר, צד שלישי ידע על תחום העניין של המשתמש רק בהקשר הספציפי (אפליקציה או אתר) שבו הוא מופיע.

הפקת נושאים
התכונה 'נושאים' מסיקה נושאים מעניינים מפעילות המשתמשים. הנושאים נבחרים מתוך טקסונומיה מוגדרת מראש בקוד פתוח. פעם בתקופה לקביעת נושאים, המערכת של Topics מרעננת את חמשת הנושאים המובילים של המשתמש ואת הגורמים שהציגו אותם במהלך התקופה. מודל הסיווג של Topics מסיק נושאים מפעילות המשתמשים: שם המארח של ביקור בדף אינטרנט, פרטי האפליקציה ב-Android.
מבצע השיחה ניגש לנושאי העניין של המשתמש
ה-API מחזיר רק נושאים שהמבצע של הקריאה הבחין בהם במהלך שלושת הזמנים האחרונים. אפשר להחזיר למבצע הקריאה החוזרת עד שלושה נושאים,נושא אחד לכל אחת משלוש תקופות הזמן האחרונות לקביעת נושאים (אם מבצע הקריאה החוזרת צפה בנושאים באותה תקופה). מבצע הקריאה החוזרת יכול להשתמש בנושאים שמוחזרים כדי להשלים מידע הקשרי, ואפשר לשלב אותם כדי למצוא מודעה רלוונטית יותר למשתמש.
תקופות
Topics API צריך לוודא שהנושאים שמעניינים אתכם יהיו מעודכנים. המערכת מסיקה את הנושאים של המשתמש על סמך הפעילות שלו במהלך תקופה שנקראת 'תקופת זמן לקביעת נושאים'. התקופה הזו היא שבוע כברירת מחדל. לכל משתמש יש תקופות ייחודיות (התקופות הן 'לכל משתמש') ושעת ההתחלה הראשונית נקבעת באופן אקראי.
בכל תקופת זמן לקביעת נושאים, Topics API מחשב את חמשת הנושאים המובילים של המשתמש ומזהה את מבצעי הקריאה החוזרת שצפו בנושאים האלה באמצעות מידע במכשיר. בכל תקופת זמן לקביעת נושאים ייבחר נושא אחד באופן אקראי מתוך חמשת הנושאים המובילים של המשתמש באותה תקופה. כדי לשפר עוד יותר את הפרטיות ולהבטיח שכל הנושאים יוצגו, יש 5% סיכוי שהנושא ייבחר באופן אקראי מתוך כל הנושאים האפשריים בטקסונומיה של תחומי העניין.
נושאים באינטרנט – איך זה עובד בפועל
באינטרנט, המערכת מסיקה את הנושאים משמות המארחים של הדפים שבהם המשתמש מבקר. לדוגמה, הנושא שנגזר לאתר dogs.example יכול להיות /חיות מחמד ובעלי חיים/חיות מחמד/כלבים.
בתרשים הבא מוצגת דוגמה פשוטה שממחישה איך Topics API יכול לעזור לפלטפורמת טכנולוגיית פרסום לבחור מודעה מתאימה. בדוגמה הזו, נניח שכבר יש בדפדפן של המשתמש מודל למיפוי שמות המארחים של אתרים לנושאים.

הדפדפן קובע את המקור של מבצע הקריאה על סמך ההקשר של הקוד שמפעיל את Topics API. בפועל, המשמעות היא שמשתמשי Topics קוראים ל-API ב-iframe מהמקור שלהם, או שהם כוללים נושאים באחזור למקור שלהם.
לדוגמה, אפשר להטמיע פלטפורמה בצד ההיצע (SSP) בכמה אתרים של בעלי תוכן דיגיטלי. לאחר מכן, ה-SSP יוכל להפעיל את Topics API בתוך iframe מהמקור שלו, וכך לצפות בנושאים שמשויכים למשתמש באתרים של בעלי התוכן הדיגיטלי האלה. לאחר מכן, אפשר לשתף את הנושאים האלה עם פלטפורמה בצד הביקוש (DSP) כדי לעזור לה לבחור מודעה רלוונטית למשתמש.
איך ה-API קובע אילו מבצעי קריאה יראו אילו נושאים
גורמים שמפעילים את ה-API מקבלים רק נושאים שהם זיהו לאחרונה, והנושאים של המשתמש מתעדכנים פעם בכל תקופת זמן לקביעת נושאים: תקופה מסוימת, שמוגדרת לשבוע אחד בהטמעה של Chrome. כלומר, ה-API מספק חלון נע שבו מבצע קריאה מסוים עשוי לקבל נושאים שנצפו.
בטבלה הבאה מופיעה דוגמה (קטנה באופן לא מציאותי) להיסטוריית גלישה היפותטית של משתמש במהלך תקופה אחת. בטבלה מוצגים הנושאים שמשויכים לאתרים שבהם המשתמש ביקר, וגורמי הקריאה ל-API שנמצאים בכל אתר (הישויות שמפעילות את document.browsingTopics()
בקוד JavaScript שכלול באתר).
אתר | נושאים | גורמים שמבצעים קריאות ל-API באתר |
---|---|---|
running.example | Running & Walking Athletic Shoes |
adtech1.example adtech2.example |
dogs.example | Dogs |
adtech1.example |
holiday.example | Hotels & Accommodations |
adtech2.example |
sunglasses.example | Sunglasses |
[none] |
בסוף תקופת הזמן לקביעת נושאים (שבוע אחד כברירת מחדל), Topics API יוצר את הנושאים המובילים בדפדפן במהלך השבוע.
- הדומיין adtech1.example עומד עכשיו בדרישות לקבלת הנושאים
Running & Walking
, Athletic Shoes
ו-Dogs
, כי הוא זוהה בנושאים האלה בדומיין running.example וגם בדומיין dogs.example. - הדומיין adtech1.example לא עומד בדרישות לקבלת הנושא
Hotels & Accommodations
למשתמש הזה, כי הוא לא מופיע באף אחד מהאתרים שבהם המשתמש ביקר לאחרונה ושמשויכים לנושא הזה. - הדומיין adtech2.example ראה את הנושאים
Running & Walking
, Athletic Shoes
ו-Hotels & Accommodations
, אבל לא ראה את הנושאDogs
.
המשתמש ביקר באתר sunglasses.example, שכולל את הנושא Sunglasses
, אבל לא היו קריאות ל-Topics API באתר הזה. בשלב הזה, המשמעות היא שה-API לא יחזיר את הנושא Sunglasses
לכל מבצע קריאה.
בשבוע השני, המשתמש מבקר באתר אחר:
אתר | נושאים | גורמים שמפעילים קריאות ל-API באתר |
---|---|---|
cameras.example | Camera & Photo Equipment |
adtech2.example |
בנוסף, קוד מ-adtech2.example מתווסף אל sunglasses.example
:
אתר | נושאים | גורמים שמבצעים קריאות ל-API באתר |
---|---|---|
sunglasses.example | Sunglasses |
adtech2.example |
בנוסף לנושאים Running & Walking
, Athletic Shoes
ו-Hotels & Accommodations
משבוע 1, המשמעות היא ש-adtech2.example יוכל עכשיו לקבל את הנושאים Camera & Photo Equipment
ו-Sunglasses
– אבל רק החל מהעידן הבא, שבוע 3. כך צדדים שלישיים לא יכולים ללמוד יותר על ההיסטוריה של המשתמש (במקרה הזה, עניין באופנה) מאשר הם יכולים ללמוד באמצעות קובצי cookie.
אחרי שבועיים נוספים, יכול להיות שהנושאים Running & Walking
, Athletic Shoes
ו-Hotels & Accommodations
יוצאו מרשימת הנושאים שעומדים בדרישות של adtech2.example אם המשתמש לא יבקר באתרים שכוללים את הנושאים האלה וגם את הקוד מ-adtech2.example.

מודל מסווג
התכונה 'נושאים' משתמשת במודל סיווג שממפה שמות מארח של אתרים לנושא אחד או יותר (ניתוח מידע נוסף, כמו כתובות URL מלאות או תוכן דפים, עשוי לאפשר הצגת מודעות רלוונטיות יותר, אבל גם לפגוע בפרטיות).
טקסונומיה
הנושאים נבחרים מטקסונומיה. הנושאים האלה נבחרו על ידי צוות Chrome, במטרה שהטקסונומיה תהפוך למשאב שמנוהל על ידי שותפים מהימנים בסביבה העסקית. מערכת קטגוריות צריכה להיות קטנה מספיק כדי שדפדפנים של משתמשים רבים ישויכו לכל נושא. המטרה הסופית היא שהטקסונומיה תגיע מגורם חיצוני שיכלול משוב ורעיונות מכל רחבי התחום.
כדי להימנע מקטגוריות רגישות, הנושאים צריכים להיות גלויים לכולם, להיות נבחרים על ידי בני אדם ולהישאר מעודכנים. קטגוריות הטקסונומיה שבהן משתמש Chrome נוצרו על ידי בני אדם כדי להחריג קטגוריות שנחשבות רגישות, כמו מוצא אתני או נטייה מינית.
סיווג נושאים
המערכת בוחרת ידנית נושאים ל-50,000 מהאתרים המובילים, והרשימה הזו של שמות מארחים ונושאים שמוגדרים כברירת מחדל משמשת לאימון מודל הסיווג. לגבי האתרים המובילים, הגישה לנושאים מתבצעת מרשימת ההחרגות ולא באמצעות מודל הסיווג. אפשר להציג את רשימת ההחרגות באופן מקומי במחשב.

chrome://topics-internals
מפורטים גרסת המודל, הנתיב שלו והנושאים שמשויכים לכל מארח שמופיע ברשימה.ההטמעה של Topics API ב-Chrome מאפשרת להוריד קובץ TensorFlow Lite שמייצג את המודל, כדי שניתן יהיה להשתמש בו באופן מקומי במכשיר של המשתמש.
איך נבחרים חמשת הנושאים המובילים של המשתמש
ה-API מחזיר נושא אחד לכל תקופת זמן לקביעת נושאים, עד שלושה נושאים לכל היותר. אם מוחזר ערך של שלוש, הוא כולל נושאים מהעידן הנוכחי ושני העידנים הקודמים.
- בסוף כל תקופת זמן, הדפדפן אוסף רשימה של דפים שעומדים בקריטריונים הבאים:
- המשתמש ביקר בדף במהלך התקופה.
- הדף כולל קוד שמפעיל את
document.browsingTopics()
. - ממשק ה-API הופעל (לדוגמה, לא נחסם על ידי המשתמש או על ידי כותרת תגובה).
- הדפדפן, במכשיר של המשתמש, משתמש במודל הסיווג שסופק על ידי Topics API כדי למפות את שם המארח של כל דף לרשימה של נושאים.
הדפדפן יוצר רשימה של חמשת הנושאים המובילים.
- כל אחד מ-22 נושאי הבסיס בטקסונומיה מוקצה לקטגוריה של 'תועלת גבוהה' או 'תועלת רגילה' על סמך משוב מסביבת הפרסום. הדפדפן ממיין את הנושאים לפי הקצאת הקטגוריה שלהם. כל נושאי הצאצאים יורשים את הקצאת הקטגוריה של נושא ההורה ברמה הבסיסית. נושאים עם 'שימושיות גבוהה' מקבלים עדיפות.
- לאחר מכן, הדפדפן ממיין את הנושאים לפי תדירות בכל קטגוריה.
- חמשת הנושאים המובילים מהרשימה הממוינת הזו נבחרים כנושאים המובילים של המשתמש באותה תקופה.
לאחר מכן, ה-method document.browsingTopics()
מחזיר נושא אקראי מתוך חמשת הנושאים המובילים בכל תקופת זמן לקביעת נושאים, עם סיכוי של 5% שכל אחד מהם יבחר באופן אקראי מתוך הטקסונומיה המלאה של הנושאים. ב-Chrome, המשתמשים יכולים גם להסיר נושאים ספציפיים או לנקות את היסטוריית הגלישה כדי לצמצם את מספר הנושאים שמוחזרים על ידי ה-API. המשתמשים יכולים גם לבטל את ההסכמה לשימוש ב-API.
אפשר לראות מידע על נושאים שנצפו במהלך האפוקליפסה הנוכחית בדף chrome://topics-internals
.
השלבים הבאים
תהליך ההגדרה
הטמעת נושאים
ראה גם
כדאי לעיין במקורות המידע שלנו כדי להבין טוב יותר את Topics API באינטרנט.
- כדאי לעיין בסרטוני הדגמה, סרטוני שיתוף פעולה וסרטוני הדרכה בנושאים.
- רשימת הדגלים של Chrome שמאפשרת למפתחים להתאים אישית את Topics API לצורכי בדיקה.
- איך משתמשים ומפתחים יכולים לשלוט ב-API
- כדאי לעיין במקורות המידע כדי לקבל הסברים טכניים ותמיכה. לשאול שאלות, לקיים אינטראקציה ולשתף משוב.