بررسی پشتیبانی و سازگاری کیت توسعه نرم‌افزار

این صفحه اطلاعات کلی درباره پشتیبانی و سازگاری IMA DAI برای مرورگرها، قالب‌های ویدیو، و پلاتفرم‌ها ارائه می‌دهد.

قالب‌های ویدیو و مرورگرهای پشتیبانی‌شده

‫HTML5 هنوز یک استاندارد جدید و درحال تکامل است. در نتیجه، پشتیبانی از ویژگی‌های مختلف در مرورگرها متفاوت است و هیچ قالب ویدیویی پیش‌فرضی وجود ندارد که توسط همه مرورگرهای اصلی پشتیبانی شود. سه قالب اصلی ویدیو که در اکثر مرورگرها استفاده می‌شود عبارت‌اند از H.264،‏ HLS، و Dash.

سازگاری رویداد VAST

این بخش رویدادهای VAST را که براساس اطلاعات برگشتی در پاسخ VAST به‌طور خودکار به سرور گزارش می‌شوند فهرست می‌کند.

کاملاً پشتیبانی می‌شود

complete، creativeView، firstQuartile، impression، midpoint، pause، resume، rewind (زمانی فعال می‌شود که جستجوی قابل‌توجهی در جهت عقب وجود داشته باشد)، start، thirdQuartile.

تقریباً پشتیبانی‌شده

• click

  رویداد Click فقط برای آگهی‌های ویدیویی ارسال می‌شود. کلیک‌ها را نمی‌توان در پخش‌کننده‌های تمام‌صفحه بومی در Android،‏ iOS، یا رایانه ضبط کرد، اما وقتی ویدیو بسته می‌شود، کلیک‌ها را همچنان می‌توان با عنصر ردیابی کلیک درون‌صفحه‌ای ضبط کرد. بااین‌حال، اگر عنصر ویدیو از کنترل‌های بومی در iPad استفاده کند، کلیک‌ها نمی‌توانند ضبط شوند.

• fullscreen
  

  ‫IMA از حالت تمام‌صفحه شبیه‌سازی‌شده پشتیبانی می‌کند، که در آن ویدیو کل پنجره مرورگر را اشغال می‌کند. IMA ویدیو را زمانی در حالت تمام‌صفحه درنظر می‌گیرد که offsetWidth و offsetHeight آن حداقل به‌اندازه بدنه سند باشد. این حالت در همه مرورگرها پشتیبانی می‌شود.

  در iPhone و پلاتفرم‌های Android قبل‌از نسخه ۳.۰، ویدیو همیشه در حالت تمام‌صفحه پخش می‌شود.

• mute، unmute

  ‫iOS و Android فقط کنترل بومی میزان صدا را دارند. به‌همین دلیل، IMA نمی‌تواند وضعیت صدا یا بی‌صدا را تعیین کند و کیت توسعه نرم‌افزار نیز از تغییرات مطلع نمی‌شود. در زیر فهرستی از نسخه‌های مرورگر که از mute، unmute پشتیبانی می‌کنند و نمی‌کنند ارائه شده است:

  • پشتیبانی‌شده: Firefox 3.5+‎،‏ Chrome 8+‎،‏ Safari 4+‎
  • پشتیبانی نمی‌شود: iOS،‏ Android

برای جزئیات بیشتر درباره ارائه آگهی VAST، به رهنمودهای IAB مراجعه کنید.

رویدادهای آگهی هنگام تماشای مجدد وقفه‌های آگهی

IMA رویدادهای آگهی را هنگام تماشای مجدد آگهی‌ها به دلایل زیر فعال نمی‌کند:

• نشانی‌های وب رویداد باید فقط یک‌بار راه‌اندازی شوند، درغیراین‌صورت ممکن است به‌عنوان رفتار هرزنامه‌ای تلقی شوند.
• این کار به کاربران اجازه می‌دهد در داخل و اطراف وقفه‌های آگهی که قبلاً مشاهده کرده‌اند، جستجو کنند، که تجربه جستجوی بهتری را ایجاد می‌کند.

این‌ها تنها رویدادهایی هستند که هنگام تماشای مجدد وقفه‌های آگهی فعال می‌شوند:

• AD_PERIOD_STARTED
• AD_PERIOD_ENDED

پلاتفرم‌های پخش‌کننده ویدیو پشتیبانی‌شده

کیت‌های توسعه نرم‌افزار Google IMA در پلاتفرم‌های زیر پشتیبانی می‌شوند:

پلاتفرم	نسخه
HTML5	رایانه: Chrome،‏ Firefox،‏ Safari،‏ Edge،‏ Opera تلفن همراه: Chrome/Android Browser (Android برای تلفن‌ها و رایانه‌های لوحی)،‏ Safari و Chrome (iOS)
iOS	‫iOS نسخه ۱۰.۰ یا بالاتر
Android	‫Android 4.4+‎
Google Cast	همه دستگاه‌های پخش محتوا
tvOS	tvOS 15+‎
Roku	همه دستگاه‌هایی که هنوز از Roku به‌روزرسانی نرم‌افزار دریافت می‌کنند

پشتیبانی از قالب جاری‌سازی ویدیو

‫IMA از هر دو HLS و DASH در کیت‌های توسعه نرم‌افزار خود پشتیبانی می‌کند. برای پشتیبانی از پلاتفرم‌های خاص کیت توسعه نرم‌افزار، این جدول را ببینید. برای بازپخش مناسب جاری‌سازی، پخش‌کننده ویدیو شما باید از نوع جاری‌سازی مورداستفاده پشتیبانی کند.

پلاتفرم کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی	HLS	DASH
HTML5
iOS
Android
Google Cast
tvOS
Roku

ویژگی‌های ویدیو و نسخه‌های کیت توسعه نرم‌افزار

برای کسب اطلاعات بیشتر درباره ویژگی‌های زیر، نمای کلی تبلیغات ویدیویی را بخوانید.

مجموعه ویدیویی IAB	پشتیبانی
VAST 4	‫ ۱
VAST 3	۲
VAST 2
VPAID 2
VMAP 1.0.1	۳
ویژگی‌های Ad Manager Video	پشتیبانی
آگهی‌های خطی
آگهی‌های غیرخطی (هم‌پوشانی‌ها)
همراهان	۴
منابع آگهی همپای جایگزین VAST 3
قابلیت مشاهده «بازدید فعال»
بازهدایت‌های VAST
جای‌گذاری همراه با درخواست نمایش
سازگاری «برچسب ناشر Google» ‏ (GPT)
آگاهی از محتوا
قوانین آگهی
پادکست‌سازی
ضربه‌گیرها
گزارش‌دهی درباره ردیابی چند رویداد (MET)
ردشدنی (رزرو / غیر TrueView)	۵
ویژگی‌های «AdSense برای ویدیو» ۷	پشتیبانی
TrueView InStream	‫۶
InStream Select
درون‌جاری‌سازی استاندارد
تمام‌شکاف
همراهان	۴
رفع نواقص همراه
همپوشانی ها
ویژگی‌های Ad Manager Ad Exchange	پشتیبانی
TrueView InStream	‫۶
InStream Select
درون‌جاری‌سازی استاندارد
تمام‌شکاف
همراهان	۴
رفع نواقص همراه
همپوشانی ها
قابلیت مشاهده «بازدید فعال»
چرا این آگهی؟	۸

^۱ از ویژگی‌های VAST 4 پشتیبانی‌شده توسط Google Ad Manager، IMA از ویژگی‌های زیر پشتیبانی می‌کند:

• ‫VAST 4.2
  • پشتیبانی از تعریف میانای رسانه تعاملی ایمن (SIMID)
  • مجاز کردن چند گره UniversalAdID
• VAST 4.0
  • شناسه تبلیغاتی
  • فایل میانه‌نشین
  • کدهای خطای جدید VAST
  • ماکروهای جدید VAST
  • AdVerifications پشتیبانی

^۲ ویژگی‌های VAST 3.0 زیر هنوز پشتیبانی نمی‌شوند:

• ‫adSlotId همراه
• گزینه‌های تحویل همیار
• نمادها

^۳ ویژگی‌های VMAP زیر هنوز پشتیبانی نمی‌شوند:

• رویدادهای پیگیری مختص VMAP
• کدهای خطای مختص VMAP
• آگهی‌های هم‌پوشانی
• انحراف‌های زمانی غیر از hh:mm:ss یا «شروع» و «پایان»
• نمایش مشخصه breakType
• ‫repeatAfter مشخصه

^۴ فقط از همراهان تصویری پشتیبانی می‌شود. تصاویر همراه برای پر کردن آگهی‌ها به پیاده‌سازی سفارشی نیاز دارند. آگهی‌های همراه در tvOS پشتیبانی نمی‌شوند.

^۵ آگهی‌های ردشدنی سنتی فقط در کیت‌های توسعه نرم‌افزار IMA DAI برای HTML5،‏ iOS،‏ tvOS،‏ Roku، و Android (ازجمله Android TV) پشتیبانی می‌شوند. با «کیت توسعه نرم‌افزار Cast»، باید قابلیت رد کردن را با StreamRequest.senderCanSkip اعلام کنید تا از آگهی‌های ردکردنی سنتی پشتیبانی کنید.

^۶ آگهی‌های ردشدنی TrueView در کیت‌های توسعه نرم‌افزار IMA DAI برای HTML5،‏ iOS،‏ tvOS،‏ Roku، و Android (ازجمله Android TV) پشتیبانی می‌شوند.

^۷ ویژگی AdSense در Cast SDK پشتیبانی نمی‌شود.

^‫۸ چرا این آگهی؟ مستلزم آن است که پارامتر adUiElement هنگام ایجاد StreamManager ارسال شود. چرا این آگهی؟ در «کیت توسعه نرم‌افزار Cast» پشتیبانی نمی‌شود.

نکات مهم برای چارچوب‌های جاوا اسکریپت

هنگام استفاده از چارچوب JavaScript، مانند React یا AngularJS، با «کیت توسعه نرم‌افزار IMA HTML5»، ملاحظات خاصی وجود دارد. این چارچوب‌ها اغلب عناصر DOM را جابه‌جا می‌کنند، که می‌تواند باعث ازکار افتادن «کیت توسعه نرم‌افزار IMA» شود زیرا این کیت انتظار دارد DOM هنگام شروع به کار ثابت باشد. «کیت توسعه نرم‌افزار IMA» از چارچوب‌های جاوا اسکریپت پشتیبانی می‌کند اگر کیت توسعه نرم‌افزار پس‌از اتمام حرکت عناصر DOM توسط چارچوب آغاز شود. به‌طور دقیق، عنصر HTML5 که به‌عنوان آرگومان adUiElement هنگام ساختن StreamManager ارسال می‌شود نباید پس‌از نمونه‌سازی جابه‌جا شود.