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.

הסבר על תהליך הצגת המודעות ב-Pod
בתהליך הזה, אתם מנהלים את קובץ המניפסט של השידור החי של התוכן או משתמשים בשירות של צד שלישי לטיפול בקובצי מניפסט כדי לזהות את סמני המודעות בקובץ המניפסט.
כדי ליצור ישות AdBreak לפני שצריך לבקש את הפלחים של רצף המודעות או את המניפסט של המודעות, צריך להפעיל את DAI Ad Break API לפני שעת ההתחלה הצפויה של ההפסקה למודעה.
כשה-Video Stitcher מזהה את סמן המודעה במניפסט ושולח בקשות לפלחי מודעות עם מזהה של הפסקה למודעה, מערכת Google DAI משתמשת בנתוני AdBreak עם אותו מזהה כדי לקבל החלטות לגבי המודעות.
אחרי שהלקוח מבקש מדיה של מודעות, הישות AdBreak שיצרתם באמצעות ה-API עוברת למצב BREAK_STATE_COMPLETE.

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