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

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

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

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

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

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

لا تتعامل "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" مع أنواع CreativeMessage التالية:

  • requestChangeVolume
  • requestFullscreen
  • requestExitFullscreen

فهم الرسائل التي تظهر للاعبين بشأن المواد الإبداعية

يسرد الجدول التالي الرسائل التي تتيح "أداة تطوير البرامج لإعلانات الوسائط التفاعلية" إرسالها إلى تصميم SIMID الإبداعي:

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

مراجعة التغييرات في حالة الوسائط

ترسل "حزمة تطوير البرامج للإعلانات التفاعلية" رسائل mediaStateUpdate إلى تصميم الإعلان عند وقوع الأحداث التالية:

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