מידע על Stream Activity Monitor API

‫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.