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

הפקת נושאים

מערכת 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 API נועד להשלים אותות אחרים כמו אותות הקשריים, כדי לעזור למצוא מודעה מתאימה למבקר.

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

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

מסווג נושאים

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

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

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

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

השלבים הבאים

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

ראה גם

כדאי לעיין במקורות המידע שלנו כדי להבין טוב יותר את Topics API ב-Android.