מידע על DAI Ad Break API

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

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

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

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

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

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

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

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

‫Google Full service DAI מנהל גם את מניפסט התוכן וגם את בלוקי המודעות.

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

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

הפסקה למודעה: ישות הפסקה למודעה, מהרגע שבו היא נוצרת ועד שהיא מוצגת בתהליך הצגת Pod.

הסבר על תהליך הצגת הפודים

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

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

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

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

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

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

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