کیتهای توسعه نرمافزار IMA ادغام آگهیهای چندرسانهای در وبسایتها و برنامههایتان را آسان میکنند. کیتهای توسعه نرمافزار IMA میتوانند از هر سرور آگهی سازگار با VAST درخواست آگهی کنند و بازپخش آگهی را در برنامههایتان مدیریت کنند. با کیتهای توسعه نرمافزار IMA DAI، برنامهها درخواست جاریسازی برای ویدیو آگهی و محتوا (چه ویدیو بهدرخواست و چه محتوای زنده) ارسال میکنند. سپس کیت توسعه نرمافزار یک جریان ویدیویی ترکیبی برمیگرداند، بنابراین شما مجبور نیستید در برنامه خود بین ویدیو آگهی و محتوا جابهجایی را مدیریت کنید.
راهحل DAI موردعلاقهتان را انتخاب کنید
بازرسی پویای ARP با خدمات کامل
این راهنما نشان میدهد چگونه «کیت توسعه نرمافزار IMA DAI» را در برنامه پخشکننده ویدیو ادغام کنید. اگر میخواهید یکپارچهسازی نمونه کاملشده را مشاهده کنید یا با آن همراه شوید، نمونه ساده را از GitHub بارگیری کنید.
نمای کلی IMA DAI
پیادهسازی کیت توسعه نرمافزار IMA DAI شامل دو جزء اصلی است که در این راهنما نشان داده شده است:
StreamRequest— یاVODStreamRequestیاLiveStreamRequest: شیئی که درخواست جاریسازی را تعریف میکند. درخواستهای جاریسازی میتواند برای ویدیو بهدرخواست یا جاریسازی زنده باشد. درخواستهای جاریسازی زنده کلید دارایی را مشخص میکنند، درحالیکه درخواستهای VOD شناسه CMS و شناسه ویدیو را مشخص میکنند. هر دو نوع درخواست میتوانند بهصورت اختیاری شامل کلید API موردنیاز برای دسترسی به جاریسازیهای مشخصشده و کد شبکه Google Ad Manager برای IMA SDK باشند تا شناسههای آگهی را همانطور که در تنظیمات Google Ad Manager مشخص شده است مدیریت کند.-
StreamManager: شیئی که جریانهای درج آگهی پویا و تعاملات با زیرینه DAI را مدیریت میکند. مدیر جاریسازی همچنین پینگهای ردیابی را مدیریت میکند و رویدادهای جاریسازی و آگهی را به ناشر ارسال میکند.
پیشنیازها
- سه فایل خالی
- dai.html
- dai.css
- dai.js
- Python نصبشده در رایانه، یا سرور وب برای استفاده در آزمایش
شروع سرور توسعه
ازآنجاییکه «کیت توسعه نرمافزار IMA DAI» وابستگیها را بااستفاده از همان پروتکل صفحهای که از آن بارگیری میشود بار میکند، باید از سرور وب برای آزمایش برنامهتان استفاده کنید. یکی از روشهای سریع برای شروع سرور توسعه محلی استفاده از سرور داخلی Python است.
بااستفاده از خط فرمان، از فهرست راهنمایی که حاوی فایل
index.htmlشما است این دستور را اجرا کنید:python -m http.server 8000در مرورگر وب، به
http://localhost:8000/برویدهمچنین میتوانید از هر سرور وب دیگری، مانند Apache HTTP Server استفاده کنید.
ایجاد پخشکننده ویدیو
ابتدا، dai.html را تغییر دهید تا عنصر ویدیو HTML5 و یک div برای استفاده در کلیکگذر ایجاد کنید. مثال زیر IMA DAI SDK را وارد میکند. برای جزئیات بیشتر، وارد کردن کیت توسعه نرمافزار IMA DAI را ببینید.
همچنین، برچسبهای لازم را برای بار کردن فایلهای dai.css
و dai.js و همچنین برای وارد کردن پخشکننده ویدیو hls.js اضافه کنید. سپس،
dai.css را اصلاح کنید تا اندازه و موقعیت عناصر صفحه را مشخص کنید.
درنهایت، در dai.js، متغیرهایی را برای نگهداری اطلاعات درخواست جاریسازی تعریف کنید،
تابعی را برای اجرا شدن هنگام بار شدن صفحه initPlayer() تعریف کنید، و دکمه پخش را برای درخواست جاریسازی هنگام کلیک راهاندازی کنید.
برای ازسر گرفتن بازپخش درطول وقفههای آگهی موقتاً متوقفشده، شنوندگان رویداد را برای رویدادهای pause و start عنصر ویدیو راهاندازی کنید تا کنترلهای پخشکننده را نشان دهند و پنهان کنند.
بار کردن کیت توسعه نرمافزار IMA DAI
سپس، چارچوب IMA را بااستفاده از برچسب نوشتاری در dai.html، قبلاز برچسب برای dai.js اضافه کنید.
مقداردهی اولیه StreamManager
برای درخواست مجموعه آگهی، ima.dai.api.StreamManager ایجاد کنید که
مسئول درخواست و مدیریت جاریسازیهای DAI است. سازنده یک عنصر ویدیو و یک عنصر میانای کاربر آگهی را برای مدیریت کلیکهای آگهی میگیرد.
درخواست جاریسازی کنید
توابعی را برای درخواست جاریسازیها تعریف کنید. این مثال شامل توابعی برای
ویدیو بهدرخواست و جاریسازی زنده است که نمونههایی از کلاس VODStreamRequest
و کلاس LiveStreamRequest ایجاد میکند. پساز اینکه نمونه streamRequest را داشتید،
متد streamManager.requestStream() را با نمونه درخواست جاریسازی فراخوانی کنید.
هر دو روش درخواست جاریسازی یک کلید اختیاری API را میپذیرند. اگر از یک
جاریسازی محافظتشده استفاده میکنید، باید یک کلید اصالتسنجی DAI ایجاد کنید. برای جزئیات بیشتر،
درخواستهای جاریسازی ویدیو DAI را اصالتسنجی کنید را ببینید.
هیچکدام از جاریسازیها در این مثال بااستفاده از کلید اصالتسنجی DAI محافظت نمیشوند، بنابراین
از apiKey استفاده نمیشود.
فرادادههای جاریسازی را تجزیه کنید
همچنین باید یک کنترلکننده اضافه کنید تا به رویدادهای فراداده زماندار گوش دهد و رویدادها را به کلاس StreamManager ارسال کند تا IMA بتواند رویدادهای آگهی را درطول وقفههای آگهی منتشر کند:
این راهنما از پخشکننده hls.js برای بازپخش جاریسازی استفاده میکند، اما پیادهسازی فراداده شما به نوع پخشکنندهای که استفاده میکنید بستگی دارد.
مدیریت رویدادهای جاریسازی
شنوندگان رویداد را برای رویدادهای ویدیویی اصلی پیادهسازی کنید. این مثال رویدادهای
LOADED، ERROR، AD_BREAK_STARTED، و AD_BREAK_ENDED را با فراخوانی
تابع onStreamEvent() مدیریت میکند. این تابع بارگیری جاریسازی، خطاهای جاریسازی، و غیرفعال کردن کنترلهای پخشکننده را درطول بازپخش آگهی مدیریت میکند که IMA SDK به آن نیاز دارد.
وقتی جاریسازی بار میشود، پخشکننده ویدیو نشانی وب ارائهشده را بااستفاده از تابع loadUrl() بار و پخش میکند.
فقط همین! اکنون با «کیت توسعه نرمافزار IMA DAI» آگهی درخواست و نمایش میدهید. برای آشنایی با ویژگیهای پیشرفتهتر کیت توسعه نرمافزار، راهنماهای دیگر یا نمونههای GitHub را ببینید.