مراجعة التوافق مع SIMID

تتوافق حزمة تطوير البرامج للإعلانات التفاعلية من Google ‏ (IMA) في HTML5 مع الإصدار 1.1 من Secure Interactive Media Interface Definition (SIMID). يتناول هذا الدليل ميزات SIMID والرسائل التي تتوافق معها حزمة IMA SDK.

فهم الرسائل الموجّهة من المواد الإبداعية إلى اللاعبين

يسرد الجدول التالي الرسائل التي يمكن أن يرسلها تصميم الإعلان المتوافق مع SIMID إلى حزمة IMA SDK:

رسالة الوصف
clickThru يتعامل مع نقرات الإعلانات استنادًا إلى معرّف الموارد الموحّد الذي يوفّره تصميم الإعلان.
fatalError تنهي هذه الطريقة جلسة الإعلان وتُبلغ عن خطأ فادح في تصميم الإعلان.
getMediaState تعرض هذه السمة الحالة الحالية لمشغّل الوسائط، بما في ذلك معرّف الموارد المنتظم (URI) والوقت الحالي والمدة ومستوى الصوت وحالة كتم الصوت.
log تعيد توجيه رسائل سجلّ تصميم الإعلان إلى "حزمة تطوير البرامج للإعلانات التفاعلية" من أجل تصحيح الأخطاء.
reportTracking تطلب هذه السمة من "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" إرسال إشارات إلى عناوين URL للتتبُّع نيابةً عن تصميم الإعلان.
requestChangeAdDuration طلبات تعديل إجمالي مدة الجلسة الإعلانية
requestNavigation يطلب التنقّل إلى عنوان URI خارجي.
requestPause طلبات من IMA SDK لإيقاف مشغّل الوسائط مؤقتًا
requestPlay طلبات من حزمة تطوير البرامج للإعلانات التفاعلية (IMA) لاستئناف تشغيل مشغّل الوسائط أو تشغيله
requestResize طلبات تغيير حجم مشغّل الفيديو إذا كان المشغّل يسمح بتغيير الحجم، ستغيّر حزمة IMA SDK حجم المشغّل.
requestSkip يطلب من حزمة SDK تخطّي الإعلان الحالي.
requestStop طلبات من حزمة تطوير البرامج (SDK) لإيقاف الجلسة الإعلانية
handleSkipShown تُعلم هذه السمة "حزمة تطوير البرامج للإعلانات التفاعلية" بأنّ تصميم الإعلان قد عرض واجهة مستخدم لتخطّي الإعلان.
requestFocus يطلب التركيز على إطار iframe الخاص بتصميم الإعلان.

مراجعة الرسائل غير المتوافقة مع مشغّل الفيديو

لا تتعامل حزمة IMA SDK مع أنواع CreativeMessage التالية:

  • requestChangeVolume
  • requestFullscreen
  • requestExitFullscreen

فهم الرسائل التي يرسلها اللاعبون إلى صنّاع المحتوى

يعرض الجدول التالي الرسائل التي تتيح حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية إرسالها إلى تصميم SIMID الإبداعي:

رسالة الوصف
init يتم إرسال هذا الحدث أثناء إعداد الجلسة مع بيانات البيئة ومَعلمات الإعلان.
startCreative يُعلم هذا الحدث تصميم الإعلان ببدء عرض إطار iframe الخاص بتصميم الإعلان.
adStopped يُعلم هذا الحدث بأنّ جلسة الإعلان قد انتهت، ويتضمّن رمز السبب.
adSkipped يُعلم تصميم الإعلان بأنّ المستخدم أو "أداة تطوير برامج إعلانات الوسائط التفاعلية" قد تخطّى الإعلان.
resize تُعلم هذه السمة تصميم الإعلان بالتغييرات في أبعاد المشغّل أو الفيديو.
appBackgrounded يُعلم تصميم الإعلان بأنّ التطبيق قد تم تصغيره.
appForegrounded يُعلم تصميم الإعلان بأنّ التطبيق قد عاد إلى المقدّمة.
fatalError يُعلم تصميم الإعلان بحدوث خطأ من جهة المشغّل.
log يرسل رسائل السجلّ من المشغّل إلى تصميم الإعلان.
focusIn يُعلم هذا الحدث بأنّ تصميم الإعلان قد تم التركيز عليه.

مراجعة إشعارات حالة الوسائط

ترسل حزمة IMA SDK رسائل mediaStateUpdate إلى المادة الإبداعية عند وقوع الأحداث التالية:

  • play
  • pause
  • stalled (جارٍ التخزين المؤقت)
  • seeking
  • seeked
  • ended
  • durationchange
  • timeupdate، بشكل دوري.
  • volumechange بما في ذلك حالة كتم الصوت