تتيح لك واجهة برمجة التطبيقات الخاصة بالفواصل الإعلانية في ميزة "إدراج الإعلان الديناميكي" (DAI) إنشاء وإدارة بيانات توقيت الفواصل الإعلانية القادمة واستهداف الإعلانات في أحداث البث المباشر.
باستخدام واجهة برمجة التطبيقات DAI Ad Break API، يمكنك إجراء ما يلي:
- تحسين معدّل الإعلانات المنشورة خلال أوقات الذروة: يمكنك منح خدمات "إدراج الإعلان الديناميكي" مزيدًا من الوقت لاختيار الإعلانات التي تحقّق أعلى عائد لأحداثك المباشرة. ننصح باستخدام واجهة DAI Ad Break API عندما تتضمّن أحداث البث المباشر عددًا كبيرًا من المشاهدين المتزامنين أو علامات إعلانات ديناميكية أو إعلانات ذات وقت استجابة طويل.
- التحكّم الكامل في الفواصل الإعلانية: يمكنك إنشاء الفواصل الإعلانية وتعديلها وحذفها مسبقًا، ما يمنحك مرونة أكبر مقارنةً بإشارات الإعلانات في البيان، ومعدّل تعبئة أعلى لعرض مجموعات الإعلانات مقارنةً باتّخاذ القرارات في الوقت الفعلي.
- تقديم تجربة مشاهدة بلا انقطاع: يمكنك الحدّ من أخطاء التشغيل المرتبطة بالإعلانات، مثل مجموعات الإعلانات المتسلسلة غير المكتملة أو الزائدة، من خلال تقديم معلومات دقيقة عن الفواصل الإعلانية.
يصف هذا الدليل طرق واجهة برمجة التطبيقات الخاصة بالفاصل الإعلاني في ميزة "إدراج الإعلان ديناميكيًا"، ويشرح دورة حياة الفاصل الإعلاني في مسارات "الخدمة الكاملة" و"عرض مجموعة الإعلانات" في ميزة "إدراج الإعلان ديناميكيًا".
التعرّف على طرق واجهة برمجة التطبيقات الخاصة بالفواصل الإعلانية في ميزة "إدراج الإعلان الديناميكي"
تعرض واجهة برمجة التطبيقات الطرق العادية التالية لإدارة موارد AdBreak:
-
Create: يحدّد كيانAdBreakجديدًا لكيانLiveStreamEvent. يمكنك اختياريًا ضبط السمةexpectedStartTimeلجدولة قرار عرض الإعلان ليبدأ خلال 60 ثانية قبل بدء الفاصل الإعلاني. -
Get: تتيح هذه الطريقة استرداد تفاصيل كيانAdBreakمعيّن، بما في ذلك حالة الفاصل الإعلاني والبيانات الوصفية للتوقيت. List: تعرض هذه الطريقة قائمة بكياناتAdBreakالتي تم إنشاؤها سابقًا باستخدام واجهة برمجة التطبيقات لكيانLiveStreamEventمعيّن، ويتم ترتيبها ترتيبًا زمنيًا عكسيًا. يُرجى العِلم أنّ واجهة برمجة التطبيقات لا تعرض الفواصل الإعلانية المحدّدة في بيان بث المحتوى فقط.Update: لتعديل كيانAdBreakحالي قبل بدء عملية اتخاذ القرار بشأن الإعلانDelete: تلغي قرار الإعلان لكيانAdBreakتم إنشاؤه سابقًا.
فهم دورة حياة الفواصل الإعلانية
تتضمّن كيانات AdBreak الحالات التالية:
-
BREAK_STATE_UNSPECIFIED: الحالة التلقائية -
BREAK_STATE_SCHEDULED: تم إنشاء الفاصل الإعلاني بنجاح وجدولته لاتخاذ قرار بشأن الإعلان. -
BREAK_STATE_DECISIONED: بدأت خدمات "إدراج الإعلان الديناميكي" عملية اختيار الإعلان للفاصل الإعلاني. لا يمكنك تعديل الفاصل الإعلاني، ولكن لا يزال بإمكانك إلغاؤه، ما قد يؤدي إلى آثار سلبية على خوادم الإعلانات.
-
BREAK_STATE_COMPLETE: تم عرض الفاصل الإعلاني للمستخدمين. -
BREAK_STATE_EXPIRED: انتهت صلاحية الفاصل الإعلاني قبل عرضه. لا ينطبق ذلك إلا عند تفعيل جدولة الفواصل الإعلانية المتعددة في حدث البث المباشر. لمزيد من التفاصيل، يُرجى الاطّلاع على إعدادات الفواصل الإعلانية أثناء التشغيل. تنتهي صلاحية الفواصل الإعلانية تلقائيًا بعد 30 دقيقة من قيمة الحقلexpectedStartTime، أو بعد 30 دقيقة من بدء اتخاذ القرار إذا لم يتم ضبط الحقلexpectedStartTime. يمكنك تخصيص هذه المدة باستخدام الحقلexpireDuration.
يوضّح المخطّط البياني التالي المخطط الزمني لكيان AdBreak، من الإنشاء
إلى الاكتمال.

يمكنك إنشاء كيان AdBreak قبل دقيقة واحدة إلى 300 دقيقة من الوقت المتوقّع لبدء الفاصل الإعلاني.
- تجنَّب إنشاء فاصل إعلاني قبل أقل من دقيقة من وقت البدء المتوقّع للفاصل، لأنّ ميزة "إدراج الإعلان الديناميكي" من Google قد لا يكون لديها وقت كافٍ لاتخاذ قرارات بشأن الإعلانات، ما يؤدي إلى انخفاض معدّل الإعلانات المنشورة.
- تجنَّب إنشاء فاصل إعلاني قبل أكثر من 6 ساعات من وقت البدء المتوقّع للفاصل، لأنّ خوادم الإعلانات قد تبطل الإعلانات المطلوبة.
تتناول الأقسام التالية عمليات انتقال حالة الفاصل الإعلاني في مسارات "الخدمة الكاملة" و"عرض المجموعة" في ميزة "إدراج الإعلان ديناميكيًا".
فهم آلية عمل "إدراج الإعلان الديناميكي" (DAI) الكاملة
تتولى خدمة "إدراج الإعلان الديناميكي" الكاملة من Google إدارة كل من بيان المحتوى ومجموعات الإعلانات المتسلسلة.
لاستهداف الإعلانات المخصّصة، استخدِم واجهة برمجة التطبيقات DAI Ad Break API لإنشاء كيان AdBreak قبل علامة الفاصل الإعلاني المقابلة في بيان البث المباشر للمحتوى.
- يتيح وقت التنفيذ هذا لخدمات إدراج الإعلان الديناميكي من Google استخدام بيانات
AdBreakلاتّخاذ قرار بشأن الإعلان. - عندما ترصد ميزة "إدراج الإعلان الديناميكي" من Google علامة الإعلان في البيان، يستخدم النظام قرارات الإعلانات مع بيانات الكيان
AdBreakوينقل حالة الكيان إلىBREAK_STATE_COMPLETE.
عند تفعيل ميزة جدولة الفواصل الإعلانية المتعدّدة في حدث البث المباشر، يمكنك ضبط حقل matchParams في كيان AdBreak. تتيح هذه العملية لميزة "إدراج الإعلان الديناميكي" من Google مطابقة علامات الإعلانات التي تم رصدها في البيان مع الفواصل الإعلانية في الحالة BREAK_STATE_SCHEDULED أو BREAK_STATE_DECISIONED.

فهم آلية عرض الإعلانات في مجموعات
في هذا المسار، يمكنك إدارة ملف بيان البث المباشر للمحتوى أو استخدام خدمة مُعدِّل ملفات بيان تابعة لجهة خارجية من أجل رصد علامات الإعلانات في ملف البيان.
يجب استدعاء واجهة برمجة التطبيقات DAI Ad Break API قبل وقت البدء المتوقّع للفاصل الإعلاني من أجل إنشاء كيان
AdBreak قبل أن تحتاج إلى طلب شرائح مجموعة الإعلانات المتسلسلة أو بيان
الإعلان.
عندما يرصد برنامج دمج الفيديوهات علامة الإعلان في البيان ويقدّم طلبات لشرائح الإعلانات باستخدام معرّف فاصل إعلاني، تستخدم ميزة "إدراج الإعلان الديناميكي" من Google بيانات AdBreak التي تحمل المعرّف نفسه لاتّخاذ القرارات المتعلقة بالإعلانات.
بعد أن يطلب عميلك وسائط إعلانية، تنتقل الكيان AdBreak الذي أنشأته من خلال واجهة برمجة التطبيقات إلى الحالة BREAK_STATE_COMPLETE.

تقديم طلبك الأول
لإعداد إمكانية الوصول إلى واجهة برمجة التطبيقات وتقديم طلبك الأول، يُرجى الاطّلاع على استخدام واجهة DAI Ad Break API.