טעינה מראש של מדיה

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

הפעלת טעינה מראש

כדי להפעיל את הטעינה מראש, מגדירים את הערך של AdsRenderingSettings.enablePreloading כ-true. צריך לעשות זאת כתוצאה מהאירוע ADS_MANAGER_LOADED:

function onAdsManagerLoaded(adsManagerLoadedEvent) {
  var adsRenderingSettings = new google.ima.AdsRenderingSettings();
  adsRenderingSettings.enablePreloading = true;
  ...
  var adsManager = adsManagerLoadedEvent.getAdsManager(
      videoContent, adsRenderingSettings);
}

תזמון

בטבלה הבאה מפורט סיכום של השינויים בלוחות הזמנים לטעינת המודעות כשהטעינה מראש מופעלת:

אירוע	עם טעינה מראש	ללא טעינה מראש
נשלחה בקשה להצגת מודעה מסוג VAST	AdsLoader.requestAds()	AdsLoader.requestAds()
לפני הסרטון נטענה (מודעה יחידה)	AdsManager.init()	AdsManager.start()
מודעה לפני סרטון (pre-roll) נטענה (VMAP/כללי מודעות)	AdsManager.init()	AdsManager.init()
מודעה באמצע הסרטון (mid-roll) או מודעה בסוף הסרטון (post-roll) נטענה	במודעה הראשונה בהפסקה למודעה, 8 שניות לפני זמן ההתחלה של המודעה. במודעות ברצף, כאשר המודעה הקודמת מתחילה לפעול.	בשעת ההתחלה של המודעה.

מגבלות

הטעינה מראש כפופה למגבלות הבאות:

• אי אפשר לטעון מראש מדיה באינטרנט לנייד במכשירי iOS או כשמשתמשים ב-HTML5 IMA SDK בטלוויזיות חכמות מחוברות.
• מודעת VPAID נטענים מראש, אבל יחסי התלות של המודעה – כולל המדיה שמופעלת על ידי המודעה – נטענים עד להפעלת המודעה.
• כדי לטעון מראש מודעות VMAP, צריך להפעיל את ההפעלה האוטומטית. מוודאים שהערך settings.isAutoPlayAdBreaks() מוגדר ל-true, שהוא ערך ברירת המחדל.
• מודעות בסוף סרטון נטענות מראש אחרי המודעה האחרונה באמצע הסרטון, או 8 שניות לפני סוף התוכן אם משתמשים ב-AdsRequest.contentDuration כדי להגדיר את משך הזמן.

שאלות נפוצות

האם טעינה מראש של מדיה טוענת את הקריאייטיב המלא?

לא, הקריאייטיב בדרך כלל לא נטען במלואו כשהפעלת המודעה מתחילה. הטעינה מראש נועדה לשפר את חוויית המשתמש על ידי צמצום הזמן שנדרש לטעינת המודעה. היא לא מיועדת לתמוך בהצגת מודעות אופליין. IMA SDK טוען כמה שיותר מדיה, בהתאם למה שהדפדפן מאפשר, בכפוף לחיבור האינטרנט של המשתמש ולגודל הקריאייטיב.

האם צריך להפעיל טעינה מראש של מדיה עבור ה-VAST וגם על המדיה של המודעה?

לא, ערכת ה-SDK תמיד טוענת מראש את קובץ ה-VAST של המודעה, ללא קשר להגדרת הטעינה המראש.