מידע על DAI Ad Break API

‫Dynamic Ad Insertion (DAI) Ad Break API מאפשר לכם ליצור ולנהל את התזמון ואת נתוני טירגוט המודעות של ההפסקות למודעות בשידורים החיים שלכם.

באמצעות DAI Ad Break API, אתם יכולים:

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

במדריך הזה מתוארות השיטות של DAI Ad Break API, ומוסבר מחזור החיים של ההפסקות למודעות בתהליכים של DAI Full Service ו-Pod Serving.

מידע על השיטות של DAI Ad Break API

ה-API חושף את השיטות הסטנדרטיות הבאות לניהול משאבי AdBreak:

  • ‫Create: מגדיר ישות AdBreak חדשה לישות LiveStreamEvent. אפשר גם להגדיר את המאפיין expectedStartTime כדי לתזמן את ההחלטה על הצגת המודעה כך שתתחיל תוך 60 שניות לפני שההפסקה למודעה מתחילה.
  • ‫Get: מאחזר את הפרטים של ישות AdBreak ספציפית, כולל מטא-נתונים של מצב ההפסקה למודעה והתזמון שלה.
  • ‫List: מחזירה רשימה של ישויות AdBreak שנוצרו בעבר באמצעות ה-API של ישות LiveStreamEvent נתונה, בסדר כרונולוגי הפוך. חשוב לשים לב שה-API לא מחזיר הפסקות למודעות שמוגדרות רק במניפסט של סטרימינג התוכן.
  • ‫Update: שינוי של ישות AdBreak קיימת לפני שמתחילה ההחלטה לגבי המודעה.
  • ‫Delete: ביטול ההחלטה לגבי מודעה של ישות AdBreak שנוצרה קודם.

הסבר על מחזור החיים של הפסקות למודעות

לישות AdBreak יש את המצבים הבאים:

  • ‫BREAK_STATE_UNSPECIFIED: מצב ברירת המחדל.
  • ‫BREAK_STATE_SCHEDULED: ההפסקה למודעה נוצרה בהצלחה ותזמון ההחלטה לגבי המודעה נקבע.
  • ‫BREAK_STATE_DECISIONED: שירותי DAI התחילו את תהליך בחירת המודעות להפסקה למודעות. אי אפשר לשנות את ההפסקה למודעה, אבל עדיין אפשר לבטל אותה, וזה עלול להשפיע לרעה על שרתי המודעות.
  • ‫BREAK_STATE_COMPLETE: ההפסקה למודעה הוצגה למשתמשים.
  • ‫BREAK_STATE_EXPIRED: תוקף ההפסקה למודעה פג לפני שהמודעה הוצגה. האפשרות הזו רלוונטית רק אם מפעילים תזמון של כמה הפסקות באירוע בשידור חי. פרטים נוספים זמינים במאמר הגדרות של הפסקות למודעות באמצע הסרטון. כברירת מחדל, התוקף של ההפסקות למודעות פג 30 דקות אחרי הערך בשדה expectedStartTime, או 30 דקות אחרי שמתחיל תהליך קבלת ההחלטות אם לא מגדירים את השדה expectedStartTime. אפשר להתאים אישית את משך הזמן הזה באמצעות השדה expireDuration.

בתרשים הבא מוצג ציר הזמן של ישות AdBreak, מהיצירה ועד להשלמה.

ישות של הפסקה למודעה, מהיצירה ועד לסיום.

אפשר ליצור ישות AdBreak בין דקה אחת ל-300 דקות לפני שההפסקה למודעות צפויה להתחיל.

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

בקטעים הבאים מתוארים המעברים בין המצבים של ההפסקות למודעות בתהליכי DAI Full Service ו-Pod Serving.

הסבר על התהליך של DAI בשירות מלא

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

כדי לטרגט מודעות בהתאמה אישית, משתמשים ב-DAI Ad Break API כדי ליצור ישות AdBreak לפני סמן ההפסקה למודעה המתאים במניפסט של השידור החי של התוכן.

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

כשמפעילים תזמון של כמה הפסקות באירוע בשידור חי, אפשר להגדיר את השדה matchParams בישות AdBreak. התהליך הזה מאפשר ל-Google DAI להתאים בין סמני המודעות שזוהו במניפסט לבין הפסקות למודעות במצב BREAK_STATE_SCHEDULED או BREAK_STATE_DECISIONED.

ישות של הפסקה למודעה, מהיצירה ועד להשלמה בתהליך של DAI בשירות מלא.

הסבר על תהליך הצגת המודעות ב-Pod

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

כדי ליצור ישות AdBreak לפני שצריך לבקש את הפלחים של רצף המודעות או את המניפסט של המודעות, צריך להפעיל את DAI Ad Break API לפני שעת ההתחלה הצפויה של ההפסקה למודעה.

כשה-Video Stitcher מזהה את סמן המודעה במניפסט ושולח בקשות לפלחי מודעות עם מזהה של הפסקה למודעה, מערכת Google DAI משתמשת בנתוני AdBreak עם אותו מזהה כדי לקבל החלטות לגבי המודעות.

אחרי שהלקוח מבקש מדיה של מודעות, הישות AdBreak שיצרתם באמצעות ה-API עוברת למצב BREAK_STATE_COMPLETE.

מצב השלמה של ישות ההפסקה למודעה.

שליחת הבקשה הראשונה

כדי להגדיר גישה ל-API ולשלוח את הבקשה הראשונה, עיינו במאמר שימוש ב-DAI Ad Break API.