קריאייטיבים של JavaScript מסוג VPAID 2

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, עיינו במסמכי התיעוד בנושא 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 של הווידאו:

שיטות

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