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

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

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

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

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

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

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

سازگاری با رویدادهای گسترده

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

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

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

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

  • click

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

  • fullscreen

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

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

  • mute ، unmute

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

    • پشتیبانی‌شده: فایرفاکس ۳.۵+، کروم ۸+، سافاری ۴+
    • پشتیبانی نمی‌شود: iOS، اندروید

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

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

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

پشتیبانی از اپل ایرپلی

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

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

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

پلتفرم نسخه نوع تبلیغ
HTML5 دسکتاپ : کروم، فایرفاکس، سافاری، اج، اپرا
موبایل : مرورگر کروم/اندروید (اندروید برای تلفن‌ها و تبلت‌ها)، سافاری و کروم (iOS)		 تبلیغات خطی، غیرخطی و همراه، راهکارهای ویدیویی مدیریت تبلیغات، ویدیوی تبادل تبلیغات و تبلیغات AFV
آی‌او‌اس آی‌او‌اس ۱۰.۰+ تبلیغات خطی و همراه، ویدیوی مدیریت تبلیغات، ویدیوی تبادل تبلیغات و تبلیغات AFV
اندروید اندروید ۴.۴+ تبلیغات خطی و همراه، ویدیوی مدیریت تبلیغات، ویدیوی تبادل تبلیغات و تبلیغات AFV
تی‌وی‌او‌اس تی‌وی‌او‌اس ۱۵+ تبلیغات خطی، ویدیوی مدیریت تبلیغات و ویدیوی تبادل تبلیغات

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

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

HTML5 نسخه ۳ آی‌او‌اس نسخه ۳ اندروید نسخه ۳ تی‌وی‌او‌اس
مجموعه ویدیویی IAB
گسترده ۴ Warning ۹ Warning ۹ Warning ۹ Warning ۹
گسترده ۳ CheckmarkWarning ۱ Warning ۱ Warning ۱
گسترده ۲ CheckmarkCheckmarkCheckmarkCheckmark
سیمید ۱.۰ CheckmarkCheckmarkCheckmarkRed-X
وی‌پی‌آی‌دی ۲ (HTML5) CheckmarkRed-XRed-XRed-X
وی‌ام‌ای‌پی ۱.۰.۱ Warning ۲ ۳ Warning ۲ Warning ۲ Warning ۲
کیت توسعه نرم‌افزار OM نسخه ۱.۳ CheckmarkCheckmarkCheckmarkRed-X
ویژگی‌های ویدیوی مدیر تبلیغات
تبلیغات خطی CheckmarkCheckmarkCheckmarkCheckmark
دارایی‌های میزبانی‌شده توسط یوتیوب Warning ۴ Red-XRed-XRed-X
تبلیغات غیرخطی (پوشش‌ها) Warning ۵ Red-XRed-XRed-X
همراهان CheckmarkCheckmarkCheckmarkRed-X
منابع تبلیغاتی جایگزین VAST 3 CheckmarkCheckmarkRed-XRed-X
قابلیت مشاهده نمای فعال CheckmarkCheckmarkCheckmarkRed-X
تبلیغات صوتی CheckmarkCheckmarkCheckmarkCheckmark
تغییر مسیرهای گسترده CheckmarkCheckmarkCheckmarkCheckmark
درخواست نمایش با خاکریزی همراه CheckmarkCheckmarkCheckmarkRed-X
سازگاری با برچسب ناشر گوگل (GPT) CheckmarkRed-XRed-XRed-X
آگاهی از محتوا CheckmarkCheckmarkCheckmarkCheckmark
قوانین تبلیغات Warning ۳ CheckmarkCheckmarkCheckmark
قوانین مربوط به تبلیغات، شامل موارد زیر است: Checkmark Red-XRed-XRed-X
فرکانس‌های محدود ۶ CheckmarkCheckmarkCheckmarkCheckmark
محرومیت‌های رقابتی (جریان) CheckmarkCheckmarkCheckmarkCheckmark
محرومیت‌های رقابتی (پاد) CheckmarkCheckmarkCheckmarkCheckmark
محرومیت‌های رقابتی (تمام صفحه) CheckmarkRed-XRed-XRed-X
پودینگ Warning ۳ CheckmarkCheckmarkCheckmark
ضربه گیرها CheckmarkCheckmarkCheckmarkCheckmark
گزارش‌گیری در مورد ردیابی چند رویدادی (MET) CheckmarkCheckmarkCheckmarkCheckmark
تخصیص پویا (AdSense برای ویدیو، Ad Manager Ad Exchange) CheckmarkCheckmarkCheckmarkCheckmark
قابل رد شدن (غیر TrueView) 8 Warning ۵ CheckmarkCheckmarkCheckmark
انتخاب درون جریانی CheckmarkRed-XRed-XRed-X
پیش بارگذاری دارایی Warning ۷ Red-XCheckmarkRed-X
ویژگی‌های AdSense برای ویدیو
TrueView InStream Warning ۵ CheckmarkCheckmarkRed-X
انتخاب درون جریانی CheckmarkCheckmarkCheckmarkRed-X
استاندارد درون جریانی CheckmarkCheckmarkCheckmarkCheckmark
اسلات کامل CheckmarkRed-XRed-XRed-X
همراهان CheckmarkCheckmarkCheckmarkRed-X
خاکریز همراه Red-XCheckmarkCheckmarkRed-X
روکش‌ها Warning ۵ Red-XRed-XRed-X
پیش بارگذاری دارایی Warning ۷ Red-XCheckmarkRed-X
ویژگی‌های مدیر تبلیغات در بخش تبادل تبلیغات
TrueView InStream Warning ۵ CheckmarkCheckmarkRed-X
انتخاب درون جریانی CheckmarkCheckmarkCheckmarkRed-X
استاندارد درون جریانی CheckmarkCheckmarkCheckmarkCheckmark
اسلات کامل CheckmarkRed-XRed-XRed-X
همراهان CheckmarkCheckmarkCheckmarkRed-X
خاکریز همراه Red-XCheckmarkCheckmarkRed-X
روکش‌ها Warning ۵ Red-XRed-XRed-X
قابلیت مشاهده نمای فعال CheckmarkCheckmarkCheckmarkRed-X
پیش بارگذاری دارایی Warning ۷ Red-XCheckmarkRed-X
چرا این تبلیغ؟ CheckmarkCheckmarkCheckmarkCheckmark

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

  • adSlotId همراه
  • گزینه‌های تحویل همراه
  • آیکن‌ها

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

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

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

۴ اثر خلاقانه میزبانی‌شده در یوتیوب روی دسکتاپ پشتیبانی می‌شوند اما روی وب موبایل پشتیبانی نمی‌شوند.

۵ نوع تبلیغات غیرخطی (Overlays)، تبلیغات قابل رد شدن (non-TrueView) و تبلیغات TrueView InStream در وب موبایل HTML5 در iOS 10+ در صورت استفاده از playsinline پشتیبانی می‌شوند.

6 قانون محدودیت تکرار تبلیغات و حذف رقابتی به کوکی‌ها یا PPID نیاز دارند.

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

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

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

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

  • گسترده ۴.۲
  • گسترده ۴.۰
    • شناسه تبلیغاتی
    • فایل نیم طبقه
    • کدهای خطای جدید VAST
    • پشتیبانی AdVerifications