تفعيل تصميمات الإعلانات المستندة إلى JavaScript في VPAID 2

تتوافق حزمة IMA HTML5 SDK مع تصاميم إعلانات VPAID 2 JavaScript. عند تفعيل التوافق، هناك اختلافان رئيسيان يجب مراعاتهما بين مواصفات VPAID 2 والطريقة التي تتوافق بها حزمة IMA SDK مع VPAID 2. لا تؤثّر هذه الاختلافات في رمز تنفيذ المشغّل أو حزمة تطوير البرامج (SDK)، ولكنّها مهمة لمؤلّفي تصاميم إعلانات معيار دقّة واجهة عرض الإعلانات على مشغّل الفيديو (VPAID) 2 JavaScript، لأنّ تصاميم الإعلانات قد تطرح أخطاء أو لا تعمل على النحو المتوقّع عند عرضها من خلال حزمة تطوير البرامج (SDK) لخدمة IMA HTML5.

المتطلبات الأساسية

للاستفادة من هذا الدليل، ابدأ بتطبيق يتضمّن ما يلي:

  • مشغّل فيديو HTML5 مدمَج مع حزمة IMA HTML5 SDK إذا لم يكن لديك مشغّل فيديو، يمكنك الاطّلاع على مقالة إعداد حزمة IMA SDK.
  • عنوان URL لعلامة إعلان VAST يشير إلى تصميم إعلان VPAID 2 JavaScript

معلومات أساسية مفيدة

  • إذا لم تكن على دراية بمعيار VPAID 2، يمكنك قراءة المزيد في صفحة IAB VPAID.

تفعيل التوافق مع 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 و عنصر وكيل مشغّل الفيديو.
  • DISABLED : لا يتم تشغيل إعلانات VPAID. إذا كان الإعلان المطلوب يعرِض تصميم إعلان VPAID، يتم عرض خطأ.

لمزيد من المعلومات عن أوضاع VPAID، يُرجى الاطّلاع على مستندات واجهة برمجة التطبيقات الخاصة بـ ImaSdkSettings.VpaidMode.

التحذيرات بشأن التوافق مع VPAID 2

أمان إطار iframe

تستخدم حزمة IMA SDK تلقائيًا إطار iframe آمنًا بدلاً من إطار iframe عادي (النطاق نفسه) أو نص برمجي مضمّن في الصفحة لعرض تصاميم إعلانات VPAID 2 JavaScript. هذا يعني أنّه إذا كان تصميم الإعلان يتوقّع الوصول إلى نموذج العناصر في مستند الصفحة الرئيسية، قد يؤدي ذلك إلى حدوث خطأ. لعرض إعلانك في إطار iframe عادي بدلاً من ذلك، يمكنك استخدام ImaSdkSettings.setVpaidMode(...) على النحو التالي:

adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);

عنصر وكيل مشغّل الفيديو

لضمان الأمان والأداء السليم على الأجهزة الجوّالة، لا توفّر حزمة IMA HTML5 SDK عنصر الفيديو الفعلي للإعلان في وضع ENABLED، بل توفّر عنصر وكيل يحاكي معظم وظائف عنصر الفيديو العادي. بالنسبة إلى تصاميم الإعلانات التي تستدعي طرق واجهة برمجة التطبيقات المتوافقة فقط، لن تحدث أي تغييرات في سلوك عرض تصاميم الإعلانات. في وضع VpaidMode.INSECURE، توفّر حزمة SDK عنصر مشغّل الفيديو بدلاً من عنصر الوكيل.

في ما يلي الطرق والمستمعون والسمات المتاحة في عنصر وكيل الفيديو:

الطُرق

  • 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 مع حزمتَي iOS SDK أو Android SDK؟
حزمة IMA HTML5 SDK هي منصة حزمة IMA SDK الوحيدة التي تتوافق مع تصاميم إعلانات VPAID 2 JavaScript.
هل يؤدي ذلك إلى تفعيل تصاميم إعلانات VPAID في حزمة IMA HTML5 SDK؟
نعم، تتوافق حزمة IMA HTML5 SDK مع تصاميم إعلانات VPAID 2 JavaScript.