הפעלת נכסי קריאייטיב של 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 ידידותי (אותו דומיין) או בסקריפט בדף כדי לעבד נכסי קריאייטיב של 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 של הווידאו:

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.