ה-Pod הגשה API מאפשר גישה לרצפי מודעות וידאו עם קצב סיביות מותאם, כך שאפשר יהיה לחבר אותם ישירות לפלייליסט מדיה בפורמט HLS או MPEG DASH שמוצג למשתמש.
ה-API הזה מיועד לבעלי תוכן דיגיטלי מתקדמים ולשותפים של טכנולוגיות וידאו. כדי להשתמש ב-API הזה בקנה מידה נרחב, צריך תכנון והטמעה של תהליך מתוחכם להצגת מדיה, שלא נכלל במסמכי התיעוד האלה.
דרישות מוקדמות
לפני עיבוד של שידור חי באמצעות DAI Podserving API, תצטרכו ליצור אירוע בשידור חי באמצעות ממשק המשתמש של Google Ad Manager או באמצעות ה-API של האירוע החי.
רכיבים
כל הטמעה של ה-API להצגת Pod כוללת שלושה רכיבים: Google Ad Manager, נגן וידאו של הלקוח ושרת למניפולציות של מניפסט.
Ad Manager
Ad Manager אחראי להצגת המודעות למשתמשים, ואפשר לנהל אותו דרך Ad Manager SDK או דרך ממשק האינטרנט שלו. אלו האחריות של השירות:
- קבלת בקשות שידור מנגן הווידאו של הלקוח, קבלת החלטות ממודעות והצגת גרסאות מתאימות לפרופילי קידוד התוכן שלך
- תגובה לבקשות שנשלחות מנגן הווידאו של הלקוח ואספקת החלק המתאים של רצף המודעות למשתמש הנתון
- קבלה ועיבוד של פינגים של מעקב מנגן הווידאו של הלקוח
נגן וידאו של לקוח
נגן הווידאו של הלקוח הוא האפליקציה או האתר שבהם הלקוחות משתמשים כדי להפעיל את זרם הווידאו שהתקבל. תחומי האחריות של השחקן הם:
- הפעלת משאב של שידור מ-Ad Manager וקבלת אובייקט שידור שמייצג סשן הפעלה יחיד של אירוע ספציפי בשידור חי.
- בקשת מניפסט של סטרימינג משרת שינוי מניפסט, שמתחיל את ההפעלה
- לבצע דגימה תקופתית של מטא-נתונים של רצף מודעות מ-Ad Manager, שמתארת את אירועי המודעות שמוטמעים בפלחי המודעות של השידור.
- האזנה לאירועי מטא-נתונים מתוזמנים שהנגן מעלה ושמכילים מזהי מדיה של מודעות. השחקן מעביר אותם ל-Ad Manager כדי לוודא שאירועי המודעות התרחשו בהצלחה.
למידע נוסף על ההטמעה הנכונה של נגן הווידאו של הלקוח, תוכלו לעיין במדריך להצגת רצף מודעות בפלטפורמה שלכם:
למידע על הטמעות בהתאמה אישית, קראו את מדריך הלקוח להצגת רצף מודעות עבור DAI API.
שרת לטיפול במניפסטים
שרת מניפולציה של המניפסט הוא השרת שאחראי על אירוח מניפסט הסטרימינג שמסופק לנגן הווידאו של הלקוח. אלה האחריות של השרת:
- טיפול בהעברת מניפסט לנגן הווידאו של הלקוח
- בקשה לתבנית תקופה מ-Ad Manager (רק לשידורים של MPEG DASH), כדי לאכלס פלחים של מודעות.
- הוספת כתובות URL של פלחי מודעות שמתארחים ב-Ad Manager למניפסט של שידור הווידאו (ב-HLS) או לתקופת המודעות (ל-MPEG DASH) במהלך הפסקות למודעות.
- הצגת המניפסט שהשתנה בנגן הווידאו של הלקוח.
מידע נוסף על הטמעת שרת של מניפולציה מותאם אישית של מניפסט זמין במדריך לשינויי מניפסט.
מילון מונחים
- אירוע בשידור חי: אירוע שבו נשמרים נתוני הגדרה חשובים לשידור החי, כמו פרופילים של קידוד. אירועים בשידור חי נוצרים באמצעות Ad Manager.
- אובייקט סטרימינג: אובייקט שמייצג סשן הפעלה יחיד של נכס וידאו ספציפי. מאפיינים בולטים כוללים את מזהה מקור הנתונים וכתובת ה-URL לאימות מדיה.
- רצף מודעות: קיבוץ של סרטוני מודעות שהוצגו בהפסקה למודעה
- פלחים של מודעות: קבצים של פלחים במדיה בשביל ההפסקות למודעות
- מטא-נתונים של רצף מודעות: מטא-נתונים של ההפסקות למודעות המשמשות להצגת ממשק המשתמש של המודעה בלקוח. לדוגמה, הסתרה של לחצני הדילוג במהלך המודעה
- מזהה מדיה של מודעה: מטא-נתונים שמקודדים כתגי ID3 בקבצים של פלחי מודעות. המטא-נתונים האלה משמשים כדי לזהות מתי התרחשו אירועים ספציפיים שקשורים למודעות במהלך ההפעלה, כמו התחלת המודעה או נקודת האמצע.