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

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

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

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

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

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

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

  • requestChangeVolume
  • requestFullscreen
  • requestExitFullscreen

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

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

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

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

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

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