کتابخانه
videojs-ima یه پلاگین جاوااسکریپتی از گوگله که IMA SDK رو به پلیر Video.js وصل می کنه. با اون می تونی تبلیغ ویدیویی رو قبل، وسط یا بعد از ویدیوی اصلی روی پلیر سایتت نشون بدی، بدون اینکه هماهنگی بین پلیر و SDK تبلیغاتی رو خودت از صفر بنویسی.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز Apache-2.0؛ هش هر فایل با منبع بررسی شده است.
۴۰۲ کیلوبایت· ۱۵ فایل· انتشار
SHA-256: e3e37b2dc56e8ba4bbe8b7cf408ef883e690201f9589cdfdab29d496b874deea
videojs-ima یه پلاگین برای Video.js هست که خود گوگل نوشته و متن باز منتشر کرده. مشکلی که حل می کنه کوچیک نیست. IMA SDK برای نمایش تبلیغ ویدیویی API جداگانه ای داره و باید با رویدادهای پلیر هماهنگ بشه. موقع پخش تبلیغ، ویدیوی اصلی باید بایسته و بعد از تبلیغ دوباره ادامه پیدا کنه. اگه هم تبلیغ لود نشد، کاربر نباید با یه پلیر خراب رو به رو بشه. این پلاگین همین چسب بین دو طرف رو برات می ذاره.
اگه سایت ویدیویی، رسانه ای یا آموزشی داری و می خوای با تگ تبلیغ استاندارد (مثل VAST) درآمد بسازی، videojs-ima انتخاب منطقیه. ولی اگه فقط می خوای یه ویدیو پخش کنی و تبلیغی در کار نیست، خود Video.js کافیه و لازم نیست چیز اضافه ای به صفحه بیاری.
یه نکته رو برای سایت های ایرانی جدی بگیر. خود پلاگین رو می شه کنار فایل های سایتت نگه داشت، ولی کل کار به IMA SDK و سرورهای تبلیغاتی وابسته ست و SDK معمولاً از سرورهای گوگل لود می شه. پس اگه دسترسی به این سرورها از شبکه داخلی محدود باشه، یا حساب تبلیغاتی نداشته باشی، تبلیغی نشون داده نمی شه. شاید بتونی تگ تبلیغ رو از سرویس دیگه ای بگیری که VAST رو پشتیبانی می کنه، اما قبل از انتشار روی سایت واقعی حتماً تستش کن.
موقع انتخاب و استفاده چند چیز رو چک کن. نسخه پلاگین باید با نسخه Video.js پروژه ات سازگار باشه. مرورگرها پخش خودکار ویدیو با صدا رو محدود می کنن، پس معمولاً باید بعد از یه کلیک یا تعامل کاربر، کانتینر تبلیغ رو آماده کنی. افزونه های بلاک تبلیغ هم ممکنه درخواست تبلیغ رو ببندن. برای همین بهتره پلیرت وقتی تبلیغ شکست خورد، ویدیوی اصلی رو بدون مشکل پخش کنه.
نسخه های رسمی و بدون تغییر videojs-ima توی مخزن داخلی ما هم هست. اگه روزی دسترسی به npm یا منابع خارجی سخت شد، فایل ها رو از همین جا بردار و روی هاست خودت بذار.
برای شروع، پلیر Video.js باید از قبل توی صفحه کار کنه. بعدش مراحل کلی این طوریه:
کد آماده برای شروع پایین همین صفحه هست. اول با یه تگ آزمایشی تست کن که تبلیغ نشون داده می شه و ویدیوی اصلی بعدش ادامه پیدا می کنه. بعد تگ واقعی رو بذار. یه بار هم روی شبکه داخلی تست کن، چون ممکنه نتیجه با اینترنت آزاد فرق کنه.
این پلاگین IMA SDK گوگل رو به پلیر Video.js وصل می کنه. تو آدرس تگ تبلیغ رو می دی، تبلیغ ویدیویی روی پلیر پخش می شه و بعد از تموم شدنش ویدیوی اصلی ادامه پیدا می کنه. هماهنگی بین پلیر و SDK رو هم خود پلاگین مدیریت می کنه.
نه، videojs-ima پلاگین Video.js ـه و بدون اون کار نمی کنه. اول باید Video.js رو توی صفحه داشته باشی و پلیرت راه افتاده باشه، بعد پلاگین رو روش فعال کنی. اگه از پلیر دیگه ای، مثل پلیر پیش فرض مرورگر، استفاده می کنی، این پلاگین به دردت نمی خوره.
چند دلیل رایج داره: آدرس تگ تبلیغ درست نیست، اسکریپت IMA SDK لود نشده یا از شبکه ات در دسترس نیست، افزونه بلاک تبلیغ فعاله، یا کانتینر تبلیغ قبل از تعامل کاربر آماده نشده. کنسول مرورگر رو باز کن و خطاها رو بخون. معمولاً سرنخ همون جاست.
معمولاً شرایط گوگل می خواد SDK از آدرس رسمی خودش لود بشه و استفاده از نسخه کپی شده مجاز نیست. پس قبل از این کار شرایط استفاده رو بخون. خود پلاگین videojs-ima رو راحت می تونی روی هاست خودت نگه داری، ولی SDK موضوع جداییه.
اگه تگ تبلیغ نداشته باشی، پلاگین کاری برای انجام دادن نداره. بعضی سرویس های تبلیغاتی تگ VAST می دن که IMA می تونه پخشش کنه، ولی بازم به SDK گوگل نیاز داری. پس اول مطمئن شو دسترسی و تگ تبلیغ درست کار می کنه، بعد پلاگین رو اضافه کن.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.