درباره API پخش تبلیغات DAI اطلاعات کسب کنید

API پخش تبلیغات پویا (DAI) به شما امکان می‌دهد داده‌های زمان‌بندی و هدف‌گیری تبلیغات پخش‌های زنده آینده خود را ایجاد و مدیریت کنید.

با API مربوط به تبلیغات DAI، می‌توانید موارد زیر را انجام دهید:

• افزایش نرخ پر شدن تبلیغات در زمان اوج ترافیک : به سرویس‌های درج تبلیغات پویا (DAI) زمان بیشتری بدهید تا تبلیغات با بالاترین بازده را برای رویدادهای زنده خود انتخاب کنند. ما API DAI Ad Break را زمانی توصیه می‌کنیم که رویدادهای پخش زنده شما دارای برچسب‌های تبلیغاتی پویا و همزمانی بالا یا تبلیغات با تأخیر بالا هستند.
• کنترل کامل بر روی وقفه‌های تبلیغاتی خود داشته باشید : وقفه‌های تبلیغاتی را از قبل ایجاد، به‌روزرسانی و حذف کنید، که انعطاف‌پذیری بیشتری نسبت به سیگنال‌دهی تبلیغاتی در مانیفست و نرخ پر شدن بالاتری برای ارائه پاد در مقایسه با تصمیم‌گیری در لحظه ارائه می‌دهد.
• ارائه یک تجربه بدون وقفه برای بیننده : با ارائه اطلاعات دقیق وقفه، خطاهای پخش مربوط به تبلیغات مانند پر شدن کم یا زیاد پادهای تبلیغاتی را به حداقل برسانید.

این راهنما روش‌های API مربوط به تبلیغات DAI Ad Break را شرح می‌دهد و شما را در چرخه حیات تبلیغات برای جریان‌های سرویس کامل DAI و سرویس پاد (Pod Serving) راهنمایی می‌کند.

روش‌های API مربوط به تبلیغات DAI را بیاموزید

این API روش‌های استاندارد زیر را برای مدیریت منابع AdBreak ارائه می‌دهد:

• Create : یک موجودیت AdBreak جدید برای یک موجودیت LiveStreamEvent تعریف می‌کند. به صورت اختیاری، می‌توانید ویژگی expectedStartTime را طوری تنظیم کنید که تصمیم به شروع تبلیغ ظرف ۶۰ ثانیه قبل از شروع تبلیغ بگیرد.
• Get : جزئیات یک موجودیت خاص AdBreak ، از جمله وضعیت وقفه تبلیغ و فراداده‌های زمان‌بندی را بازیابی می‌کند.
• List : فهرستی از موجودیت‌های AdBreak که قبلاً با API برای یک موجودیت LiveStreamEvent مشخص ایجاد شده‌اند را برمی‌گرداند، که به ترتیب زمانی معکوس مرتب شده‌اند. توجه داشته باشید که API، وقفه‌های تبلیغاتی را که فقط در مانیفست جریان محتوا تعریف شده‌اند، برنمی‌گرداند.
• Update : قبل از شروع تصمیم‌گیری در مورد تبلیغ، یک موجودیت AdBreak موجود را اصلاح می‌کند.
• Delete : تصمیم تبلیغ را برای یک موجودیت AdBreak که قبلاً ایجاد شده است، لغو می‌کند.

چرخه عمر تبلیغات کوتاه را درک کنید

یک موجودیت AdBreak دارای حالت‌های زیر است:

• BREAK_STATE_UNSPECIFIED : وضعیت پیش‌فرض.
• BREAK_STATE_SCHEDULED : وقفه تبلیغاتی با موفقیت ایجاد و برای تصمیم‌گیری در مورد تبلیغات برنامه‌ریزی شد.
• BREAK_STATE_DECISIONED : سرویس‌های DAI فرآیند انتخاب تبلیغ برای وقفه تبلیغاتی را آغاز کرده‌اند. شما نمی‌توانید وقفه تبلیغاتی را تغییر دهید، اما همچنان می‌توانید وقفه تبلیغاتی را لغو کنید که این امر می‌تواند اثرات نامطلوبی بر سرورهای تبلیغاتی داشته باشد.

احتیاط: لغو پخش تبلیغات در حالت BREAK_STATE_DECISIONED مانع از نمایش تبلیغات توسط سرورهای تبلیغاتی می‌شود که می‌تواند تأثیر منفی بر بودجه‌بندی و قابلیت‌های محدودسازی فرکانس تبلیغات سرور تبلیغاتی داشته باشد.

• BREAK_STATE_COMPLETE : اعلان موقت به کاربران نمایش داده شد.

نمودار زیر جدول زمانی یک موجودیت AdBreak را از زمان ایجاد تا تکمیل نشان می‌دهد.

شما می‌توانید یک موجودیت AdBreak را از ۱ تا ۳۰۰ دقیقه قبل از زمان مورد انتظار برای شروع تبلیغ ایجاد کنید.

• از ایجاد وقفه تبلیغاتی کمتر از یک دقیقه قبل از زمان شروع مورد انتظار وقفه خودداری کنید، زیرا ممکن است Google DAI زمان کافی برای تصمیم‌گیری در مورد تبلیغات نداشته باشد و باعث کاهش نرخ پر شدن تبلیغ شود.
• از ایجاد وقفه تبلیغاتی بیش از ۶ ساعت قبل از زمان شروع مورد انتظار وقفه خودداری کنید، زیرا سرورهای تبلیغاتی ممکن است تبلیغات درخواستی را باطل کنند.

توجه: غیرفعال کردن یک رویداد پخش زنده، وقفه‌های تبلیغاتی را در حالت BREAK_STATE_SCHEDULED یا حالت BREAK_STATE_DECISIONED حذف می‌کند.

بخش‌های زیر، انتقال حالت‌های وقفه تبلیغات در جریان‌های سرویس کامل DAI و سرویس پاد را پوشش می‌دهند.

جریان DAI با سرویس کامل را درک کنید

سرویس کامل گوگل DAI هم مانیفست محتوا و هم پادهای تبلیغاتی را مدیریت می‌کند.

برای هدف‌گیری سفارشی تبلیغات، از API مربوط به DAI Ad Break برای ایجاد یک موجودیت AdBreak قبل از نشانگر تبلیغاتی مربوطه در مانیفست پخش زنده محتوا استفاده کنید.

• این زمان انتظار به سرویس‌های Google DAI اجازه می‌دهد تا از داده‌های AdBreak شما برای تصمیم‌گیری در مورد تبلیغات استفاده کنند.
• وقتی Google DAI نشانگر تبلیغ آشکار را تشخیص می‌دهد، سیستم از تصمیمات تبلیغ با داده‌های موجودیت AdBreak استفاده می‌کند و وضعیت موجودیت را به BREAK_STATE_COMPLETE منتقل می‌کند.

احتیاط: وقتی Google DAI نشانگر تبلیغ آشکار را تشخیص می‌دهد و موجودیت AdBreak دارای وضعیت BREAK_STATE_SCHEDULED است، سیستم از داده‌های AdBreak استفاده نمی‌کند. موجودیت AdBreak تا زمانی که متد delete را برای لغو وقفه تبلیغ فراخوانی نکنید، در وضعیت BREAK_STATE_SCHEDULED باقی می‌ماند.

جریان سرو پاد را درک کنید

در این جریان، شما مانیفست پخش زنده محتوا را مدیریت می‌کنید یا از یک سرویس دستکاری مانیفست شخص ثالث برای شناسایی نشانگرهای تبلیغاتی در مانیفست استفاده می‌کنید.

قبل از زمان شروع مورد انتظار پخش تبلیغات، API مربوط به پخش تبلیغات DAI را فراخوانی کنید تا یک موجودیت AdBreak قبل از زمانی که نیاز به درخواست بخش‌های پاد تبلیغات یا مانیفست تبلیغات دارید، ایجاد شود.

وقتی ابزار اتصال ویدیوی شما، نشانگر تبلیغاتی مانیفست را شناسایی می‌کند و درخواست‌های بخش تبلیغاتی را با شناسه‌ی تبلیغ موقت ارسال می‌کند، Google DAI از داده‌های AdBreak با همان شناسه برای تصمیم‌گیری در مورد تبلیغات استفاده می‌کند.

پس از اینکه مشتری شما درخواست رسانه تبلیغاتی را می‌دهد، موجودیت AdBreak که از طریق API ایجاد کرده‌اید به حالت BREAK_STATE_COMPLETE منتقل می‌شود.

اولین درخواست خود را مطرح کنید

برای تنظیم دسترسی به API و ارسال اولین درخواست خود، به بخش «استفاده از API DAI Ad Break» مراجعه کنید.