קריאייטיבים של 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 משולב. אם אין לכם חשבון, כדאי לעיין במדריך לתחילת העבודה.
  • כתובת 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 של וידאו:

שיטות

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