پشتیبانی و سازگاری

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

فرمت های ویدئویی و مرورگرهای پشتیبانی شده

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

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

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

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

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

به طور کامل پشتیبانی می شود

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

تا حدی پشتیبانی می شود

• click

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

• fullscreen
  

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

  در پلتفرم های آیفون و اندروید قبل از نسخه 3.0، ویدیو همیشه در حالت تمام صفحه پخش می شود.

• mute ، unmute

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

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

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

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

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

پشتیبانی از Apple AirPlay

IMA SDK در حال حاضر از Apple AirPlay پشتیبانی نمی کند. وقتی AirPlay شناسایی شد، AirPlay را غیرفعال کنید یا درخواست های تبلیغات را غیرفعال کنید.

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

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

سکو	نسخه	نوع تبلیغ
HTML5	دسکتاپ : کروم، فایرفاکس، سافاری، اج، اپرا موبایل : مرورگر کروم/اندروید (اندروید برای گوشی و تبلت)، سافاری و کروم (iOS)	تبلیغات خطی، غیرخطی و همراه، راه حل های ویدیویی Ad Manager، ویدیوی Ad Exchange و تبلیغات AFV
iOS	iOS 10.0+	تبلیغات خطی و همراه، ویدیوی Ad Manager، ویدیوی Ad Exchange و تبلیغات AFV
اندروید	اندروید 4.4+	تبلیغات خطی و همراه، ویدیوی Ad Manager، ویدیوی Ad Exchange و تبلیغات AFV
tvOS	tvOS 14+	تبلیغات خطی، ویدیوی Ad Manager و ویدیوی Ad Exchange

توجه: IMA Cast v2 SDK منسوخ شده است. برای اطلاعات در مورد ارائه تبلیغات سمت مشتری در دستگاه‌های Google Cast، به CAF Native Ad Breaks مراجعه کنید.

ویژگی های ویدیویی و نسخه های SDK

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

	HTML5 v3	iOS نسخه 3	اندروید نسخه 3	tvOS
مجموعه ویدیویی IAB
VAST 4	9	9	9	9
VAST 3		1	1	1
VAST 2
SIMID 1.0
VPAID 2 (HTML5)
VMAP 1.0.1	2 3	2	2	2
OM SDK 1.3
ویژگی های Ad Manager Video
تبلیغات خطی
دارایی های میزبانی شده توسط YouTube	4
تبلیغات غیر خطی (همپوشانی)	5
همراهان
منابع تبلیغات همراه جایگزین VAST 3
قابلیت مشاهده فعال نمای
تبلیغات صوتی
تغییر مسیرهای VAST
تکمیل پشتیبان همراه با درخواست نمایش
سازگاری با برچسب ناشر Google (GPT).
آگاهی از محتوا
قوانین آگهی	3
وقفه های تبلیغاتی دستی در قوانین تبلیغات
محدودیت های فرکانس 6
محرومیت های رقابتی (جریان)
محرومیت های رقابتی (pod)
استثناهای رقابتی (کل صفحه)
پودینگ	3
ضربه گیر
گزارش در مورد ردیابی چند رویدادی (MET)
تخصیص پویا (AdSense برای ویدیو، Ad Manager Ad Exchange)
قابل پرش (غیر TrueView) 8	5
InStream را انتخاب کنید
پیش بارگیری دارایی	7
ویژگی های AdSense for Video
TrueView InStream	5
InStream را انتخاب کنید
سازنده استاندارد
دارای شیب کامل
همراهان
همراهی همراه
پوشش ها	5
پیش بارگذاری دارایی	7
ویژگی های Ad Manager Ad Exchange
TrueView InStream	5
InStream را انتخاب کنید
استاندارد InStream
فول اسلات
همراهان
پر کردن همراه
پوشش ها	5
قابلیت مشاهده فعال نمای
پیش بارگیری دارایی	7
چرا این تبلیغ؟

¹ ویژگی‌های VAST 3.0 زیر هنوز در SDK‌های غیرHTML5 پشتیبانی نمی‌شوند:

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

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

• رویدادهای ردیابی ویژه VMAP
• کدهای خطای خاص VMAP
• تبلیغات همپوشانی
• فاصله زمانی غیر از hh:mm:ss یا "شروع" و "پایان"
• نمایش ویژگی breakType
• ویژگی repeatAfter

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

⁴ خلاقیت میزبان یوتیوب در دسکتاپ پشتیبانی می شوند اما در وب تلفن همراه پشتیبانی نمی شوند.

⁵ تبلیغات غیرخطی (همپوشانی)، Skippable (غیر TrueView) و TrueView InStream در وب تلفن همراه HTML5 در iOS 10+ پشتیبانی می‌شوند که playsinline استفاده می‌شود .

⁶ محدودیت‌های فرکانس قوانین آگهی و استثناهای رقابتی به کوکی‌ها یا PPID نیاز دارند.

⁷ پیش بارگذاری دارایی اصلی با موارد زیر کار نمی کند:

• وب موبایل در دستگاه های iOS
• وب موبایل در اندروید قبل از 4.0
• تبلیغات میزبانی شده توسط YouTube، از جمله فرمت های TrueView
• ویژگی پخش شکست دستی IMA (هر پیاده سازی متکی به رویداد AD_BREAK_READY )

⁸ SDK از تبلیغات قابل رد شدن که کمتر از 8 ثانیه هستند پشتیبانی نمی کند. وقتی تبلیغات کوتاه‌تر از حداقل طول پخش می‌شود، دکمه پرش نمایش داده نمی‌شود.

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

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

SDK های منسوخ شده

	فلش نسخه 2	HTML5 v1	iOS نسخه 1	اندروید نسخه 1	Google Cast نسخه 2
ویژگی های Ad Manager Video
تبلیغات خطی
تبلیغات غیر خطی
تبلیغات تعاملی (VPAID 1.0).
تغییر مسیرها (VAST 2.0)
پر کردن همراه (AdSense برای ویدیو، Ad Manager Ad Exchange)
تبلیغات صوتی
سازگاری با برچسب ناشر Google (GPT).
سقف های فرکانس
محرومیت های رقابتی (جریان)
محرومیت های رقابتی (pod)
استثناهای رقابتی (کل صفحه)
آگاهی از محتوا
قوانین تبلیغات و وقفه های تبلیغاتی دستی در قوانین تبلیغات
پودینگ
ضربه گیر
ردیابی چند رویدادی (MET) برای گزارش
تخصیص پویا
قابل پرش
InStream را انتخاب کنید
ویژگی های AdSense for Video
تبلیغات متنی
AdSense VAST InStream
پوشش AdSense
قابل پرش
InStream را انتخاب کنید
انتخاب کاربر (YouTube)
تبلیغات F2F در Ad Manager
ویژگی های Ad Manager Ad Exchange
تبلیغات خطی