سازگاری

این صفحه اطلاعات کلی در مورد پشتیبانی و سازگاری 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 آن حداقل به اندازه بدنه سند باشد. این حالت در همه مرورگرها پشتیبانی می شود.

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

• mute ، unmute

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

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

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

رویدادهای تبلیغاتی هنگام تماشای مجدد وقفه های تبلیغاتی

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

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

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

• AD_PERIOD_STARTED
• AD_PERIOD_ENDED

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

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

سکو	نسخه
HTML5	دسکتاپ : کروم، فایرفاکس، سافاری، اج، اپرا موبایل : مرورگر کروم/اندروید (اندروید برای گوشی و تبلت)، سافاری و کروم (iOS)
iOS	iOS 10.0+
اندروید	اندروید 4.4+
Google Cast	همه دستگاه‌های Cast
tvOS	tvOS 14+
روکو	همه دستگاه‌هایی که هنوز به‌روزرسانی‌های نرم‌افزاری را از Roku دریافت می‌کنند

پشتیبانی از فرمت جریان ویدئو

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

پلت فرم IMA SDK	HLS	خط تیره
HTML5
iOS
اندروید
Google Cast
tvOS
روکو

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

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

مجموعه ویدیویی IAB	حمایت کردن
VAST 4	1
VAST 3	2
VAST 2
VPAID 2
VMAP 1.0.1	3
ویژگی های Ad Manager Video	حمایت کردن
تبلیغات خطی
تبلیغات غیر خطی (همپوشانی)
همراهان	4
منابع تبلیغات همراه جایگزین VAST 3
قابلیت مشاهده فعال نمای
تغییر مسیرهای VAST
تکمیل پشتیبان همراه با درخواست نمایش
سازگاری با برچسب ناشر Google (GPT).
آگاهی از محتوا
قوانین آگهی
پودینگ
ضربه گیر
گزارش در مورد ردیابی چند رویدادی (MET)
قابل پرش (رزرو / غیر TrueView)	5
ویژگی های AdSense for Video 7	حمایت کردن
TrueView InStream	6
InStream را انتخاب کنید
استاندارد InStream
فول اسلات
همراهان	4
پر کردن همراه
پوشش ها
ویژگی های Ad Manager Ad Exchange	حمایت کردن
TrueView InStream	6
InStream را انتخاب کنید
استاندارد InStream
فول اسلات
همراهان	4
پر کردن همراه
پوشش ها
قابلیت مشاهده فعال نمای
چرا این تبلیغ؟	8

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

• VAST 4.2
  • پشتیبانی از تعریف رابط رسانه ای تعاملی امن (SIMID)
  • مجوز چندین گره UniversalAdID
• VAST 4.0
  • AdID
  • فایل میزانسن
  • کدهای خطای جدید 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 SDK، باید قابلیت پرش را با StreamRequest.senderCanSkip اعلام کنید تا از تبلیغات سنتی قابل پرش پشتیبانی کند.

⁶ تبلیغات TrueView قابل رد شدن فقط در کیت توسعه نرم افزاری IMA DAI برای HTML5، iOS و Android (از جمله Android TV) پشتیبانی می شوند.

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

⁸ چرا این تبلیغ؟ نیاز دارد که هنگام ایجاد StreamManager ، پارامتر adUiElement ارسال شود. چرا این تبلیغ؟ در Cast SDK پشتیبانی نمی شود.

مهم: استفاده از HTML5 IMA DAI SDK با تبلیغات قابل پرش یا چرا این تبلیغ؟ نیاز دارد که هنگام ایجاد StreamManager ، پارامتر adUiElement ارسال شود.

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

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

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

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