با IMA SDK در HbbTV شروع کنید

IMA DAI SDK از ادغام با یک برنامه پخش کننده ویدیوی HbbTV حداقل پشتیبانی می کند. IMA DAI SDK تقاضای Google Ad Manager را برای جریان تبلیغات پهن باند برای همراهی با جریان محتوای پخشی را قادر می‌سازد. این راهنما بارگیری مانیفست آگهی را بر اساس داده‌های رویداد آگهی از جریان پخش پوشش می‌دهد.

برای مشاهده یا دنبال کردن یک نمونه کامل یکپارچه، برنامه نمونه خطی HbbTV را با IMA HTML5 DAI SDK دانلود کنید. برای پشتیبانی از دستگاه های تلویزیون قدیمی، این راهنما و برنامه نمونه GitHub در جاوا اسکریپت ES5 هستند.

برای کسب اطلاعات در مورد ادغام با سایر پلتفرم‌های غیر HbbTV، به کیت توسعه نرم‌افزار تبلیغات رسانه‌ای تعاملی مراجعه کنید.

پیش نیازها

قبل از ادامه این راهنما، مطمئن شوید که موارد زیر را دارید:

  • برای استفاده از IMA DAI، باید یک حساب Ad Manager 360 Advanced داشته باشید. اگر حساب Ad Manager دارید، برای جزئیات بیشتر با مدیر حساب خود تماس بگیرید. برای کسب اطلاعات در مورد ثبت نام در Ad Manager، از مرکز راهنمای Ad Manager دیدن کنید.
  • یک برنامه HbbTV که با شی پخش شده برای پخش رسانه تعامل دارد. برای جزئیات بیشتر، HbbTV Broadcast AV را ببینید.
  • نسخه dash.js که از پیش بارگیری پشتیبانی می کند. توصیه می کنیم از نسخه 4.6.0 یا بالاتر استفاده کنید.
  • یک وب سرور برای میزبانی برنامه.
  • یک محیط آزمایشی با جریان پخش 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 باشد. برای اطلاعات بیشتر، گوش دادن به رویدادهای جریان HbbTV را ببینید. برای تنظیم جریان پخش خود، به مثال جریان انتقال 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. playstate و وقفه های تبلیغاتی را مدیریت می کند.
  • video_player.js : پخش کننده dash.js مورد استفاده برای پخش آگهی را مدیریت می کند.
  • ads_manager.js : تنظیم IMA، درخواست جریان و مدیریت رویداد را مدیریت می کند.

ads_manager.js IMA DAI SDK را راه اندازی می کند. اجزای زیر IMA DAI SDK را پیاده سازی می کنند:

  • PodStreamRequest : یک شی که یک درخواست جریان را به سرورهای تبلیغاتی Google تعریف می کند.
  • StreamManager : شیئی که جریانهای درج آگهی پویا و تعاملات با باطن DAI را مدیریت می کند. مدیر جریان همچنین پینگ‌های ردیابی را مدیریت می‌کند و جریان‌ها و رویدادهای تبلیغاتی را به ناشر ارسال می‌کند.

برای دستورالعمل‌های دقیق در مورد راه‌اندازی محیط آزمایش، به این راهنمای اجرای برنامه HbbTV مراجعه کنید.

IMA DAI SDK و DASH.js را بارگیری کنید

برای شروع پخش پخش جریانی تبلیغات، IMA DAI SDK و dash.js را در برنامه خود بارگیری کنید. قبل از تگ application.js ، dash.js و چارچوب IMA را با استفاده از تگ های اسکریپت در index.html اضافه کنید.

<script src="https://cdn.jsdelivr.net/npm/dashjs@latest/dist/dash.all.min.js"></script>
<script src="//imasdk.googleapis.com/js/sdkloader/ima3_dai.js"></script>
index.html

در مرحله بعد، یک کلاس بسته بندی پخش کننده ویدیو برای راه اندازی و کنترل پخش کننده dash.js ایجاد کنید.

بعدی
کلاس پخش را تنظیم کنید