تتيح حزمة IMA SDK التحميل المُسبَق لمواد عرض إعلانات الفيديو. يمكنك تفعيل هذه الميزة في عملية دمج حزمة 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() |
| تم تحميل إعلان ما قبل التشغيل (قائمة تشغيل إعلانات الفيديو المتعددة/قواعد الإعلانات) | AdsManager.init() |
AdsManager.init() |
| تم تحميل إعلان أثناء التشغيل أو إعلان ما بعد التشغيل | بالنسبة إلى الإعلان الأول في فاصل إعلاني، قبل 8 ثوانٍ من وقت بدء الإعلان بالنسبة إلى الإعلانات المتتالية، عندما يبدأ تشغيل الإعلان السابق | في وقت بدء الإعلان |
القيود
يخضع التحميل المُسبَق للقيود التالية:
- لا تتوفّر ميزة التحميل المُسبَق للوسائط على الويب على الأجهزة الجوّالة التي تعمل بنظام التشغيل iOS أو عند استخدام أداة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية على أجهزة التلفزيون الذكية المتصلة.
- يتم التحميل المُسبَق لبروتوكول VPAID، ولكن لا يتم تحميل أي من العناصر التابعة للإعلان، بما في ذلك الوسائط التي يعرضها الإعلان، إلى أن يتم تنفيذ الإعلان.
- يجب تفعيل ميزة "التشغيل التلقائي" لتحميل إعلانات VMAP مسبقًا. تأكَّد من ضبط
settings.isAutoPlayAdBreaks()علىtrue، وهي القيمة التلقائية. - يتم تحميل الإعلانات بعد التشغيل مسبقًا بعد آخر إعلان أثناء التشغيل، أو قبل 8 ثوانٍ من نهاية المحتوى إذا تم استخدام
AdsRequest.contentDurationلتحديد المدة.
الأسئلة الشائعة
- هل يؤدي التحميل المُسبَق للوسائط إلى تحميل تصميم الإعلان الكامل؟
- لا، لا يتم عادةً تحميل تصميم الإعلان بالكامل عند بدء تشغيل الإعلان. يهدف التحميل المُسبَق إلى تحسين تجربة المستخدم من خلال تقليل الوقت الذي يستغرقه تحميل الإعلان. وهي غير مخصّصة لعرض الإعلانات بلا إنترنت. تحمّل حزمة تطوير البرامج IMA SDK أكبر قدر ممكن من الوسائط يسمح به المتصفّح، مع مراعاة قيود سرعة اتصال المستخدم بالإنترنت وحجم تصميم الإعلان.
- هل يجب تفعيل التحميل المُسبَق للوسائط من أجل نموذج عرض إعلانات الفيديو (VAST) الخاص بالإعلان بالإضافة إلى الوسائط؟
- لا، تحمّل حزمة تطوير البرامج (SDK) دائمًا ملف VAST الخاص بالإعلان مسبقًا، بغض النظر عن إعداد التحميل المسبق هذا.