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

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

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

מסווג נושאים

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

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

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

טקסונומיה

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

נושאים מעשיים ב-Android

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

קידום אפליקציות סיווג נושאים 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 הנושאים המובילים של המשתמש בתקופת הזמן הזו.

נושא מוביל אנשים שיכולים לקבל מידע על הנושא
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.