اعلان‌های وقفه‌های تبلیغاتی زودهنگام ارسال کنید

Google Dynamic Ad Insertion (DAI) از پخش زنده در سطح همزمانی بالا پشتیبانی می کند. اعلان‌های فرار اولیه تبلیغات (EABN) درخواست‌هایی برای Google DAI برای برنامه‌ریزی یک وقفه تبلیغاتی آینده یا شروع فوری تصمیم‌گیری‌های تبلیغاتی است که هم نرخ پر شدن آگهی و هم زمان بارگذاری را بهینه می‌کند.

برای شروع اعلان‌های زودهنگام وقفه‌های تبلیغاتی برای سرویس کامل ، سرویس پاد ، یا درج آگهی هدایت‌شده توسط سرور ، از منبع AdBreaks استفاده کنید. این منبع می‌تواند برای همه پخش‌های زنده که از طریق رابط کاربری Google Ad Manager یا Google Ad Manager SOAP API LiveStreamEventService ایجاد می‌کنید، وقفه‌های تبلیغاتی ایجاد و مدیریت کند.

این صفحه نحوه برنامه‌ریزی یک وقفه تبلیغاتی را به‌عنوان اعلان زودهنگام وقفه تبلیغاتی پوشش می‌دهد.

پیش نیازها

برای ایجاد یا مدیریت وقفه‌های تبلیغاتی، به یک کلید دارایی تولید شده توسط سیستم پخش زنده یا کلید دارایی سفارشی نیاز دارید. همچنین می‌توانید این کلیدها را در صفحه جزئیات پخش زنده پیدا کنید. به تنظیم یک پخش زنده برای DAI با استفاده از رابط کاربری Google Ad Manager مراجعه کنید.

برای استراحت تبلیغاتی برنامه ریزی کنید

می‌توانید یک وقفه تبلیغاتی را برنامه‌ریزی کنید در حالی که بازدید جریان شما افزایش می‌یابد. برای هر رویداد پخش زنده، با استفاده از روش Create سرویس، یک وقفه تبلیغاتی را به صورت جداگانه تا شش ساعت قبل برنامه ریزی کنید. زمان شروع مورد انتظار و شناسه وقفه آگهی را درج کنید. DAI تصمیمات تبلیغاتی را نزدیک به زمان برنامه ریزی شده شروع می کند. برای تصمیم‌گیری فوری برای وقفه آگهی، زمان مورد انتظار شروع استراحت را حذف کنید.

برای اینکه Google DAI بلافاصله تصمیمات تبلیغاتی را شروع کند، می‌توانید هنگام فراخوانی Create ، زمان شروع مورد انتظار وقفه آگهی را حذف کنید.

مثال زیر یک وقفه تبلیغاتی را برای یک رویداد پخش زنده از نوع Linear زمان‌بندی می‌کند تا در ۶ مارس ۲۰۲۵ ساعت ۴:۰۰ بعد از ظهر در زمان هماهنگ جهانی (UTC) شروع شود:

CURL Node.js

curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN' \
  -H 'content-type: application/json' \
  --data-raw '{"adBreakId":"mid-roll-1","assetKey":"ASSET_KEY","duration":"30s","expectedStartTime":"2025-03-06T16:00:00Z"}'

fetch("https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks", {
    "headers": {
      "authorization":
        "Bearer ACCESS_TOKEN",
        "Content-Type": "application/json",
    },
  "body": JSON.stringify({
    "adBreakId": "mid-roll-1",
    "duration": "30s",
    "expectedStartTime": "2025-03-06T16:00:00Z"
  }),
  "method": "POST"
});

در صورت موفقیت آمیز بودن، پاسخ JSON زیر را مشاهده می کنید:

{
  "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
  "adBreakId": "mid-roll-1",
  "assetKey": "...",
  "expectedStartTime": "2025-03-06T16:00:00Z",
  "duration": "30s",
  "breakState": "SCHEDULED"
}

برای پرس و جو از وقفه های تبلیغاتی، از روش List استفاده کنید. برای بررسی جزئیات یک وقفه تبلیغاتی، از روش Get استفاده کنید.

مثال زیر همه وقفه‌های تبلیغاتی را برای یک رویداد پخش زنده فهرست می‌کند:

CURL Node.js

curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN'

fetch(
  "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks",
  {
    "headers": {
      "authorization": "Bearer ACCESS_TOKEN",
    },
    "method": "GET"
  }
);

در صورت موفقیت آمیز بودن، پاسخ JSON زیر را مشاهده می کنید:

{
  "adBreaks": [
    {
      "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
      "adBreakId": "mid-roll-1",
      "assetKey": "...",
      "expectedStartTime": "2025-03-06T16:00:00Z",
      "duration": "30s",
      "breakState": "DECISIONED",
      "breakSequence": "1"
    }
  ]
}

اگر می‌خواهید وقفه تبلیغاتی فعلی را به زودتر زمان‌بندی کنید، از روش Patch برای تغییر زمان شروع مورد انتظار استفاده کنید. اگر می‌خواهید وقفه تبلیغاتی فعلی را لغو کنید، از روش Delete قبل از COMPLETED وضعیت آن استفاده کنید.

برای ایجاد وقفه تبلیغاتی دیگر، صبر کنید تا وضعیت وقفه تبلیغاتی فعلی COMPLETED شود.