Topics API לנייד: סקירה כללית

מידע על Topics API ב-Android והשלבים להטמעה שלו. אפשר גם לעבור ישירות אל נושאי ההטמעה.

איך Topics API פועל

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

מושגים מרכזיים

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

• נניח שיש שתי פונקציות קריאה חוזרת (caller) ל-Topics API: A ו-B.
• יש שני הקשרים:
  • Greenhouse, לדוגמה אפליקציה בשם Greenhouse או אתר greenhouse.example, המשויכים לנושא Home & Garden.
  • תרגילי טניס, לדוגמה אפליקציה בשם 'תרגילי טניס' או אתר tennis.example, שמשויכים לנושא Sports/Tennis.
• גם מבצע הקריאה החוזרת 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 מרעננת את חמשת הנושאים המובילים של המשתמש ואת הגורמים שהציגו אותם במהלך התקופה. המודל המסווג של Topics API מסיק נושאים מפעילות המשתמשים: שם מארח לביקור בדף אינטרנט, פרטי האפליקציה ב-Android.

מבצע השיחה ניגש לתחומי העניין של המשתמש

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

תקופות

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

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

נושאים ב-Android – איך זה עובד בפועל

Topics API ב-Android נועד לתמוך ב-SDK של צד שלישי לפרסום, שפעולה בדרך כלל בכמה אפליקציות. Topics מספק למפעילים נושאי פרסום בפירוט גס על סמך תחומי העניין של המשתמשים, על סמך השימוש שלהם באפליקציות, בלי להסתמך על מזהים שמשולבים בין אפליקציות. אפשר להשתמש בנושאים האלה כדי להשלים מידע לפי הקשר שקשור לאפליקציה שרוצה להציג מודעה, ואפשר לשלב אותם כדי לבחור מודעה מתאימה למשתמש.

בהקשר של Topics API, קונים ומפרסמים תלויים בצד המוכר. הצד של המוכר הוא זה שיש לו נוכחות רחבה באפליקציות של בעל התוכן הדיגיטלי, והוא עוקב אחרי הנושאים של המשתמשים. לאחר מכן הוא משתף את הנושאים עם הקונים כדי לעזור להם לבחור מודעות רלוונטיות יותר. כדי לקבל נושאים, אפליקציות ו-SDK בצד המכירה צריכים ליצור טביעת רגל על ידי מעקב אחרי Topics API במשך תקופת זמן אחת לפחות.

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

שילוב נושאים לפי סוג העסק

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

לכל ספקי טכנולוגיות הפרסום

• כדאי לעיין בטקסונומיה של Topics ולשלוח משוב.
• אפשר להתנסות באפליקציות לדוגמה של Topics API כדי לראות אילו נתוני נושאים מוחזרים מהסיווג במכשיר.
• מעדכנים את תהליכי העבודה באפליקציה וב-SDK כדי להתחיל לבצע קריאות ל-Topics API.
• מעדכנים את הפרוטוקולים כדי להתחיל לשלוח נושאים בבקשות להצגת מודעות.
• להירשם לארגז החול לפרטיות עם טכנולוגיית הפרסום.

לטכנולוגיות פרסום בצד המכירה

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

לטכנולוגיות פרסום בצד הקונה

• עליכם ליצור קשר עם שותפים בצד המכירה כדי לוודא שהם מתכננים לעקוב אחרי נושאים ולבנות נוכחות. כדי לקבל נושאים, ספקים בצד המכירה צריכים להפעיל את Topics API לפחות פעם אחת בכל תקופת זמן.
• עבודה משותפת על פרוטוקול לקבלת נושאים משותפי הצד המוכר. Topics הוא אות חדש ששותפים בצד המכירה ישתפו כחלק מהבקשה להצגת מודעה. צרכנים בצד הקונה יצטרכו לוודא שהם עובדים עם השותפים שלהם ב-upstream לגבי האופן שבו הנושאים ישותפו.
• שילוב נושאים במודלים של בידינג ואופטימיזציה. הממשק Topics API אמור להשלים אותות אחרים, כמו אותות לפי הקשר, כדי לעזור למצוא מודעה מתאימה למבקר.

איך ה-API מסיק נושאים לאפליקציה

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

מסווג נושאים

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

• כשמשתמשים במודל הסיווג להסקה כדי לחשב את הנושאים של תקופת זמן נתונה, קבוצת האותות שבהם נעשה שימוש נשארת במכשיר. קבוצת האותות הזו עשויה לכלול אפליקציות שהותקנו או שנעשה בהן שימוש לאחרונה, ויכול להיות שהיא תתרחב בעתיד כך שתכלול אותות אחרים.
• Google אימנה את מודל V5 על סמך 540,000 תוויות ידניות ו-17 מיליון תוויות של למידת מכונה של מידע על אפליקציות שזמין באופן ציבורי מחנויות אפליקציות כמו חנות Google Play. המודל משתמש בשמות של אפליקציות ובשמות של חבילות כאותות קלט, והוא זמין בחינם למפתחי אפליקציות כדי לבדוק אילו נושאים האפליקציה שלהם מסווגת אליהם.
• יכול להיות שאפליקציה ממופה ליותר מנושא אחד, או לאף נושא, או שהיא לא נוספה להיסטוריית הנושאים של המשתמש. אם אפליקציה ממופה ליותר מנושא אחד בתחביר, מספר הנושאים שנבחרים לאפליקציה הזו יהיה מוגבל לשלושת הנושאים המובילים.

כדי להבין טוב יותר איך פועל מודל הסיווג, אפשר לבדוק איך נתונים שונים של אפליקציות משפיעים על הסיווג באמצעות Android Topics Classifier Colab.

טקסונומיה

הנושאים נבחרים מטקסונומיה מוגדרת מראש בקוד פתוח. הטקסונומיה זמינה לציבור ועשויה להשתנות. אפשר לשלוח הצעות באמצעות לחצן המשוב בחלק העליון של הדף הזה. הטקסונומיה הזו נוצרת על ידי אנשים, כך שנושאים רגישים לא נכללים בה. הוא יותאם לקטגוריות של המודעות שאפשר להציג באפליקציות לנייד ב-Android.

נושאים ב-Android – איך זה עובד בפועל

נניח שלמשתמש מותקנות במכשיר שבע אפליקציות: A, ‏ B, ‏ C, ‏ D, ‏ E, ‏ F ו-G. נניח שהסיווג של הנושאים באפליקציה ובערכות ה-SDK של טכנולוגיות הפרסום באפליקציות האלה הוא כדלקמן:

קידום אפליקציות	סיווג נושאים	Ad tech SDK
A	T1, ‏ T5	ad-sdk1, ‏ ad-sdk2
B	T2	ad-sdk2
C	T3, ‏ T6	ad-sdk3, ‏ ad-sdk4
D	T1, ‏ T4	ad-sdk1
E	T5	ad-sdk4, ‏ ad-sdk5
F	T6	ad-sdk2, ‏ ad-sdk3, ‏ ad-sdk4
G	T7	ad-sdk2

בסוף השבוע הראשון: Topics API יוצר את 5 הנושאים המובילים של המשתמש בתקופת הזמן הזו.

Top Topic	אנשים שיכולים לקבל מידע על הנושא
T1	ad-sdk1, ‏ ad-sdk2
T2	ad-sdk2
T3	ad-sdk3, ‏ ad-sdk4
T4	ad-sdk1
T5	ad-sdk1, ‏ ad-sdk2, ‏ ad-sdk4, ‏ ad-sdk5

בשבוע השני, אם מבצע קריאה באפליקציה כלשהי יבצע קריאה ל-API, רשימת הנושאים שתוחזר תכלול רק נושאים שבהם מבצע הקריאה נמצא בעמודה 'מבצעי קריאה שיכולים לקבל מידע על הנושא' עבור הנושא הזה באפליקציה הזו בתקופה הזו.

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

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

הצפנה של נושאים שמוחזרים

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

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

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

השלבים הבאים

See also

Check out our resources to better understand the Topics API on Android.

• Check out Topics sample apps, collab and walkthrough videos.
• See how users and developers can control the API.
• Check out the support resources to ask questions, engage and share feedback.