IMA HTML5 SDK תומך בקריאייטיבים מסוג VPAID 2 JavaScript. אפשר להפעיל את התמיכה בקלות, אך יש שני הבדלים שצריך להכיר בין מפרט VPAID 2 לבין האופן שבו IMA SDK תומך ב-VPAID 2. ההבדלים האלה לא משפיעים על קוד ההטמעה של הנגן או של ה-SDK, אבל הם חשובים ליוצרי קריאייטיב ב-VPAID 2 JavaScript, כי הם עלולים לגרום לשגיאות או לא לפעול כצפוי לאחר עיבוד באמצעות IMA HTML5 SDK.
דרישות מוקדמות
- נגן וידאו בפורמט HTML5 עם שילוב של IMA HTML5 SDK. אם אין לכם חשבון Google, כדאי לעיין במדריך לתחילת העבודה.
- כתובת URL של תג מודעה מסוג VAST שמפנה לקריאייטיב JavaScript מסוג VPAID 2.
פריימרים שימושיים
- אם אתם לא מכירים את VPAID 2, תוכלו לקבל מידע נוסף בדף VPAID של IAB.
הפעלת התמיכה ב-VPAID 2
כדי להפעיל תמיכה ב-VPAID 2 JavaScript, קרא לשיטה הבאה לפני הפעלת AdDisplayContainer:
google.ima.settings.setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.ENABLED); ... var adDisplayContainer = new google.ima.AdDisplayContainer(adContainerElement); var adsLoader = new google.ima.AdsLoader(adDisplayContainer); ...
אלה מצבי ה-VPAID הזמינים:
ENABLED
- הפעלת מודעות VPAID עם הגדרות ברירת המחדל.INSECURE
- הפעלת מודעות VPAID במצב לא מאובטח. מידע נוסף זמין במאמרים אבטחת IFrame ורכיב proxy של נגן וידאו.DISABLED
- לא ניתן להפעיל מודעות VPAID. אם מודעה מבוקשת מחזירה קריאייטיב VPAID, מתקבלת הודעת שגיאה.
אזהרות לגבי תמיכה ב-VPAID 2
אבטחת IFrame
כברירת מחדל, ה-IMA SDK משתמש ב-iframe מאובטח במקום ב-iframe ידידותי (אותו דומיין) או בסקריפט להצגה בדף, כדי לעבד מודעות קריאייטיב מסוג VPAID 2 JavaScript. המשמעות היא שאם קריאייטיב מצפה לגשת ל-DOM של דף ההורה, עלולה להיות שגיאה. במקום זאת, כדי לעבד את המודעה ב-iframe ידידותי, אפשר להשתמש ב-ImaSdkSettings.setVpaidMode(...)
באופן הבא:
adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);
רכיב שרת proxy של נגן וידאו
מטעמי אבטחה ופונקציונליות הולמת של מכשירים ניידים, במצב ENABLED
, IMA HTML5 SDK לא מספק את רכיב הווידאו עצמו של המודעה. במקום זאת, הוא מספק רכיב proxy שמחקה חלק גדול מהפונקציונליות של רכיב הווידאו הרגיל. אם מדובר בנכסי קריאייטיב של מודעות שקוראים לשיטות API נתמכות בלבד, לא אמורים להיות שינויים בהתנהגות בעיבוד של נכסי הקריאייטיב. במצב VpaidMode.INSECURE
, ה-SDK מספק את רכיב נגן הווידאו במקום את שרת ה-proxy.
לפניכם השיטות, המאזינים והמאפיינים הזמינים ברכיב שרת ה-proxy של הווידאו:
שיטות
addEventListener
canPlayType
load
play
pause
setattribute
סוגי אירועים של addEventListener
abort
canplay
canplaythrough
click
durationchange
emptied
ended
error
loadeddata
loadedmetadata
loadstart
pause
play
playing
progress
ratechange
suspend
seeked
seeking
timeupdate
waiting
מאפיינים
currentTime
duration
ended
paused
playbackRate
src
type
שאלות נפוצות
- האם יש תמיכה במודעות קריאייטיב של VPAID 2 JavaScript ב-SDK של iOS או Android?
- IMA HTML5 SDK היא פלטפורמת IMA SDK היחידה שתומכת בשלב זה במודעות קריאייטיב מסוג VPAID 2 JavaScript.
- האם האפשרות הזו מפעילה מודעות VPAID ב-IMA HTML5 SDK?
- כן, ב-IMA HTML5 SDK יש תמיכה במודעות קריאייטיב מסוג VPAID 2 JavaScript.