הפעלת נכסי קריאייטיב של VPAID 2 ב-JavaScript

‫IMA HTML5 SDK תומך בקריאייטיבים של VPAID 2 JavaScript. כשמפעילים תמיכה, חשוב להכיר שני הבדלים עיקריים בין המפרט של VPAID 2 לבין האופן שבו IMA SDK תומך ב-VPAID 2. ההבדלים האלה לא משפיעים על הקוד להטמעה של נגן או SDK, אבל הם חשובים ליוצרים של נכסי קריאייטיב ב-JavaScript של VPAID 2, כי יכול להיות שנכסי קריאייטיב יחזירו שגיאות או לא יפעלו כמצופה כשהם מוצגים על ידי IMA HTML5 SDK.

דרישות מוקדמות

כדי לעקוב אחרי המדריך הזה, צריך להתחיל עם אפליקציה שיש לה את הדברים הבאים:

  • נגן וידאו בפורמט HTML5 עם שילוב של IMA HTML5 SDK. אם אין לכם חשבון כזה, כדאי לעיין במאמר הגדרת IMA SDK.
  • כתובת URL של תג מודעה ב-VAST שמפנה לקריאייטיב JavaScript ב-VPAID 2.

חומרי מבוא מועילים

  • אם אתם לא מכירים את VPAID 2, תוכלו לקרוא מידע נוסף בדף VPAID של IAB.

הפעלת תמיכה ב-VPAID 2

כדי להפעיל תמיכה ב-JavaScript ב-VPAID 2, צריך לקרוא למתודה הבאה לפני שמפעילים את 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 מופיע במסמכי העזרה בנושא ממשק ה-API של ImaSdkSettings.VpaidMode.

הערות לגבי תמיכה ב-VPAID 2

אבטחת IFrame

כברירת מחדל, IMA SDK משתמש ב-iframe מאובטח במקום ב-iframe ידידותי (מאותו דומיין) או בסקריפט בדף כדי לבצע רינדור של נכסי קריאייטיב ב-JavaScript בפורמט VPAID 2. כלומר, אם קריאייטיב מצפה לגשת ל-DOM של דף האב, יכול להיות שזה יגרום לשגיאה. כדי להציג את המודעה ב-iframe ידידותי במקום זאת, אפשר להשתמש ב-ImaSdkSettings.setVpaidMode(...) באופן הבא:

adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);

רכיב proxy של נגן וידאו

מטעמי אבטחה ופונקציונליות תקינה בנייד, במצב ENABLED, IMA HTML5 SDK לא מספק את רכיב הווידאו בפועל למודעה, אלא רכיב proxy שמדמה חלק גדול מהפונקציונליות של רכיב הווידאו הרגיל. אם נכסי הקריאייטיב של המודעות קוראים רק לשיטות נתמכות של API, לא אמורים להיות שינויים בהתנהגות של הרינדור של נכסי הקריאייטיב. במצב VpaidMode.INSECURE, ה-SDK מספק את רכיב נגן הווידאו במקום את ה-proxy.

אלה השיטות, המאזינים והמאפיינים שזמינים ברכיב של שרת ה-proxy של הווידאו:

Methods

  • 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 ב-iOS או ב-Android SDK?
‫IMA HTML5 SDK היא פלטפורמת IMA SDK היחידה שתומכת בנכסי קריאייטיב של VPAID 2 JavaScript.
האם ההגדרה הזו מאפשרת שימוש בנכסי קריאייטיב של VPAID ב-IMA HTML5 SDK?
כן, IMA HTML5 SDK תומך בקריאייטיבים של VPAID 2 JavaScript.