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

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

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

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

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

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

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

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

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

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

  • click

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

  • fullscreen

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

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

  • mute ، unmute

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

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

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

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

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

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

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

  • AD_PERIOD_STARTED
  • AD_PERIOD_ENDED

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

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

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

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

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

پلتفرم IMA SDK اچ ال اس دش
HTML5 CheckmarkCheckmark
آی‌او‌اس CheckmarkRed-X
اندروید CheckmarkCheckmark
گوگل کست CheckmarkCheckmark
تی‌وی‌او‌اس CheckmarkRed-X
روکو CheckmarkCheckmark

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

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

مجموعه ویدیویی IAB پشتیبانی
گسترده ۴ Warning ۱
گسترده ۳ Warning ۲
گسترده ۲ Checkmark
وی پی آی دی ۲ Red-X
وی‌ام‌ای‌پی ۱.۰.۱ Warning ۳
ویژگی‌های ویدیوی مدیر تبلیغات پشتیبانی
تبلیغات خطی Checkmark
تبلیغات غیرخطی (پوشش‌ها) Red-X
همراهان Warning ۴
منابع تبلیغاتی جایگزین VAST 3 Red-X
قابلیت مشاهده نمای فعال Checkmark
تغییر مسیرهای گسترده Checkmark
درخواست نمایش با خاکریزی همراه Red-X
سازگاری با برچسب ناشر گوگل (GPT) Red-X
آگاهی از محتوا Red-X
قوانین تبلیغات Checkmark
پودینگ Checkmark
ضربه گیرها Checkmark
گزارش‌گیری در مورد ردیابی چند رویدادی (MET) Checkmark
قابل رد شدن (رزرو / غیر TrueView) Warning ۵
ویژگی‌های ادسنس برای ویدیو ۷ پشتیبانی
TrueView InStream Warning ۶
انتخاب درون جریانی Checkmark
استاندارد درون جریانی Checkmark
اسلات کامل Red-X
همراهان Warning ۴
خاکریز همراه Red-X
روکش‌ها Red-X
ویژگی‌های مدیر تبلیغات در بخش تبادل تبلیغات پشتیبانی
TrueView InStream Warning ۶
انتخاب درون جریانی Checkmark
استاندارد درون جریانی Checkmark
اسلات کامل Red-X
همراهان Warning ۴
خاکریز همراه Red-X
روکش‌ها Red-X
قابلیت مشاهده نمای فعال Checkmark
چرا این تبلیغ؟ Warning ۸

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

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

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

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

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

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

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

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

6 تبلیغ قابل رد شدن TrueView در SDK های IMA DAI برای HTML5، iOS، tvOS، Roku و اندروید (از جمله Android TV) پشتیبانی می‌شوند.

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

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

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

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

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

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