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

پلاتفرم را انتخاب کنید: HTML5 Android iOS tvOS

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

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

پشتیبانی از ویژگی‌های مختلف در مرورگرها متفاوت است و هیچ قالب ویدیویی پیش‌فرض واحدی وجود ندارد که همه مرورگرهای اصلی از آن پشتیبانی کنند. سه قالب اصلی ویدیو که در اکثر مرورگرها استفاده می‌شود عبارتند از H.264،‏ WebM، و Ogg Theora.

پخش‌کننده‌های ویدیو پشتیبانی‌شده

اکثر ویژگی‌های IMA توسط پخش‌کننده‌های ویدیویی معمولی HTML5، ازجمله تگ HTML <video>، پشتیبانی می‌شوند. برای مشاهده فهرست پخش‌کننده‌های ویدیویی شناخته‌شده که از IMA SDK پشتیبانی می‌کنند، به برنامه شریک فناوری ویدیو مراجعه کنید.

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

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

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

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

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

  • click

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

  • fullscreen

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

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

  • ‫mute، unmute

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

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

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

هشدارهای مربوط به چارچوب‌های جاوا اسکریپت

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

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

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

پلاتفرم نسخه نوع آگهی
HTML5 رایانه: Chrome،‏ Firefox،‏ Safari،‏ Edge،‏ Opera
تلفن همراه: Chrome/مرورگر Android (Android برای تلفن‌ها و رایانه‌های لوحی)، Safari و Chrome (iOS)
ویدیو خطی، نمایش خطی، آگهی‌های غیرخطی و همپا، Ad Manager Video Solutions، ویدیو Ad Exchange، و آگهی‌های AFV
iOS ‫iOS نسخه ۱۰.۰ یا بالاتر آگهی‌های خطی و همپا، ویدیو Ad Manager، ویدیو Ad Exchange، و آگهی‌های AFV
Android Android نسخه ۴.۴ و بالاتر آگهی‌های خطی و همپا، ویدیو Ad Manager، ویدیو Ad Exchange، و آگهی‌های AFV
tvOS tvOS 15+‎ آگهی‌های خطی، ویدیو Ad Manager، و ویدیو Ad Exchange

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

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

HTML5 v3 iOS نسخه ۳ Android نسخه ۳ tvOS
مجموعه ویدیو IAB
VAST 4 هشدار ۹ هشدار ۹ هشدار ۹ هشدار ۹
VAST 3 علامت بررسی هشدار ۱ هشدار ۱ هشدار ۱
VAST 2 علامت بررسی علامت بررسی علامت بررسی علامت بررسی
SIMID 1.0 علامت بررسی علامت بررسی علامت بررسی علامت ضربدر قرمز
VPAID 2 (HTML5)‎ علامت بررسی علامت ضربدر قرمز علامت ضربدر قرمز علامت ضربدر قرمز
VMAP 1.0.1 هشدار ۲ ۳ هشدار ۲ هشدار ۲ هشدار ۲
OM SDK 1.3 علامت بررسی علامت بررسی علامت بررسی علامت ضربدر قرمز
ویژگی‌های Ad Manager Video
آگهی‌های خطی علامت بررسی علامت بررسی علامت بررسی علامت بررسی
آگهی‌های تصویری خطی علامت بررسی علامت ضربدر قرمز علامت ضربدر قرمز علامت ضربدر قرمز
دارایی‌های میزبانی‌شده در YouTube هشدار ۴ علامت ضربدر قرمز علامت ضربدر قرمز علامت ضربدر قرمز
آگهی‌های غیرخطی (هم‌پوشانی‌ها) هشدار ۵ علامت ضربدر قرمز علامت ضربدر قرمز علامت ضربدر قرمز
همراهان علامت بررسی علامت بررسی علامت بررسی علامت ضربدر قرمز
منابع آگهی همپای جایگزین VAST 3 علامت بررسی علامت بررسی علامت ضربدر قرمز علامت ضربدر قرمز
قابل‌مشاهده بودن Active View علامت بررسی علامت بررسی علامت بررسی علامت ضربدر قرمز
آگهی‌های صوتی علامت بررسی علامت بررسی علامت بررسی علامت بررسی
بازهدایت‌های VAST علامت بررسی علامت بررسی علامت بررسی علامت بررسی
تکمیل دوباره همپا با درخواست نمایش علامت بررسی علامت بررسی علامت بررسی علامت ضربدر قرمز
سازگاری با «برچسب ناشر Google» (GPT) علامت بررسی علامت ضربدر قرمز علامت ضربدر قرمز علامت ضربدر قرمز
آگاهی از محتوا علامت بررسی علامت بررسی علامت بررسی علامت بررسی
قوانین آگهی هشدار ۳ علامت بررسی علامت بررسی علامت بررسی
وقفه‌های آگهی دستی در قوانین آگهی علامت بررسی علامت ضربدر قرمز علامت ضربدر قرمز علامت ضربدر قرمز
حد بسامد ۶ علامت بررسی علامت بررسی علامت بررسی علامت بررسی
استثنائات رقابتی (جاری‌سازی) علامت بررسی علامت بررسی علامت بررسی علامت بررسی
استثنائات رقابتی (غلاف) علامت بررسی علامت بررسی علامت بررسی علامت بررسی
کنارگذاری‌های رقابتی (کل صفحه) علامت بررسی علامت ضربدر قرمز علامت ضربدر قرمز علامت ضربدر قرمز
پادکست‌سازی هشدار ۳ علامت بررسی علامت بررسی علامت بررسی
ضربه‌گیرها علامت بررسی علامت بررسی علامت بررسی علامت بررسی
گزارش‌دهی درباره ردیابی چندرویدادی (MET) علامت بررسی علامت بررسی علامت بررسی علامت بررسی
تخصیص پویا (AdSense برای ویدیو، Ad Manager Ad Exchange) علامت بررسی علامت بررسی علامت بررسی علامت بررسی
ردشدنی (غیر TrueView) ۸ هشدار ۵ علامت بررسی علامت بررسی علامت بررسی
InStream Select علامت بررسی علامت ضربدر قرمز علامت ضربدر قرمز علامت ضربدر قرمز
پیش‌بارگیری دارایی هشدار ۷ علامت ضربدر قرمز علامت بررسی علامت ضربدر قرمز
ویژگی‌های AdSense برای ویدیو
TrueView InStream هشدار ۵ علامت بررسی علامت بررسی علامت ضربدر قرمز
InStream Select علامت بررسی علامت بررسی علامت بررسی علامت ضربدر قرمز
در جاری‌سازی استاندارد علامت بررسی علامت بررسی علامت بررسی علامت بررسی
جایگاه کامل علامت بررسی علامت ضربدر قرمز علامت ضربدر قرمز علامت ضربدر قرمز
همراهان علامت بررسی علامت بررسی علامت بررسی علامت ضربدر قرمز
رفع نواقص همراه علامت ضربدر قرمز علامت بررسی علامت بررسی علامت ضربدر قرمز
همپوشانی ها هشدار ۵ علامت ضربدر قرمز علامت ضربدر قرمز علامت ضربدر قرمز
پیش‌بارگیری دارایی هشدار ۷ علامت ضربدر قرمز علامت بررسی علامت ضربدر قرمز
ویژگی‌های Ad Manager Ad Exchange
TrueView InStream هشدار ۵ علامت بررسی علامت بررسی علامت ضربدر قرمز
InStream Select علامت بررسی علامت بررسی علامت بررسی علامت ضربدر قرمز
در جاری‌سازی استاندارد علامت بررسی علامت بررسی علامت بررسی علامت بررسی
جایگاه کامل علامت بررسی علامت ضربدر قرمز علامت ضربدر قرمز علامت ضربدر قرمز
همراهان علامت بررسی علامت بررسی علامت بررسی علامت ضربدر قرمز
رفع نواقص همراه علامت ضربدر قرمز علامت بررسی علامت بررسی علامت ضربدر قرمز
همپوشانی ها هشدار ۵ علامت ضربدر قرمز علامت ضربدر قرمز علامت ضربدر قرمز
قابل‌مشاهده بودن Active View علامت بررسی علامت بررسی علامت بررسی علامت ضربدر قرمز
پیش‌بارگیری دارایی هشدار ۷ علامت ضربدر قرمز علامت بررسی علامت ضربدر قرمز
چرا این آگهی؟ علامت بررسی علامت بررسی علامت بررسی علامت بررسی

۱ ویژگی‌های VAST 3.0 زیر هنوز در کیت‌های توسعه نرم‌افزار غیرHTML5 پشتیبانی نمی‌شوند:

  • همراه adSlotId
  • گزینه‌های ارسال همراه
  • نمادها

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

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

۳ پشتیبانی از VMAP و قوانین آگهی در iPhone به بازپخش آگهی سفارشی نیاز دارد.

۴ طرح‌آگهی‌های میزبانی‌شده در YouTube در رایانه پشتیبانی می‌شوند اما در وب تلفن همراه پشتیبانی نمی‌شوند.

‫۵ آگهی‌های غیرخطی (برافزایی)، ردشدنی (غیر TrueView)، و آگهی‌های TrueView InStream در وب تلفن همراه HTML5 در iOS 10+‎ زمانی پشتیبانی می‌شوند که playsinline استفاده شود .

‫۶ حدگذاری بسامد قوانین آگهی و کنار گذاشتن‌های رقابتی به کوکی یا PPID نیاز دارند.

۷ پیش‌بارگذاری دارایی بومی با موارد زیر کار نمی‌کند:

  • وب تلفن همراه در دستگاه‌های iOS
  • وب تلفن همراه در Android نسخه قدیمی‌تر از ۴.۰
  • آگهی‌های میزبانی‌شده در YouTube، ازجمله قالب‌های TrueView
  • ویژگی بازپخش وقفه دستی IMA (هر پیاده‌سازی‌ای که به رویداد AD_BREAK_READY متکی باشد)

۸ کیت توسعه نرم‌افزار از آگهی‌های ردشدنی که کمتر از ۸ ثانیه هستند پشتیبانی نمی‌کند. وقتی آگهی‌های کوتاه‌تر از حداقل طول پخش می‌شوند، دکمه رد کردن نمایش داده نمی‌شود.

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