בדיקה, פריסה והתאמה לעומס של פתרון מבוסס Topics

בדף הזה מוסבר איך לפתח, לבדוק ולהתאים הטמעה לסביבת הייצור באמצעות Topics API.

הטמעה של Topics בקצה העורפי

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

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

שימוש ב-Topics בתור אות נוסף

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

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

פיתוח ופריסה

  1. איסוף נושאים על ידי מעקב אחר משתמשים בסביבת הייצור (משך ההטמעה המשוער: שבוע בערך):
    • הסבר על האפשרויות: איך לקרוא ל-Topics באמצעות כותרות HTTP או באמצעות iframe ו-JavaScript.
    • מגדירים את הדומיין של ה-iframe שיפעיל את Topics API.
    • בונים את הפתרון תוך שימוש בהדגמה של כותרת או בהדגמה של JavaScript כמקור עזר.
    • לשלב את Topics בקוד שבעלי אתרים מטמיעים באתרים שלהם (לדוגמה, iframe של המודעה). הקפידו להתקשר לנושאים מההטמעה.
    • כדי להתחיל לעקוב אחרי נושאי השיחה של המשתמשים, צריך להטמיע את הגרסה האחרונה של הסקריפט באתרי הייצור שלכם. מומלץ לבדוק את ההטמעה קודם באתרים שלכם שיש להם מספר קטן של ביקורים בחודש. בשלב הזה, מומלץ להטמיע את הפתרון החדש שמבוסס על נושאים לפחות בחמישה אתרים.
    • בשלב הזה, ה-API צפוי להחזיר מערך ריק כתוצאה מכך. הסיבה לכך היא שעדיין לא נצפו נושאים עבור המשתמש. יכול להיות שיחלפו עד שלושה שבועות עד שתתחילו לקבל נושאים של משתמשים.
    • לבצע בדיקה ואימות של פונקציונליות. אפשר לבדוק את הפתרון באופן ידני או אוטומטי. מוצרים לדוגמה:
      • פותחים את הדפדפן באמצעות דגלים ומגדירים תקופת זמן של 15 שניות ל-15 שניות. כך הדפדפן מחשב מחדש את Topics מוקדם יותר.
      • עוברים לאתרים שמטמיעים את הסקריפט.
      • עליך לבדוק אם נושאים מתועדים באמצעות הסקריפט שלך ב-chrome://topics-internals/.
      • בודקים אילו תוצאות צפויות.
  2. שימוש בנתוני Topics בשילוב עם אותות הקשר אחרים (כמו כתובות URL, מטא-נתונים וכו') (זמן משוער: כ-3 ימים).
    • אחרי שלושה שבועות בסביבת הייצור, הסקריפט אמור לזהות כמה נושאים של משתמשים. בשלב הזה, אמורה להיות לכם אפשרות להשתמש בנתוני Topics כאות נוסף.
    • אחרי שמתחילים לקבל רשימת נושאים לא ריקה, אפשר לשלוח אותה לקצה העורפי בעזרת אותות אחרים לפי הקשר.

פריסה לצורך טירגוט לאתרים

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

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

בחירת אתרים לטירגוט

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

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

בדיקה ואימות פונקציונליים

כשקוראים ל-Topics API בסביבה המוגבלת הזו, אפשר לצפות לתוצאות הבאות:

  • מערך ריק של נושאים [], אם זו השיחה הראשונה מהמכשיר הזה, באתר הזה ובמספר הזה בשבעת הימים האחרונים.

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

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

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

  • נושא חדש שמחליף אחד משלושת הנושאים הקודמים אם בחרת להתקשר ל-Topics API לאחר ארבעה שבועות של תצפית.

  • אם לא תועדו נושאים למשתמש בשלושת השבועות האחרונים או יותר, אז Topics API יחזיר מערך ריק [].

ניתן לאסוף מדדי ביצועים כדי להעריך את חוויית המשתמש:

  • צריך למדוד את זמן הריצה של הקריאות ל-JavaScript ל-Topics API בתוך iframe ממקורות שונים, כדי להשתמש בהן בניתוח ביצועים עתידי.
  • הזמן שלוקח ליצור iframe ו-postMessage() נושאים לאחר קבלת הנושאים.

למידע על פתרון בעיות, עיינו בקטע תמיכה.

התאמה לעומס (scaling) לסביבת הייצור

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

לפניכם סיכום מפורט של האופן שבו אפשר להתאים את עצמכם לסביבת הייצור:

  1. כדאי לבדוק את הפתרון המבוסס על נושאים כדי להגדיל את נפח התנועה.
    • יש להוסיף את ה-iframe לאתרים נוספים בבעלותכם עם מספר גדול יותר של ביקורים, ולפעול לפי ההוראות שבהמשך כדי לבצע בדיקת עומסים.
  2. פורסים את הפתרון באתרים של בעלי התוכן הדיגיטלי.
    • אחרי שהפתרון פועל כמו שצריך בסביבת הבדיקה שלכם, עליכם לעבוד עם בעלי האפליקציות כדי לשלב את ה-iframe באתרים שלהם. לדוגמה, יכול להיות שהם יצטרכו לעדכן את הספרייה שכוללת את ה-iframe.
  3. עיבוד הנתונים של הנושאים והשימוש בהם (זמן משוער: כ-4 שבועות).
    • לשלב נתוני נושאים כאות נוסף לצד נתונים אחרים.
    • מקור שותפי בדיקה של בידינג בזמן אמת.
    • אפשר להריץ בדיקות שימושיות לפי נושאים כאות להוספה לשאר הנתונים שלכם.

בדיקת עומס

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

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

ראה גם

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