درباره «میانای برنامه‌سازی کاربردی وقفه آگهی DAI» بیشتر بدانید

‫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 مطابقت دهد.

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

آشنایی با جریان ارائه Pod

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

قبل‌از زمان شروع موردانتظار وقفه آگهی، با «میانای برنامه‌سازی کاربردی» «وقفه آگهی درج آگهی پویا» تماس بگیرید تا پیش‌از زمانی که باید بخش‌های دسته آگهی یا مانیفست آگهی را درخواست کنید، موجودیت AdBreak را ایجاد کنید.

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

پس‌از اینکه مشتری‌تان درخواست رسانه آگهی کرد، نهاد AdBreak که ازطریق میانای برنامه‌سازی کاربردی ایجاد کرده‌اید به وضعیت BREAK_STATE_COMPLETE منتقل می‌شود.

وضعیت کامل موجودیت وقفه آگهی.

اولین درخواستتان را ارسال کنید

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