کیت توسعه نرم‌افزار IMA DAI از ادغام در یک برنامه پخش ویدیوی مینیمال HbbTV پشتیبانی می‌کند. کیت توسعه نرم‌افزار IMA DAI به Google Ad Manager این امکان را می‌دهد که برای یک جریان تبلیغاتی پهن‌باند، یک جریان محتوای پخش را همراهی کند. این راهنما ، بارگذاری یک مانیفست تبلیغاتی را بر اساس داده‌های رویداد تبلیغاتی از جریان پخش پوشش می‌دهد.
برای مشاهده یا دنبال کردن نمونه‌ی تکمیل‌شده‌ی یکپارچه‌سازی، برنامه‌ی نمونه‌ی خطی HbbTV را با IMA HTML5 DAI SDK دانلود کنید. برای پشتیبانی از دستگاه‌های تلویزیون قدیمی‌تر، این راهنما و برنامه‌ی نمونه‌ی GitHub با جاوااسکریپت ES5 هستند.
برای اطلاعات بیشتر در مورد ادغام با سایر پلتفرم‌های غیر HbbTV، به بخش SDKهای تبلیغات رسانه‌ای تعاملی مراجعه کنید.
پیش‌نیازها
قبل از ادامه این راهنما، مطمئن شوید که موارد زیر را دارید:
- برای استفاده از IMA DAI، باید یک حساب Ad Manager 360 Advanced داشته باشید. اگر حساب Ad Manager دارید، برای اطلاعات بیشتر با مدیر حساب خود تماس بگیرید. برای کسب اطلاعات در مورد ثبت نام در Ad Manager، به مرکز راهنمایی Ad Manager مراجعه کنید.
- یک برنامه HbbTV که برای پخش رسانه با شیء پخش در تعامل است. برای جزئیات بیشتر، به شیء پخش AV در HbbTV مراجعه کنید.
- نسخه‌ای از dash.js که از پیش‌بارگذاری پشتیبانی می‌کند. توصیه می‌کنیم از نسخه ۴.۶.۰ یا بالاتر استفاده کنید.
- یک وب سرور برای میزبانی برنامه.
- یک محیط آزمایشی با جریان پخش DVB. برای دستورالعمل‌های دقیق در مورد تنظیم محیط آزمایشی خود، به اجرای برنامه HbbTV مراجعه کنید.
- پخش جریانی : یک پخش جریانی حاوی داده‌های سفارشی جدول اطلاعات برنامه (AIT) تهیه کنید. همچنین به روشی برای انتقال پخش جریانی برای دریافت توسط تلویزیون نیاز دارید. می‌توانید از یک مدولاتور DVB یا روش‌های دیگر برای انتقال پخش جریانی استفاده کنید.
- وب سرور : برنامه HbbTV را روی یک وب سرور که از طریق تلویزیون قابل دسترسی است، میزبانی کنید.
- یک رویداد پخش زنده با نوع Pod که در مانیفست ارائه می‌شود . برای ایجاد رویداد، به بخش «تنظیم پخش زنده برای DAI» مراجعه کنید.
یک جریان پخش سازگار ایجاد کنید
برنامه HbbTV شما از broadcastContainer.addStreamEventListener() برای گوش دادن به رویدادهای پخش HbbTV در جریان پخش شما استفاده می‌کند. برای بارگیری و پخش صحیح تبلیغات، باید جریان پخش خود را با انواع رویدادهای زیر تنظیم کنید تا شامل رشته JSON مرتبط باشد:
-
AD_BREAK_EVENT_ANNOUNCE-{"type":"adBreakAnnounce", "pod_id":1,"duration":90, "offset":10} -
AD_BREAK_EVENT_START-{"type":"adBreakStart"} -
AD_BREAK_EVENT_END-{"type":"adBreakEnd"}
برای این رویدادها، یک رشته JSON با streamEvent.type اضافه کنید. برای پشتیبانی از پیش‌بارگذاری تبلیغات، رویداد AD_BREAK_EVENT_ANNOUNCE باید شامل streamEvent.duration و streamEvent.offset باشد. برای اطلاعات بیشتر، به Listen to HbbTV stream events مراجعه کنید. برای تنظیم جریان پخش خود، به مثال جریان انتقال MPEG مالتی‌پلکس شده مراجعه کنید. برای استفاده از جریان نمونه، باید URL جدول اطلاعات برنامه را برای تنظیم جریان خود به‌روزرسانی کنید.
یک رویداد پخش زنده پاد ایجاد کنید
برای نمایش تبلیغات در برنامه HbbTV خود، به یک رویداد پخش زنده که قابلیت پخش پاد داشته باشد نیاز دارید. برای اطلاعات بیشتر در مورد تنظیم رویداد، به بخش «تنظیم پخش زنده برای DAI» مراجعه کنید. برای دسترسی به پخش زنده‌ای که تنظیم کرده‌اید، برنامه باید متغیرهای زیر را داشته باشد:
-
NETWORK_CODE: کد شبکه Ad Manager برای درخواست تبلیغات. -
CUSTOM_ASSET_KEY: کلید دارایی سفارشی Ad Manager که در طول فرآیند تنظیم پخش زنده برای DAI ایجاد شده است.
ساختار فایل برنامه را ایجاد کنید
این راهنما از ساختار فایلی مشابه برنامه نمونه IMA HbbTV استفاده می‌کند. برای دنبال کردن این راهنما، فایل‌های زیر را ایجاد کنید:
-
index.html: ایندکس HTML برای برنامه شما. -
Style.css: استایل‌دهی CSS برای برنامه شما. -
application.js: نقطه ورود اصلی JS. حالت بازی و وقفه‌های تبلیغاتی را مدیریت می‌کند. -
video_player.js: پخش‌کننده‌ی dash.js مورد استفاده برای پخش تبلیغات را مدیریت می‌کند. -
ads_manager.js: تنظیمات IMA، درخواست پخش جریان و مدیریت رویدادها را مدیریت می‌کند.
ads_manager.js کیت توسعه نرم‌افزار IMA DAI را راه‌اندازی می‌کند. کامپوننت‌های زیر کیت توسعه نرم‌افزار IMA DAI را پیاده‌سازی می‌کنند:
-
PodStreamRequest: شیء‌ای که درخواست پخش زنده به سرورهای تبلیغاتی گوگل را تعریف می‌کند. -
StreamManager: شیء‌ای که جریان‌های درج تبلیغات پویا و تعاملات با بک‌اند DAI را مدیریت می‌کند. مدیر جریان همچنین پینگ‌های ردیابی را مدیریت کرده و رویدادهای جریان و تبلیغات را به ناشر ارسال می‌کند.
برای دستورالعمل‌های دقیق در مورد راه‌اندازی محیط آزمایش خود، به این راهنما در مورد اجرای برنامه HbbTV مراجعه کنید.
بارگیری IMA DAI SDK و DASH.js
برای شروع پخش جریان تبلیغات پخش شده، IMA DAI SDK و dash.js را در برنامه خود بارگذاری کنید. قبل از تگ application.js ، dash.js و چارچوب IMA را با استفاده از تگ‌های اسکریپت در index.html اضافه کنید.
در مرحله بعد، یک کلاس wrapper برای پخش کننده ویدیو ایجاد کنید تا پخش کننده dash.js را آغاز و کنترل کند.