بررسی پشتیبانی SIMID

کیت توسعه نرم‌افزار Google Interactive Media Ads (IMA) برای HTML5 از نسخه ۱.۱ «تعریف میانای رسانه تعاملی ایمن» (SIMID) پشتیبانی می‌کند. این راهنما ویژگی‌ها و پیام‌های SIMID خاصی را که IMA SDK پشتیبانی می‌کند پوشش می‌دهد.

آشنایی با پیام‌های خلاقانه به بازیکن

جدول زیر پیام‌هایی را که طرح آگهی SIMID می‌تواند به کیت توسعه نرم‌افزار IMA ارسال کند فهرست می‌کند:

پیام	شرح
clickThru	کلیک‌های آگهی را براساس URI ارائه‌شده توسط طرح آگهی مدیریت می‌کند.
fatalError	جلسه آگهی را خاتمه می‌دهد و خطای مهلکی را از طرح آگهی گزارش می‌کند.
getMediaState	وضعیت فعلی پخش‌کننده رسانه را برمی‌گرداند، ازجمله URI،‏ currentTime،‏ duration،‏ volume، و وضعیت بی‌صدا.
log	پیام‌های گزارش طرح‌آگهی را برای اشکال‌زدایی به کیت توسعه نرم‌افزار IMA بازارسال می‌کند.
reportTracking	از کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی درخواست می‌کند نشانی‌های وب ردیابی را ازطرف متن آگهی پینگ کند.
requestChangeAdDuration	درخواست‌های تغییر مدت کل جلسه آگهی.
requestNavigation	درخواست پیمایش به URI خارجی.
requestPause	درخواست می‌کند که کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی پخش‌کننده رسانه را موقتاً متوقف کند.
requestPlay	درخواست می‌کند که کیت توسعه نرم‌افزار IMA پخش‌کننده رسانه را ازسر بگیرد یا پخش کند.
requestResize	درخواست تغییر اندازه پخش‌کننده ویدیو. اگر پخش‌کننده اجازه تغییر اندازه را بدهد، «کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی» اندازه پخش‌کننده را تغییر می‌دهد.
requestSkip	درخواست می‌کند که کیت توسعه نرم‌افزار از آگهی فعلی رد شود.
requestStop	درخواست می‌کند که کیت توسعه نرم‌افزار جلسه آگهی را متوقف کند.
handleSkipShown	به کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی اطلاع می‌دهد که طرح‌آگهی میانای کاربری رد کردن آگهی را نمایش داده است.
requestFocus	درخواست فوکوس برای iframe طرح آگهی.

بازبینی پیام‌های «طرح آگهی پشتیبانی‌نشده برای پخش‌کننده»

کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی انواع CreativeMessage زیر را مدیریت نمی‌کند:

• requestChangeVolume
• requestFullscreen
• requestExitFullscreen

آشنایی با پیام‌های بازیکن به طرح‌آگهی

جدول زیر پیام‌هایی را که IMA SDK از ارسال آن‌ها به طرح آگهی SIMID پشتیبانی می‌کند فهرست می‌کند:

پیام	شرح
init	درطول راه‌اندازی جلسه با داده‌های محیطی و پارامترهای آگهی ارسال می‌شود.
startCreative	به طرح‌آگهی اطلاع می‌دهد که iframe طرح‌آگهی را آغاز و نمایش دهد.
adStopped	اطلاع می‌دهد که جلسه آگهی به‌پایان رسیده است، ازجمله کد دلیل.
adSkipped	به طرح آگهی اطلاع می‌دهد که کاربر یا کیت توسعه نرم‌افزار IMA از آگهی رد شده است.
resize	تغییرات ابعاد ویدیو یا پخش‌کننده را به طرح آگهی اطلاع می‌دهد.
appBackgrounded	به طرح آگهی اطلاع می‌دهد که برنامه وارد پس‌زمینه شده است.
appForegrounded	به طرح‌آگهی اطلاع می‌دهد که برنامه به پیش‌زمینه برگشته است.
fatalError	خطای سمت پخش‌کننده را به متن آگهی اطلاع می‌دهد.
log	پیام‌های گزارش را از پخش‌کننده به طرح‌آگهی ارسال می‌کند.
focusIn	اطلاع می‌دهد که طرح‌آگهی تمرکز را دریافت کرده است.

بازبینی به‌روزرسانی‌های وضعیت رسانه

کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی پیام‌های mediaStateUpdate را برای رویدادهای زیر به طرح‌آگهی ارسال می‌کند:

• play
• pause
• stalled (درحال میان‌گیری)
• seeking
• seeked
• ended
• durationchange
• ‫timeupdate، به‌صورت دوره‌ای.
• volumechange شامل وضعیت بی‌صدا.