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

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

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

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

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

مراجعة رسائل "تصميم الإعلان غير متوافق مع المشغّل"

لا تتعامل حزمة تطوير البرامج للإعلانات التفاعلية (IMA SDK) مع أنواع CreativeMessage التالية:

  • requestChangeVolume
  • requestFullscreen
  • requestExitFullscreen

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

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

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

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

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

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