google.
מודעה יכולה להיות חלק מרצף של מודעות. האובייקט חושף מטא-נתונים שקשורים ל-pod, כמו מספר המודעות ב-pod ומיקום המודעה ב-pod.
לעתים קרובות, ה-API של getTotalAds הכלול באובייקט הזה נכון, אך בתרחישים מסוימים הוא מייצג את הניחוש הטוב ביותר של ה-SDK. מידע נוסף זמין
במסמכי התיעוד של השיטה הזו.
שיטות
getAdPosition
getAdPosition() מספר החזרות
מחזירה את מיקום המודעה.
- החזרות
-
numberמיקום המודעה בתוך ה-pod. הערך המוחזר מבוסס על בסיס, לדוגמה, 1 מתוך 2, 2 מתוך 2 ועוד.
getIsBumper
getIsBumper() החזרה בוליאני
פונקציה זו מחזירה את הערך True אם המודעה היא מודעת באמפר. מודעות באמפר הן מודעות לינאריות קצרות שיכולות להודיע למשתמש כשהמשתמש נכנס למודעה או יוצא ממנה.
- החזרות
-
booleanבין אם המודעה היא מודעת באמפר.
getMaxDuration
getMaxDuration() return number
משך הזמן המקסימלי של ה-pod בשניות. למשך פרק זמן לא ידוע, מוחזר -1.
- החזרות
-
numberמשך הזמן המקסימלי של המודעות ב-Pod הזה בשניות.
getPodIndex
getPodIndex() מספר החזרות
צד הלקוח ו-DAI VOD: מחזיר את אינדקס ה-Pod של המודעה. עבור רצף לפני סרטון, מחזירה 0. עבור מודעות באמצע סרטון, מחזירה 1, 2,..., לא. לערך Pod לאחר צפייה, מחזירה 1-. ערך ברירת המחדל הוא 0 אם המודעה היא לא חלק מ-pod, או שה-pod הזה לא שייך לפלייליסט. שידור חי ב-DAI: תמיד: 1-.
- החזרות
-
numberהאינדקס של ה-pod בפלייליסט של המודעה.
getTimeOffset
getTimeOffset() מחזיר מספר
מחזירה את הבדל הזמן שמוגדר לתוכן שבו נקבע הרצף הנוכחי של המודעות. עבור פודקאסטים ב-VOD בסטרימינג עם מודעות שנוספו באופן דינמי, זמן השידור מוחזר.
ל-pre-roll, מוחזר 0. עבור מודעות באמצע סרטון, מוחזרת השעה המתוזמנת. לאחר הצפייה, מחזירה 1-.
ערך ברירת המחדל הוא 0 אם המודעה היא לא חלק מ-pod או שה-pod לא שייך לפלייליסט של מודעה.
- החזרות
-
numberהיסט הזמן לרצף המודעות הנוכחי.
getTotalAds
getReturnAds() מספר החזרה
המספר הכולל של מודעות בתוך הקבוצה הזו, כולל מודעות באמפר. מודעות באמפר הן מודעות לינאריות קצרות שיכולות להופיע בפני המשתמש במהלך הכניסה למודעה או ההפסקה מהמודעה.
אם המודעה לא נכללת ב-Pod, ערך ברירת המחדל הוא 1.
בתרחישים מסוימים, ה-SDK לא יודע בוודאות כמה מודעות נכללות בתוך מאגר המודעות הזה. התרחישים האלה כוללים רצף מודעות, שהן כמה מודעות בתוך תג מודעה יחיד. בתרחישים האלה, הערך של מספר אירועי המודעות הראשונים שיופעלו (AD_METADATA, LOADED ועוד) עשוי להיות המספר הכולל של תגי המודעות שהתקבלו מהתגובה בפלייליסט. מומלץ להשתמש באירוע FIRST_QUARTILE כאירוע שבו בעלי התוכן הדיגיטלי מושכים מידע מהאובייקט הזה ומעדכנים את הרכיבים החזותיים של הנגן, אם קיימים כאלה.
- החזרות
-
numberמספר המודעות הכולל ב-Pod.