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

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

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

يسرد الجدول التالي الرسائل التي يمكن أن يرسلها تصميم إعلان SIMID إلى IMA DAI:

رسالة	الوصف
clickThru	ترسل حزمة تطوير البرامج (SDK) في "الإعلانات الديناميكية أثناء البث" إشارات إلى عناوين URL لتتبُّع نسبة النقر إلى الظهور التي تم ضبطها في علامة إعلان "الإعلانات الديناميكية أثناء البث". تتجاهل حزمة تطوير البرامج (SDK) الخاصة بـ "الإعلانات الديناميكية أثناء البث" أي معرّف موارد موحّد (URI) مخصّص أو خيارات تنقّل تقدّمها مادة العرض.
getMediaState	تعرض هذه السمة الحالة الحالية لمشغّل الوسائط، بما في ذلك السمات currentTime وduration وvolume وmuted وpaused وfullscreen. تعرض السمة currentSrc القيمة null دائمًا لأنّ ميزة "إدخال الإعلانات الديناميكي" تستخدم عمليات ربط البث من جهة الخادم.
log	تعيد توجيه رسائل سجلّ تصميم الإعلان إلى تسجيل وحدة تحكّم تصحيح الأخطاء في حزمة تطوير البرامج (SDK) الخاصة بخدمة "الإعلانات الديناميكية أثناء البث" من أجل تحديد المشاكل وحلّها.
reportTracking	طلبات من حزمة تطوير البرامج (SDK) الخاصة بخدمة "الإعلانات الديناميكية داخل الفيديو" لعناوين URL لتتبُّع إشارات ping الخاصة بتصميم الإعلان
requestPause	طلبات من حزمة تطوير البرامج (SDK) الخاصة بـ "إدراج إعلان ديناميكي" لإيقاف مشغّل الوسائط مؤقتًا
requestPlay	طلبات من حزمة تطوير البرامج (SDK) الخاصة بإعلانات الفيديو الديناميكية أثناء البث لاستئناف التشغيل على مشغّل الوسائط
requestSkip	طلبات من حزمة تطوير البرامج (SDK) الخاصة بـ "الإعلانات الديناميكية أثناء البث" لتخطّي الإعلان الحالي تتوفّر هذه الميزة فقط لبث الفيديو عند الطلب. يتم الرفض إذا أرسل تصميم الإعلان هذه الرسالة لبث مباشر.

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

لا تتعامل حزمة تطوير البرامج (SDK) الخاصة بـ "الإعلانات الديناميكية أثناء البث" مع أنواع CreativeMessage التالية:

• fatalError
• requestChangeAdDuration
• requestFullscreen
• requestExitFullscreen
• handleSkipShown
• requestFocus
• requestNavigation: يتم رفضها دائمًا. يتوقّع اللاعب أن يتعامل تصميم الإعلان مع التنقّل.
• requestResize: يتم رفضها دائمًا. لا تتيح حزمة تطوير البرامج (SDK) الخاصة بخدمة "الإعلانات الديناميكية أثناء البث" تغيير حجم تصميم الإعلان.
• requestStop: يتم رفضها دائمًا. هذا النوع مخصّص لحالات الاستخدام ذات المدة الطويلة، والتي لا تتيحها "إعلانات البث المباشر".
• ‫requestChangeVolume: تحلّ حزمة SDK لخدمة "إدراج إعلان ديناميكي" هذا الحدث بنجاح، ولكنّها لا تجري تغييرات في مستوى الصوت للعنصر الإبداعي.

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

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

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

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

لا ترسل حزمة تطوير البرامج DAI SDK الرسائل التالية إلى تصميم الإعلان:

• resize
• appBackgrounded
• appForegrounded
• log

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

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

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

لا تتوافق حزمة تطوير البرامج (SDK) الخاصة بـ "إعلانات البث المباشر" مع الأحداث التالية، ولا تُرسِل تحديثات لحالة الوسائط عند وقوع الأحداث:

• ended
• durationchange
• error