إرسال إشعارات مبكّرة بالفواصل الإعلانية

تتيح ميزة "إدراج إعلان ديناميكي" من Google إمكانية البث المباشر بمستوى إشغال مرتفع. إشعارات الفواصل الإعلانية المبكرة (EABN) هي طلبات موجَّهة إلى "نظام إدارة الإعلانات الذكية من Google" لتحديد موعد فاصل إعلاني قادم أو بدء قرارات الإعلانات على الفور، ما يؤدي إلى تحسين كل من معدّل ملء الإعلانات ووقت التحميل.

لبدء إرسال إشعارات الفواصل الإعلانية المبكرة في الخدمة الكاملة أو عرض مجموعات الإعلانات المتسلسلة أو إدراج الإعلانات بتوجيه من الخادم، استخدِم المرجع AdBreaks. يمكن أن ينشئ هذا المرجع الفواصل الإعلانية ويُديرها لجميع أحداث البث المباشر التي تنشئها من خلال واجهة مستخدم "مدير إعلانات Google" أو واجهة برمجة التطبيقات SOAP LiveStreamEventService في "مدير إعلانات Google".

تتناول هذه الصفحة كيفية جدولة فاصل إعلاني كإشعار مبكر عن الفاصل الإعلاني.

المتطلبات الأساسية

لإنشاء الفواصل الإعلانية أو إدارتها، تحتاج إلى مفتاح مادة عرض أو مفتاح مادة عرض مخصّص تم إنشاؤه من خلال نظام البث المباشر. يمكنك أيضًا العثور على هذه المفاتيح في صفحة تفاصيل البث المباشر. اطّلِع على مقالة إعداد مجرى بث مباشر لعرض الإعلانات أثناء التشغيل باستخدام واجهة مستخدم "مدير إعلانات Google".

جدولة فاصل إعلاني

يمكنك جدولة فاصل إعلاني عندما يزداد عدد مشاهدي البث. لكل حدث بث مباشر، يمكنك جدولة فاصل إعلاني واحد بشكل فردي قبل بدء البث بمدة تصل إلى ست ساعات باستخدام Create طريقة الخدمة. أدرِج وقت البدء المتوقّع ورقم تعريف الفاصل الإعلاني. تبدأ ميزة "عرض الإعلانات أثناء التشغيل" في اتخاذ قرارات بشأن الإعلانات بالقرب من الوقت المحدّد. بالنسبة إلى القرارات الفورية بشأن الفواصل الإعلانية، احذف وقت بدء الفاصل الإعلاني المتوقّع.

لجعل ميزة "الإعلانات أثناء عرض الفيديو" من Google تبدأ اتّخاذ قرارات بشأن الإعلانات على الفور، يمكنك حذف وقت البدء المتوقع للفاصل الإعلاني عند طلب Create.

في المثال التالي، يتم تحديد موعد لفاصل إعلاني لحدث بث مباشر من النوع Linear ليبدأ في 6 آذار (مارس) 2025 في الساعة 4:00 بعد الظهر بالتوقيت العالمي المنسق (UTC):

cURL 

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"}'

Node.js 

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 

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

Node.js 

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.