במדריך הזה מתואר המאפיין הנתמך של מטא-נתונים של מודעות ב-Video Stitcher API. מטא-נתונים של מודעות מחולצים ממודעת VAST בתג מודעה בתגובה, שמכיל אירועי מעקב של מודעות ומודעות נלוות. כתובת ה-URL של תג המודעה מוגדרת בבקשה ליצירת סשן. מידע נוסף מופיע במאמרים בנושא ניהול של שידור חי וניהול של סרטון על פי דרישה.
לפני שמתחילים
חשוב להכיר את מושגי המבוא והטרמינולוגיה של Video Stitcher API. מידע נוסף מופיע בסקירה הכללית הטכנית.
מבוא
המטא-נתונים של המודעה מכילים אירועי מעקב אחרי ביצועים של מודעות ומודעות נלוות שמשויכות למודעה שחוברו יחד. אירוע מעקב אחרי ביצועים של מודעות מכיל פינג של קריאה חוזרת שמשמש למעקב אחרי מודעת VAST ואינטראקציה של הצופים. מודעה נלווית היא מודעה שנועדה להשלים את מודעת VAST הראשית. במצב מעקב בצד הלקוח, אתם אחראים להפעלת אירועים על סמך התנהגות הצופים.
מעקב אחרי מודעות בצד השרת
במצב מעקב בצד השרת, כל URI של פלח מודעה עטוף ב-URI של הפניה אוטומטית, ו-API של Video Stitcher מטפל בעיבוד של אירועי התקדמות בכל פעם שהנגן מבקש את הפלחים האלה. עם זאת, אירועי פעילות, כמו pause, לא מטופלים על ידי Video Stitcher API.
מעקב אחרי ביצועים של מודעות בצד הלקוח
במצב מעקב בצד הלקוח, הלקוח אחראי להפעלת האירועים. פרטים נוספים מופיעים במאמרי העזרה בנושא אירועים.
אירועי התקדמות הם אירועים שצריכים להיות מופעלים כשפרק הזמן שצוין חלף במהלך הצגת המודעה. לדוגמה, צריך להפעיל את האירוע Start בתחילת המודעה. פרטים נוספים על אירועי התקדמות זמינים באובייקט של אירוע התקדמות.
אירועי פעילות הם אירועים שמופעלים כשצופה מבצע פעילות ספציפית. לדוגמה, האירוע pause צריך להיות מופעל כשהצופה משהה את סרטון המודעה. פרטים נוספים על אירועי פעילות זמינים במאמר בנושא אובייקט אירוע פעילות.
מעקב אחרי ביצועים של מודעות בצד הלקוח ב-VOD
אובייקט של מודעות מעבר מוחזר בתגובה לבקשה ליצירת סשן של תוכן על פי דרישה. הוראות ליצירת סשן VOD זמינות במאמר בנושא יצירת סשן VOD.
הקובץ Interstitials מכיל את המטא-נתונים של כל מודעה שמוצגת. כשמפעילים את מצב מעקב הפרסום בצד הלקוח, הלקוח אחראי להפעלת אירועי מעקב כשצריך. פרטים נוספים זמינים במאמר בנושא אובייקט של מודעות מעבר.
מעקב אחרי ביצועים של מודעות בצד הלקוח בזמן אמת
ממשק ה-API של Video Stitcher מוסיף מודעות לשידור חי באופן רציף. מידע על מטא-נתונים של מודעות נוצר בכל פעם שמוסיפים מודעה חדשה.
ב-HLS, התג AdMetadataURI להבאת מטא-נתונים של מודעות נמצא בתג #EXT-X-DATERANGE.
ב-DASH, את AdMetadataURI לאחזור מטא-נתונים של מודעות אפשר למצוא ברכיב <EventStream> של כל רכיב <Period>.
פרטים נוספים מופיעים במאמר איך מטפלים במעקב בזמן אמת מצד הלקוח.
מודעות נלוות
מודעות נלוות הן מודעות משלימות שעשויות להופיע לצד מודעות ליניאריות שמוצגות בתוך התוכן. פרטים נוספים זמינים במאמר בנושא אובייקט של מודעות משלימות.