سازگاری

این صفحه اطلاعات کلی در مورد پشتیبانی و سازگاری 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 CheckmarkCheckmark
iOS CheckmarkRed-X
اندروید CheckmarkCheckmark
Google Cast CheckmarkCheckmark
tvOS CheckmarkRed-X
روکو CheckmarkCheckmark

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

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

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

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

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

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

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

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

4 فقط همراهان تصویر پشتیبانی می شوند. همراهان تصویر به پیاده سازی سفارشی برای پر کردن تبلیغات نیاز دارند. تبلیغات همراه در tvOS پشتیبانی نمی شود.

5 تبلیغات سنتی قابل پرش فقط در کیت‌های توسعه نرم‌افزار IMA DAI برای HTML5، iOS، tvOS، Roku و Android (از جمله Android TV) پشتیبانی می‌شوند. با Cast SDK، باید قابلیت پرش را با StreamRequest.senderCanSkip اعلام کنید تا از تبلیغات سنتی قابل پرش پشتیبانی کند.

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

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

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

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

هنگام استفاده از چارچوب جاوا اسکریپت، مانند 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 را غیرفعال کنید یا درخواست های تبلیغات را غیرفعال کنید.

،

این صفحه اطلاعات کلی در مورد پشتیبانی و سازگاری 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 CheckmarkCheckmark
iOS CheckmarkRed-X
اندروید CheckmarkCheckmark
Google Cast CheckmarkCheckmark
tvOS CheckmarkRed-X
روکو CheckmarkCheckmark

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

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

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

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

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

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

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

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

4 فقط همراهان تصویر پشتیبانی می شوند. همراهان تصویر به پیاده سازی سفارشی برای پر کردن تبلیغات نیاز دارند. تبلیغات همراه در tvOS پشتیبانی نمی شود.

5 تبلیغات سنتی قابل پرش فقط در کیت‌های توسعه نرم‌افزار IMA DAI برای HTML5، iOS، tvOS، Roku و Android (از جمله Android TV) پشتیبانی می‌شوند. با Cast SDK، باید قابلیت پرش را با StreamRequest.senderCanSkip اعلام کنید تا از تبلیغات سنتی قابل پرش پشتیبانی کند.

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

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

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

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

هنگام استفاده از چارچوب جاوا اسکریپت، مانند 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 را غیرفعال کنید یا درخواست های تبلیغات را غیرفعال کنید.

،

این صفحه اطلاعات کلی در مورد پشتیبانی و سازگاری 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 CheckmarkCheckmark
iOS CheckmarkRed-X
اندروید CheckmarkCheckmark
Google Cast CheckmarkCheckmark
tvOS CheckmarkRed-X
روکو CheckmarkCheckmark

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

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

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

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

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

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

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

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

4 فقط همراهان تصویر پشتیبانی می شوند. همراهان تصویر به پیاده سازی سفارشی برای پر کردن تبلیغات نیاز دارند. تبلیغات همراه در tvOS پشتیبانی نمی شود.

5 تبلیغات سنتی قابل پرش فقط در کیت‌های توسعه نرم‌افزار IMA DAI برای HTML5، iOS، tvOS، Roku و Android (از جمله Android TV) پشتیبانی می‌شوند. با Cast SDK، باید قابلیت پرش را با StreamRequest.senderCanSkip اعلام کنید تا از تبلیغات سنتی قابل پرش پشتیبانی کند.

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

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

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

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

هنگام استفاده از چارچوب جاوا اسکریپت، مانند 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 را غیرفعال کنید یا درخواست های تبلیغات را غیرفعال کنید.

،

این صفحه اطلاعات کلی در مورد پشتیبانی و سازگاری 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 CheckmarkCheckmark
iOS CheckmarkRed-X
اندروید CheckmarkCheckmark
Google Cast CheckmarkCheckmark
tvOS CheckmarkRed-X
روکو CheckmarkCheckmark

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

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

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

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

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

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

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

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

4 فقط همراهان تصویر پشتیبانی می شوند. همراهان تصویر به پیاده سازی سفارشی برای پر کردن تبلیغات نیاز دارند. تبلیغات همراه در tvOS پشتیبانی نمی شود.

5 تبلیغات سنتی قابل پرش فقط در کیت‌های توسعه نرم‌افزار IMA DAI برای HTML5، iOS، tvOS، Roku و Android (از جمله Android TV) پشتیبانی می‌شوند. با Cast SDK، باید قابلیت پرش را با StreamRequest.senderCanSkip اعلام کنید تا از تبلیغات سنتی قابل پرش پشتیبانی کند.

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

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

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

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

هنگام استفاده از چارچوب جاوا اسکریپت، مانند 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 را غیرفعال کنید یا درخواست های تبلیغات را غیرفعال کنید.