כדי להטמיע הוספת מודעות בצד השרת (SSAI) בשידור חי בפורמט HLS או DASH, צריך להשתמש ב-Pod Serving API כדי לבקש בלוקים של מודעות עם קצב העברת נתונים משתנה. למידע על רזולוציות וקצבי העברת נתונים נתמכים, אפשר לעיין במאמר פורמטים של וידאו ואודיו וקידוד מחדש.
בדף הזה מוסבר איך להשתמש ב-Pod Serving API לשידור חי.
דרישות מוקדמות
לפני שממשיכים, צריך לוודא שיש לכם:
מגדירים אירוע בשידור חי עם סוג ה-DAI הפניה אוטומטית להצגת פוד. בוחרים אחת מהאפשרויות הבאות:
- הגדרת שידור חי ל-DAI
- בוחרים ספריית לקוח של SOAP API ומפעילים את השיטה
LiveStreamEventService.createLiveStreamEventsעם אובייקטLiveStreamEventוהסוגdynamicAdInsertionTypeשמוגדר ל-enumPOD_SERVING_REDIRECT. במאמר ספריות לקוח וקוד לדוגמה מפורטות כל ספריות הלקוח.
אפליקציית לקוח שפועלת בדפדפן אינטרנט, בנייד או בטלוויזיה, כדי לטעון את הסטרימינג ולטפל באירועים, כמו הפעלה, השהיה, לחיצה או הקשה.
כלי לשינוי מניפסטים לטיפול בבקשות של סטרימינג מאפליקציית הלקוח. חשוב: לשירות המניפסטים, מומלץ להשתמש בתהליך המתקדם של הצגת מודעות.
חשבון Google Ad Manager שבו מופעלת הצגת מודעות DAI בבלוקים.
תהליך בסיסי של הצגת מודעות
כדי להפעיל את השידור, בוחרים פרוטוקול שידור ומבצעים את הפעולות הבאות:
HLS
כדי לרשום סשן, צריך לשלוח בקשה לסטרימינג מנגן הווידאו אל Google Ad Manager.
מתחילים לבצע סקר לגבי מטא-נתונים של מודעות כדי לקבל מידע על אירועים קרובים שקשורים למודעות.
מבקשים את מניפסט השידור החי מהכלי לשינוי המניפסט.
אופציונלי: שליחת התראה מוקדמת על הפסקת פרסום אל Google Ad Manager. חשוב: אנחנו ממליצים לבצע את השלב הזה כדי לשפר את שיעור מילוי המודעות.
כשכלי המניפולציה של המניפסט מזהה סמן של הפסקת פרסום, הוא בונה את כתובות ה-URL של פלח המודעה ומצרף אותן למניפסט.
- במהלך הפסקה למודעה, נגן הווידאו של הלקוח מבקש קטע של מודעה ועוקב אחרי כתובת ה-URL להפניה של הקטע כדי להוריד את קובץ הקטע של המודעה.
מחפשים את מזהי אירועי המודעות בתגי ID3 ושולחים פינגים לאימות מדיה אל Google.

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

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

DASH
פועלים לפי כל השלבים בכרטיסייה HLS.
משתמשים בתשובות של מטא-נתונים של תזמון רצפי מודעות (ATM) כדי ליצור את התקופות של DASH בשדות הנדרשים הנוספים.

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