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