Dynamic Ad Insertion (DAI) Ad Break API به شما امکان میدهد زمانبندی و دادههای هدفیابی آگهی وقفههای آگهی آتی را در جاریسازیهای زنده خود ایجاد و مدیریت کنید.
بااستفاده از DAI Ad Break API، میتوانید کارهای زیر را انجام دهید:
- بهبود نرخ تکمیل آگهی در زمان اوج ترافیک: به سرویسهای DAI زمان بیشتری بدهید تا پردرآمدترین آگهیها را برای رویدادهای زنده شما انتخاب کنند. وقتی رویدادهای جاریسازی زنده شما همزمانی بالا، برچسبهای آگهی پویا، یا آگهیهای با تأخیر بالا دارند، DAI Ad Break API را توصیه میکنیم.
- کنترل کامل وقفههای آگهی خود را بهدست بگیرید: وقفههای آگهی را ازقبل ایجاد، بهروزرسانی، و حذف کنید. این کار انعطافپذیری بیشتری نسبتبه علامتگذاری آگهی در مانیفست ارائه میدهد و نرخ تکمیل بالاتری برای ارائه پاد نسبتبه تصمیمگیری بهموقع فراهم میکند.
- ارائه تجربه بیننده بدون وقفه: با ارائه اطلاعات دقیق درباره وقفه، خطاهای بازپخش مرتبط با آگهی مانند دستههای آگهی کمپر یا بیشپر را به حداقل برسانید.
این راهنما روشهای DAI Ad Break API را شرح میدهد و شما را با چرخه حیات وقفه آگهی برای جریانهای DAI Full Service و Pod Serving آشنا میکند.
آشنایی با روشهای DAI Ad Break API
این API روشهای استاندارد زیر را برای مدیریت منابع AdBreak
ارائه میدهد:
Create: نهادAdBreakجدیدی را برای نهادLiveStreamEventتعریف میکند. درصورت تمایل، ویژگیexpectedStartTimeرا تنظیم کنید تا تصمیمگیری برای آگهی را برای شروع در ۶۰ ثانیه قبلاز شروع وقفه آگهی زمانبندی کند.Get: جزئیات یک نهادAdBreakخاص را بازیابی میکند، ازجمله وضعیت وقفه آگهی و فراداده زمانبندی.List: فهرستی از نهادهایAdBreakرا که قبلاً با میانای برنامهسازی کاربردی برای نهادLiveStreamEventدادهشده ایجاد شدهاند برمیگرداند و آنها را بهترتیب زمانی معکوس مرتب میکند. توجه داشته باشید که API وقفههای آگهی تعریفشده فقط در مانیفست جاریسازی محتوا را برنمیگرداند.Update: نهادAdBreakموجود را قبلاز شروع تصمیمگیری آگهی اصلاح میکند.Delete: تصمیم آگهی را برای نهادAdBreakکه قبلاً ایجاد شده است لغو میکند.
آشنایی با چرخه حیات وقفه آگهی
نهاد AdBreak دارای وضعیتهای زیر است:
BREAK_STATE_UNSPECIFIED: وضعیت پیشفرض.BREAK_STATE_SCHEDULED: وقفه آگهی با موفقیت ایجاد شده و برای تصمیمگیری درباره آگهی زمانبندی شده است.-
BREAK_STATE_DECISIONED: سرویسهای DAI فرایند انتخاب آگهی را برای وقفه آگهی شروع کردهاند. نمیتوانید وقفه آگهی را اصلاح کنید اما همچنان میتوانید وقفه آگهی را با اثرات نامطلوب احتمالی بر سرورهای آگهی لغو کنید.
-
BREAK_STATE_COMPLETE: وقفه آگهی به کاربران ارائه شده است. -
BREAK_STATE_EXPIRED: وقفه آگهی پیشاز ارائه منقضی شد. فقط زمانی قابلاجرا است که زمانبندی چندوقفهای را در رویداد جاریسازی زنده فعال کنید. برای جزئیات، تنظیمات وقفه آگهی میانویدیویی را ببینید. بهطور پیشفرض، وقفههای آگهی ۳۰ دقیقه پساز مقدار فیلدexpectedStartTimeیا ۳۰ دقیقه پساز شروع تصمیمگیری (اگر فیلدexpectedStartTimeرا تنظیم نکنید) منقضی میشوند. میتوانید این مدت را بااستفاده از فیلدexpireDurationسفارشیسازی کنید.
نمودار زیر خط زمان نهاد AdBreak را از زمان ایجاد تا تکمیل نشان میدهد.

میتوانید از ۱ تا ۳۰۰ دقیقه قبلاز شروع موردانتظار وقفه آگهی، یک موجودیت AdBreak ایجاد کنید.
- از ایجاد وقفه آگهی کمتر از یک دقیقه قبلاز زمان شروع موردانتظار وقفه خودداری کنید، زیرا ممکن است Google DAI زمان کافی برای تصمیمگیری درباره آگهی نداشته باشد و این امر باعث کاهش نرخ تکمیل آگهی شود.
- از ایجاد وقفه آگهی بیشاز ۶ ساعت قبلاز زمان شروع موردانتظار وقفه خودداری کنید، زیرا سرورهای آگهی ممکن است آگهیهای درخواستشده را نامعتبر کنند.
بخشهای زیر انتقالهای حالت وقفه آگهی را در جریانهای «سرویس کامل» DAI و «ارائه پاد» پوشش میدهند.
آشنایی با جریان درج آگهی پویا با خدمات کامل
«درج آگهی پویا با خدمات کامل Google» هم مانیفست محتوا و هم غلافهای آگهی را مدیریت میکند.
برای هدفیابی آگهی سفارشی، از DAI Ad Break API برای ایجاد یک نهاد AdBreak
پیشاز نشانگر آگهی مربوطه در مانیفست جاریسازی زنده محتوا استفاده کنید.
- این زمان انجام درخواست به سرویسهای Google DAI اجازه میدهد از دادههای
AdBreakشما برای تصمیمگیری درباره آگهی استفاده کنند. - وقتی Google DAI نشانگر آگهی مانیفست را شناسایی میکند، سیستم از تصمیمات آگهی با دادههای موجودیت
AdBreakاستفاده میکند و وضعیت موجودیت را بهBREAK_STATE_COMPLETEتغییر میدهد.
وقتی زمانبندی چندوقفهای را در رویداد جاریسازی زنده فعال میکنید، میتوانید فیلد matchParams را در نهاد AdBreak تنظیم کنید. این فرایند به Google DAI اجازه میدهد نشانگرهای آگهی مانیفست شناساییشده را با وقفههای آگهی در وضعیت BREAK_STATE_SCHEDULED یا BREAK_STATE_DECISIONED مطابقت دهد.

آشنایی با جریان ارائه Pod
در این جریان، مانیفست جاریسازی زنده محتوا را مدیریت میکنید یا از سرویس دستکاری مانیفست شخص ثالث برای شناسایی نشانگرهای آگهی در مانیفست استفاده میکنید.
قبلاز زمان شروع موردانتظار وقفه آگهی، با «میانای برنامهسازی کاربردی» «وقفه آگهی درج آگهی پویا» تماس بگیرید تا پیشاز زمانی که باید بخشهای دسته آگهی یا مانیفست آگهی را درخواست کنید، موجودیت AdBreak را ایجاد کنید.
وقتی ادغامکننده ویدیو شما نشانگر آگهی مانیفست را شناسایی میکند و درخواستهای بخش آگهی را با شناسه وقفه آگهی ایجاد میکند، Google DAI از دادههای AdBreak با همان شناسه برای تصمیمگیریهای آگهی استفاده میکند.
پساز اینکه مشتریتان درخواست رسانه آگهی کرد، نهاد AdBreak که ازطریق
میانای برنامهسازی کاربردی ایجاد کردهاید به وضعیت BREAK_STATE_COMPLETE منتقل میشود.

اولین درخواستتان را ارسال کنید
برای راهاندازی دسترسی به میانای برنامهسازی کاربردی و ارسال اولین درخواست، استفاده از میانای برنامهسازی کاربردی وقفه آگهی DAI را ببینید.