Dynamic Ad Insertion (DAI) Stream Activity Monitor (SAM) API מאפשר לבדוק ולפתור בעיות בסשנים ספציפיים של צפייה בשידורים חיים ובסרטוני וידאו על פי דרישה (VOD).
כדי לבדוק באופן חזותי ולפתור בעיות בסשן צפייה בשידור חי או בווידאו על פי דרישה (VOD), אתם יכולים להשתמש בכלי לניהול שידור (SAM) בממשק המשתמש של Google Ad Manager.
כדי לאחזר באופן פרוגרמטי נתוני אבחון של סשן, משתמשים במשאב networks.daiSessions ב-Ad Manager API.
הסבר על תרחישי השימוש
באמצעות SAM API, אתם יכולים להפעיל אוטומציה של ניתוח הנתונים של השידורים ולפתור בעיות בהצגת המודעות בשילובים של DAI, כמו:
- אימות יצירת סשן סטרימינג: מאמתים את הפרמטרים, מצב החיבור של
STITCHEDאוPOD_SERVING, מצב הדיווח והמטא-נתונים של התוכן ש-Google DAI מקבלת כשהיא יוצרת סשן של שידור חי או של וידאו על פי דרישה (VOD). - בדיקת בקשות להצגת מודעות ותגובות לבקשות: בודקים תגי מודעות יוצאים מסוג Video Ad Serving Template (VAST) ו-Video Multiple Ad Playlist (VMAP), קודי סטטוס של HTTP, זמני אחזור של תגובות, גופי תגובות XML גולמיים ושרשראות הפניה אוטומטית של wrapper.
- פתרון בעיות בקריאייטיבים ובקבלת ההחלטות לגבי רצפי מודעות: בודקים אילו מודעות נבחרו או הוסרו על ידי Google DAI בכל רצף, את משך הזמן של כל מודעה ברצף ואת מערכת המודעות שממנה מגיע הקריאייטיב של המודעה.
- מעקב אחרי ביצוע של אחזור מודעות מראש: בודקים אם מערכת Google DAI מאחזרת מראש רצף מודעות, ובודקים את שלב האחזור מראש של כל רצף מודעות.
- אימות של קריאות ל-DAI Ad Break API ול-Pod serving DAI API: בודקים את הביצוע בפועל של ההפסקות למודעות, את משך המודעות שהוצגו ואת משך השקופיות שהוכנסו, ומשווים אותם לקריאות ל-API, כמו DAI Ad Break API ו-Pod serving DAI API.
- אימות המעקב אחרי אירועי מודעות: בודקים אם הפינגים של המעקב בצד הלקוח או בצד השרת הצליחו, ובוחנים את תגובות ה-HTTP משרתי המודעות.
- מעקב אוטומטי אחרי סשנים והתראות: ניתוח רשומות של ממצאים מובְנים עם רמת חומרה
INFO,WARNINGאוERRORכדי לזהות בעיות בהפעלה או במונטיזציה בבדיקות שילוב אוטומטיות ובצינורות עיבוד נתונים למעקב אחרי סביבת הייצור.
מידע על המשאב ברמה העליונה
SAM API הוא חלק מ-Google Ad Manager API בארכיטקטורת REST (בטא) בנקודת הקצה admanager.googleapis.com, והוא חושף את השיטה networks.daiSessions.get לקריאה בלבד. אפשר לשלוח שאילתה למשאב DaiSession עם מזהה סשן של DAI או מפתח ניפוי באגים בהתאמה אישית. ההקלטות של הסשנים נשמרות ב-DAI עד שלושה ימים אחרי ההפעלה.
SAM API לא תומך בהצגת רשימה של כל המשאבים של DaiSession ברשת Google Ad Manager.
בדיקת התגובות של שידורי DAI באמצעות SAM
כדי לבדוק איך Google DAI מעבדת את הבקשות לשידור, בודקים את התגובה של DaiSession:
- Full-service DAI API: בודקים את השדה
creationContext.streamCreateRequestכדי לאמת את הקריאה לרישום הסטרימינג, בודקים את המפותadSelectionsו-adPodsכדי לבחון את קבלת ההחלטות לגבי המודעות, ובוחנים את המפהadBreaksכדי לאשר את משך הזמן של המודעה המחוברת, של הקריאייטיב של השקופית ושל התוכן הבסיסי. - Pod serving DAI API: ודאו שהשדה
creationContext.stitchingTypeמוגדר לערךPOD_SERVING, הצליבו את השדהadBreakIdבמפותadPodsו-adBreaksעם הקריאות לבקשות של המניפסט של ה-pod או של הפלח של ה-pod, ובדקו את המשואות לאימות בצד השרת או לאימות המדיה במפהtrackingPings. - DAI Ad Break API: הערך
breakSequenceשל אובייקטAdBreakצריך להיות זהה לערך של המאפייןAdBreak.breakSequence.
שליחת הבקשה הראשונה
כדי להגדיר אימות ולאחזר משאבים של סשן DAI, עיינו במאמר שימוש ב-Stream Activity Monitor API.