تتوافق حزمة تطوير البرامج (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 التالية:
requestChangeVolumerequestFullscreenrequestExitFullscreen
فهم رسائل اللاعبين إلى رسائل المواد الإبداعية
يسرد الجدول التالي الرسائل التي تتيح حزمة تطوير البرامج للإعلانات التفاعلية (IMA SDK) إرسالها إلى تصميم إعلان SIMID:
| رسالة | الوصف |
|---|---|
init |
يتم إرسال هذا الطلب أثناء إعداد الجلسة مع بيانات البيئة ومَعلمات الإعلان. |
startCreative |
يُرسل إشعارًا إلى تصميم الإعلان لبدء عرض إطار iframe الخاص به. |
adStopped |
يُرسل إشعارًا بانتهاء الجلسة الإعلانية، بما في ذلك رمز السبب. |
adSkipped |
يُعلم تصميم الإعلان بأنّ المستخدم أو حزمة تطوير البرامج للإعلانات التفاعلية (IMA SDK) قد تخطّى الإعلان. |
resize |
يُعلم تصميم الإعلان بالتغييرات في أبعاد المشغّل أو الفيديو. |
appBackgrounded |
يُعلم تصميم الإعلان بأنّ التطبيق قد دخل في الخلفية. |
appForegrounded |
يُعلم تصميم الإعلان بأنّ التطبيق قد عاد إلى المقدّمة. |
fatalError |
يُعلم تصميم الإعلان بحدوث خطأ من جانب المشغّل. |
log |
يرسل رسائل مسجّلة من المشغّل إلى تصميم الإعلان. |
focusIn |
يُرسل إشعارًا بأنّ تصميم الإعلان قد تم التركيز عليه. |
مراجعة تعديلات حالة الوسائط
ترسل حزمة تطوير البرامج للإعلانات التفاعلية (IMA SDK) رسائل mediaStateUpdate إلى تصميم الإعلان للأحداث التالية:
playpause-
stalled(جارٍ التخزين مؤقتًا) seekingseekedendeddurationchange-
timeupdate، بشكل دوري volumechangeبما في ذلك حالة كتم الصوت