ה-API של הפסקות הפרסום בשיטת DAI (הוספת מודעות דינמית) מאפשר לכם ליצור ולנהל את התזמון ואת נתוני טירגוט המודעות של הפסקות פרסום עתידיות בשידורים החיים.
בעזרת DAI Ad Break API, אתם יכולים:
- שיפור שיעור המילוי של בקשות למודעות בזמן שיא התנועה: נותנים לשירותי DAI יותר זמן לבחור את המודעות שמניבות את הרווחים הכי גבוהים לאירועים בשידור חי. מומלץ להשתמש ב-DAI Ad Break API אם באירועים של השידור החי יש מספר גבוה של צופים בו-זמנית, תגי מודעות דינמיים או מודעות עם זמן אחזור גבוה.
- שליטה מלאה בהפסקות למודעות: אפשר ליצור, לעדכן ולמחוק הפסקות למודעות מראש. כך מקבלים גמישות רבה יותר בהשוואה לאיתות על מודעות בקובץ המניפסט, ושיעור מילוי גבוה יותר בהצגת רצפי מודעות בהשוואה להחלטות בזמן אמת.
- לספק חוויית צפייה רציפה: כדי למזער שגיאות בהפעלת מודעות שקשורות למודעות, כמו רצפי מודעות שלא מילאו את כל משבצת הזמן או רצפי מודעות שמילאו משבצת זמן ארוכה מדי, חשוב לספק מידע מדויק על ההפסקות לפרסומות.
במדריך הזה מתוארות השיטות (methods) של 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: ההפסקה למודעה הוצגה למשתמשים.
בתרשים הבא מוצג ציר הזמן של ישות AdBreak, מהרגע שהיא נוצרת ועד שהיא מסתיימת.

אפשר ליצור ישות AdBreak בין דקה אחת ל-300 דקות לפני שצפוי להתחיל הפסקה למודעה.
- מומלץ להימנע מיצירת הפסקת פרסום פחות מדקה לפני זמן ההתחלה הצפוי של ההפסקה, כי יכול להיות שלא יהיה ל-Google DAI מספיק זמן לקבל החלטות לגבי מודעות, מה שיגרום לשיעור נמוך יותר של מודעות שמוצגות.
- מומלץ להימנע מיצירת הפסקה לפרסומות יותר מ-6 שעות לפני זמן ההתחלה הצפוי של ההפסקה, כי יכול להיות ששרתי המודעות יפסלו את המודעות המבוקשות.
בקטעים הבאים מוסבר על מעברי המצבים של הפסקות למודעה בתהליכי העבודה של DAI Full Service ושל Pod Serving.
הסבר על התהליך של DAI בשירות מלא
Google Full-service DAI מנהל גם את מניפסט התוכן וגם את רצפי המודעות.
כדי לטרגט מודעות בהתאמה אישית, צריך להשתמש ב-API של הפסקות הפרסום ב-DAI כדי ליצור AdBreakישות
לפני סמן המודעה התואם במניפסט של שידור התוכן בשידור חי.
- הזמן הזה מאפשר לשירותי DAI של Google להשתמש בנתוני
AdBreakלצורך קבלת החלטה לגבי המודעה. - כש-Google DAI מזהה את סמן המודעה במניפסט, המערכת משתמשת בהחלטות לגבי מודעות עם נתוני הישות
AdBreakומעבירה את מצב הישות ל-BREAK_STATE_COMPLETE.

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

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